# yanzhenjie/Sofia

Android沉浸式效果的实现，状态栏和导航栏均支持设置颜色、渐变色、图片、透明度、内容入侵和状态栏深色字体；兼容竖屏、横屏，当屏幕旋转时会自动适配。

Repository: https://github.com/yanzhenjie/Sofia
Canonical: https://ross.abutalabs.com/products/sofia
Homepage: https://github.com/yanzhenjie/Sofia
Language: Java
License: Apache-2.0
License Family: permissive
Topics: immersion, invasion, statusbar, navagational
Last push: 2018-04-25T10:36:42+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3318, "days_push": 3052, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1228, forks 163 (observed 2026-08-28T04:04:03.459978+00:00)

## What it is
Sofia is an Android library for implementing immersive status bar and navigation bar effects. It supports setting colors, gradients, images, transparency, content invasion, and dark status bar fonts, with automatic adaptation on screen rotation.

## Use cases
- make the android status bar transparent or colored
- draw content behind the status bar in a detail page
- change status bar color as the user scrolls
- set dark status bar font icons on a light background
- style the navigation bar with an image or gradient
- handle system bars across portrait and landscape rotation

## When to choose
- you need fine-grained control over Android status bar and navigation bar appearance
- you want content to draw behind system bars with view fitting helpers
- you need rotation-aware immersive bar handling in a Java Android app

## When to avoid
- you are building with Jetpack Compose and can use its native system bar APIs
- you need a library with recent updates and active maintenance
- you target only the latest Android versions where system bar APIs are simpler

## Facets
- artifact type: library
- maturity: maintenance
- function: ui-components, mobile-framework
- domain: mobile-development, android-tools, web-design
- platform: jvm
- tags: status-bar, navigation-bar, immersive-mode, android-ui, system-bars, android, mobile

## Member repositories
- yanzhenjie/Sofia (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:03.459978+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:15:13.396359+00:00, confidence not recorded.
  - readme: https://github.com/yanzhenjie/Sofia (fetched 2026-08-28T04:04:03.459978+00:00, sha c921434e2992)
  - homepage: https://github.com/yanzhenjie/Sofia (fetched 2026-08-29T12:22:48.301652+00:00, sha 81b96aaf0841)
- Data as of 2026-08-30T08:39:29.467469+00:00.