产品简介
StatusNavigationTransparent 一个Android屏幕适配工具库,专注于状态栏与导航栏的透明化处理,支持设置半透明、全透明、全屏及沉浸式显示,并能根据系统版本(Android 6.0以上)智能调整状态栏文字和图标颜色。适合需要精细美化应用界面的Android开发者。

核心功能
- 状态栏自定义颜色,智能适配文字/图标颜色
- 状态栏半透明、全透明覆盖于图片之上
- 导航栏自定义颜色或全透明
- 一键隐藏状态栏/导航栏,进入全屏模式
- 提供独立工具类和视图组件,使用灵活
快速开始
- 在项目根目录build.gradle中添加JitPack maven仓库。
- 在应用模块的build.gradle中添加StatusNavigationTransparent依赖。
- 创建应用主题并继承自Theme.AppCompat.Light.NoActionBar。
- 让Activity继承StatusNavigationActivity,或直接调用StatusNavigationUtils工具类设置效果。
界面预览


与其他方案对比
| 对比项 | StatusNavigationTransparent | 同类方案 |
|---|---|---|
| 系统兼容性 | 提供统一API适配Android 6.0以上状态栏文字/图标颜色,简化适配逻辑。 | 开发者通常需要自行判断系统版本并编写大量适配代码。 |
| 使用灵活性 | 同时提供Activity基类、独立工具类、View组件三种使用方式,灵活度高。 | 许多方案仅提供单一的集成方式(如必须继承基类),侵入性较强。 |
| 功能全面性 | 覆盖半透明、全透明、隐藏、全屏等几乎所有常见状态栏导航栏场景。 | 同类库功能可能比较单一,例如仅支持设置颜色或仅支持全屏。 |
适合谁用
- 需要为Android应用进行状态栏和导航栏美化的开发者。
- 开发图片浏览、视频播放等需要全屏沉浸式体验的App的开发者。
- 希望统一处理不同Android版本状态栏适配问题的工程师。
下载与版本
当前最新版本为 V1.4.6,发布于 2026-06-11。支持 Windows、macOS、Linux。
⚠️ 注意:本项目仅提供源代码下载,不包含可直接运行的安装包(exe/dmg/apk 等。下载后需要自行编译构建才能使用,适合有一定开发经验的用户。如果你不熟悉编译流程,建议寻找同类开箱即用的替代方案。
注意事项
- 本工具仅供学习和研究使用,请遵守相关法律法规。
- 请尊重内容创作者版权,勿将下载内容用于商业或非法传播。
- 项目源码地址:https://github.com/AnJiaoDe/StatusNavigationTransparent