Implementing immersive status bar through theme
很早的时候，通过主题设置activity沉浸式，发现坑很多，就开始使用各种StatusBarUtils，放弃了主题修改沉浸式这种方式，不知道大家有没有同感。
其实各种StatusBarUtils的做法其实也是通过判断系统版本然后设置主题属性，是一种比直接设置Theme滞后的一种方式。这里讲一种通用的主题加一点好理解的代码实现沉浸式主题，方便更好的理解沉浸式，而且很简单。
先来看下效果：
| 系统版本 | 4.4 | 9.0 |
|---|---|---|
| 纯色 |  |
 |
| 渐变色 |  |
 |
| 图片 |  |
 |
| Fragment |  |
 |
接下来，先来熟悉一下有那些沉浸式主题的属性设置：
<item name="android:windowTranslucentStatus">true</item>这个属性可以使状态栏变透明，同时内容区域可以浸入状态栏下面，从android 4.4增加的新属性，开启了沉浸式主题的大门，所以沉浸式的最小sdk版本是19，但是在android 5.x即sdk 21版本以后该属性并不能保证状态栏完全透明（小米MUI系统是透明的，单独处理过），状态栏为半透明状态，在android 6.0版本上设置该值同时会导致设置状态栏明暗的模式失效，但是半透明的状态栏保证信号电源等图标可以看清...。<item name="android:windowTranslucentNavigation">true</item>设置底部导航栏变透明，同时内容区域可以浸入导航栏下面，在android 5.x以上版本设置导航栏透明则状态栏才能完全透明，如果内容区域不希望被导航栏遮挡还需要适配底部导航栏的高度，同时该设置会导致设置导航栏颜色失效，如果只是想实现状态栏沉浸式，该属性可以忽略。。。<item name="android:windowDrawsSystemBarBackgrounds">true</item>设置可以修改statusBar背景色，5.x新增属性。AppCompat主题继承了Material.x主题，Material主题包含了该属性所以可以不设置，保险起见还是显示的加上这个属性。<item name="android:statusBarColor">@android:color/transparent</item>设置状态栏背景色，5.x新增属性。这个时候windowTranslucentStatus必须为false才有效果，通常设置为透明，这样一来虽然状态栏透明了，但是显示内容却不能浸入状态栏背面了，这时需要一段辅助代码助攻实现沉浸式，后面会提到。<item name="android:fitsSystemWindows">true</item>会自动让你的布局paddingTop一个状态栏的高度，在NoActionBar的时候很有用，结合windowTranslucentStatus = true同时设置自定义TitleBar或者ToolBar和根布局的背景色为相同的颜色来达到纯色的沉浸式效果。
用到的Theme属性已经介绍完了，现在看如何通过这些属性创造沉浸式主题：
首先创建BaseTheme AppTheme 和 AppTheme.NoActionBar， AppTheme.NoActionBar.TransparentStatusBar和AppTheme.NoActionBar.TransparentStatusBar.ImmerseStatusBar是两个沉浸式主题，继承自AppTheme.NoActionBar。
styles.xml
<resources>
<!-- Base application theme. -->
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
<!-- Customize your theme here. -->
<item name="colorPrimary">@color/colorPrimary</item>
<item name="colorPrimaryDark">@color/colorPrimaryDark</item>
<item name="colorAccent">@color/colorAccent</item>
</style>
<style name="AppTheme.NoActionBar">
<item name="windowActionBar">false</item>
<item name="windowNoTitle">true</item>
</style>
<style name="AppTheme.NoActionBar.TransparentStatusBar"/>
<style name="AppTheme.NoActionBar.TransparentStatusBar.ImmerseStatusBar"/>
</resources>在sdk版本>=19时，第一种沉浸式主题通过fitsSystemWindows = true和windowTranslucentStatus = true实现，第二种沉浸式通过windowTranslucentStatus = true + paddingTop=状态栏高度辅助代码实现
styles.xml v19
<resources>
<style name="AppTheme.NoActionBar.TransparentStatusBar">
<item name="android:fitsSystemWindows">true</item>
<!--华为等手机android版本21及以上设置该值状态栏为半透明状态，并且android 6.0版本设置状态栏明暗的模式会失效，半透明的状态栏保证信号电源等图标可以看清... -->
<item name="android:windowTranslucentStatus">true</item>
<!--华为等手机设置导航栏透明则状态栏才能完全透明，如果内容区域不希望被导航栏遮挡还需要适配底部导航栏的高度，同时该设置会导致设置导航栏颜色失效 -->
<!--<item name="android:windowTranslucentNavigation">true</item>-->
</style>
<style name="AppTheme.NoActionBar.TransparentStatusBar.ImmerseStatusBar">
<item name="android:fitsSystemWindows">false</item>
</style>
</resources>辅助代码一：设置根布局的paddingTop=状态栏高度
/**
* 获取状态栏高度
*
* @param context 目标Context
*/
private static int getStatusBarHeight(Context context) {
// 获得状态栏高度
int resourceId = context.getResources().getIdentifier("status_bar_height", "dimen", "android");
return context.getResources().getDimensionPixelSize(resourceId);
}
/**
* 增加View的paddingTop,增加的值为状态栏高度 (智能判断，并设置高度)
*
* @param context 目标Context
* @param view 需要增高的View
*/
public static void setPaddingTop(Context context, @NonNull View view) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
ViewGroup.LayoutParams lp = view.getLayoutParams();
if (lp != null && lp.height > 0 && view.getPaddingTop() == 0) {
lp.height += getStatusBarHeight(context);
view.setPadding(view.getPaddingLeft(), view.getPaddingTop() + getStatusBarHeight(context),
view.getPaddingRight(), view.getPaddingBottom());
}
}
}在sdk版本>=21时，第一种沉浸式主题没有定义但是会找v19的主题，此时状态栏是半透明的。第二种沉浸式通过windowTranslucentStatus = false + statusBarColor + paddingTop=状态栏高度 + 设置系统UI显示标志位辅助代码实现。
styles.xml v21
<resources>
<style name="AppTheme.NoActionBar.TransparentStatusBar.ImmerseStatusBar">
<item name="android:fitsSystemWindows">false</item>
<item name="android:windowTranslucentStatus">false</item>
<item name="android:windowDrawsSystemBarBackgrounds">true</item>
<!--Android 5.x开始需要把颜色设置透明，否则状态栏是半透明颜色-->
<item name="android:statusBarColor">@android:color/transparent</item>
</style>
</resources>辅助代码二：判断系统版本>=21，设置系统UI的显示标志位。
/**
* 设置沉浸式的SystemUiVisibility
*
* @param activity 目标Activity
*/
public static void setImmerseStatusBarSystemUiVisibility(Activity activity) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
int systemUiVisibility = activity.getWindow().getDecorView().getSystemUiVisibility();
systemUiVisibility |= View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN;
systemUiVisibility |= View.SYSTEM_UI_FLAG_LAYOUT_STABLE;
activity.getWindow().getDecorView().setSystemUiVisibility(systemUiVisibility);
}
}以上这些就足够完成沉浸式的功能，通过主题外加一点代码即可实现，既简单又好理解。
第一种适合纯色状态栏的主题，缺点是5.x版本状态栏是半透明并且切换状态栏的明暗模式可能会失效，但是实现简单不需要再写代码，支付宝的二级页面就是这种主题。
第二种支持渐变色和图片的状态栏，缺点是每个activity需要额外的代码辅助功能实现。
下面是完整的辅助代码，包括sdk>=23时设置状态栏明暗模式：
public class StatusBarUtil {
/**
* 设置沉浸式的SystemUiVisibility
*
* @param activity 目标Activity
*/
public static void setImmerseStatusBarSystemUiVisibility(Activity activity) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
int systemUiVisibility = activity.getWindow().getDecorView().getSystemUiVisibility();
systemUiVisibility |= View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN;
systemUiVisibility |= View.SYSTEM_UI_FLAG_LAYOUT_STABLE;
activity.getWindow().getDecorView().setSystemUiVisibility(systemUiVisibility);
}
}
/**
* 增加View的paddingTop,增加的值为状态栏高度 (智能判断，并设置高度)
*
* @param context 目标Context
* @param view 需要增高的View
*/
public static void setPaddingTop(Context context, @NonNull View view) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
ViewGroup.LayoutParams lp = view.getLayoutParams();
if (lp != null && lp.height > 0 && view.getPaddingTop() == 0) {
lp.height += getStatusBarHeight(context);
view.setPadding(view.getPaddingLeft(), view.getPaddingTop() + getStatusBarHeight(context),
view.getPaddingRight(), view.getPaddingBottom());
}
}
}
/**
* 设置状态栏darkMode,字体颜色及icon变黑(目前支持MIUI6以上,Flyme4以上,Android M以上)
*
* @param activity 目标activity
*/
public static void setDarkMode(@NonNull Activity activity) {
darkMode(activity.getWindow(), true);
}
/**
* 设置状态栏darkMode,字体颜色及icon变亮(目前支持MIUI6以上,Flyme4以上,Android M以上)
*
* @param activity 目标activity
*/
public static void setLightMode(@NonNull Activity activity) {
darkMode(activity.getWindow(), false);
}
@TargetApi(Build.VERSION_CODES.M)
private static void darkMode(Window window, boolean dark) {
if (isFlyme4()) {
setModeForFlyme4(window, dark);
} else if (isMIUI6()) {
setModeForMIUI6(window, dark);
}
darkModeForM(window, dark);
}
/**
* android 6.0设置字体颜色
*
* @param window 目标window
* @param dark 亮色 or 暗色
*/
@RequiresApi(Build.VERSION_CODES.M)
private static void darkModeForM(Window window, boolean dark) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
int systemUiVisibility = window.getDecorView().getSystemUiVisibility();
if (dark) {
systemUiVisibility |= View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR;
} else {
systemUiVisibility &= ~View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR;
}
window.getDecorView().setSystemUiVisibility(systemUiVisibility);
}
}
/**
* 设置MIUI6+的状态栏的darkMode,darkMode时候字体颜色及icon
* http://dev.xiaomi.com/doc/p=4769/
*
* @param window 目标window
* @param dark 亮色 or 暗色
*/
private static void setModeForMIUI6(Window window, boolean dark) {
Class<? extends Window> clazz = window.getClass();
try {
Class<?> layoutParams = Class.forName("android.view.MiuiWindowManager$LayoutParams");
Field field = layoutParams.getField("EXTRA_FLAG_STATUS_BAR_DARK_MODE");
int darkModeFlag = field.getInt(layoutParams);
Method extraFlagField = clazz.getMethod("setExtraFlags", int.class, int.class);
extraFlagField.invoke(window, dark ? darkModeFlag : 0, darkModeFlag);
} catch (Exception e) {
Log.e("StatusBar", "darkIcon: failed");
}
}
/**
* 设置Flyme4+的状态栏的darkMode,darkMode时候字体颜色及icon
* http://open-wiki.flyme.cn/index.php?title=Flyme%E7%B3%BB%E7%BB%9FAPI
*
* @param window 目标window
* @param dark 亮色 or 暗色
*/
private static void setModeForFlyme4(Window window, boolean dark) {
try {
WindowManager.LayoutParams lp = window.getAttributes();
Field darkFlag = WindowManager.LayoutParams.class.getDeclaredField("MEIZU_FLAG_DARK_STATUS_BAR_ICON");
Field meizuFlags = WindowManager.LayoutParams.class.getDeclaredField("meizuFlags");
darkFlag.setAccessible(true);
meizuFlags.setAccessible(true);
int bit = darkFlag.getInt(null);
int value = meizuFlags.getInt(lp);
if (dark) {
value |= bit;
} else {
value &= ~bit;
}
meizuFlags.setInt(lp, value);
window.setAttributes(lp);
} catch (Exception e) {
Log.e("StatusBar", "darkIcon: failed");
}
}
/**
* 判断是否Flyme4以上
*/
private static boolean isFlyme4() {
return Build.FINGERPRINT.contains("Flyme_OS_4") || Build.VERSION.INCREMENTAL.contains("Flyme_OS_4")
|| Pattern.compile("Flyme OS [4|5]", Pattern.CASE_INSENSITIVE).matcher(Build.DISPLAY).find();
}
/**
* 判断是否MIUI6以上
*/
private static boolean isMIUI6() {
try {
Class<?> clz = Class.forName("android.os.SystemProperties");
Method mtd = clz.getMethod("get", String.class);
String val = (String) mtd.invoke(null, "ro.miui.ui.version.name");
val = val.replaceAll("[vV]", "");
int version = Integer.parseInt(val);
return version >= 6;
} catch (Exception e) {
return false;
}
}
/**
* 获取状态栏高度
*
* @param context 目标Context
*/
private static int getStatusBarHeight(Context context) {
// 获得状态栏高度
int resourceId = context.getResources().getIdentifier("status_bar_height", "dimen", "android");
return context.getResources().getDimensionPixelSize(resourceId);
}
}具体效果可以查看demo：
参考： StatusBarUtil