StatusBarCompat

简介

StatusBarCompat是一个用于设置系统状态栏颜色的兼容库，兼容Android 4.4.2(API 19)以上，使用简单，仅需要一行代码的调用。

效果展示

使用方式

声明仓库

确保在你的根项目的build.gradle中对jcenter的声明：

allprojects {
    repositories {
        jcenter()
    }
}

声明依赖

在你要使用的module的build.gradle文件中声明以下依赖：

    compile 'com.githang:status-bar-compat:0.7'

代码调用

最后在你的Activity的setContentView()方法调用之后，调用以下方法即可。

    StatusBarCompat.setStatusBarColor(this, color, lightStatusBar);

或者是

    StatusBarCompat.setStatusBarColor(this, color);

API文档

API文档参见：https://msdx.github.io/status-bar-compat/

适配支持情况

第三方ROM适配支持

设置失败的机型

深色状态栏图标设置支持

• Android 6.0及以上
• Flyme
• MIUI

6.0以下的其他机型因未提供相关API可以把状态栏图标设置为黑色，所以无法支持。请不要再提不在上述范围的手机无法设置深色图标的issue了。

已知的设置状态栏为白色后看不清时间的机型

把状态栏设置为白色或接近白色的颜色可能导致部分机型看不清状态栏的图标与文字，原因是这些机型把设置状态栏半透明改成了全透明，而Android 6.0以下没有官方的API可以把状态栏的图标及字体设置为深色，需要定制的ROM自己提供API支持。因此，不建议把状态栏设置为白色或接近白色的颜色。

目前已知的提供了支持的ROM有MIUI以及Flyme。以下是已知的不支持的机型列表：

以上具体机型测试结果根据在Testin上随机兼容性测试所得，测试报告地址：http://realauto.testin.cn/s/1amaujufn

已知问题

• 由于低于6.0以下的系统使用透明状态栏并设置fitsSystemWindows来实现设置状态栏颜色，在一些底部虚拟导航栏给隐藏的机型上，可能会出现界面无法显示在该区域中。如果遇到此问题，你需要把你的App theme指定为AppCompat里的一种。
• 可能会出现状态栏与标题栏之间有一个与状态栏同样大小的间距,如果出现请调用以下代码：

StatusBarCompat.resetActionBarContainerTopMargin(getWindow(), android.support.v7.appcompat.R.id.action_bar_container);

参考资料：

• SystemBarTint
• 《Android Lollipop Set Status Bar Text Color》
• 《由沉浸式状态栏引发的血案》
• 《android状态栏一体化(改变状态栏的背景颜色)》
• 《Remove action bar shadow programmatically》
• 《Android-->沉浸式状态栏字体颜色的修改(只针对小米和魅族)》
• 《[Android]判断是否是华为EMUI系统》