终于搞懂令人迷惑的 StatusBar 了
转自 http://www.jianshu.com/p/c8221fb6b4fc
随着Android版本的迭代，开发者对状态栏等控件有了更多的控制， google 一直在尝试引入新的Api来满足开发者的需求，但Api却一直不够完美，接口添加了很多，却都不够简单或者说完美，算上第三方厂商的特色行为，怎一个“乱”字了得。
1、效果
当前主流（2017）Android app StatusBar 效果有以下几种：
简单分个类：
- Material Design 风格，状态栏颜色比 toolbar 颜色略深。google 全家桶主要采用这个方式。
- 与 DrawerLayout 结合使用，抽屉划出后，状态栏添加一个半透明蒙层，抽屉位于蒙层和原状态栏之间。 google 全家桶采用。
- 与 toolbar 同色，大部分国内 app 使用。
- 大黑边 国内少部分 app，5.0以下大部分app都是这个效果。
- 隐藏状态栏，导航栏，滑动时出现。欢迎，登录，全屏视频播放等界面使用。
- 渐变效果，少部分app使用
- 状态栏字体默认为白色，部分 app 修改为黑色
- 图片延伸到状态栏
2、相关API
与状态栏相关的 Api 主要有以下几个：
2.1、远古时期 API1
// 全屏布局且隐藏状态栏：
//4.4 上，顶部下滑，出现半透明状态栏，过一会儿状态栏消失
//4.1 上，顶部下滑，没反应
getWindow().addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);
// 全屏布局，不隐藏状态栏（可能已失效）：
//实测 Support libaray 26.1.0 下（使用 support 库中的主题和 AppCompatActivity）,未见状态栏。
getWindow().addFlags(WindowManager.LayoutParams.FLAG_LAYOUT_IN_SCREEN
| WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS);
2.2、Android3.0
在Android3.0中，View添加了一个重要的方法：View.setSystemUiVisibility(int)，用于控制一些窗口装饰元素的显示，并添加了
- View.STATUS_BAR_VISIBLE
- View.STATUS_BAR_HIDDEN ：实测statusbar不会消失，仅隐藏statusbar 部分内容
两个Flag用于控制Status Bar的显示与隐藏。
一般是这么用的
View decorView = getWindow().getDecorView();
int uiOptions = View.STATUS_BAR_VISIBLE;
decorView.setSystemUiVisibility(uiOptions);
2.3、Android4.0
- View.STATUS_BAR_VISIBLE 改为 View.SYSTEM_UI_FLAG_VISIBLE，
- View.STATUS_BAR_HIDDEN 更名为 View.SYSTEM_UI_FLAG_LOW_PROFILE,该 flag 同时影响 StatusBar 和 NavigationBar ,但并不会使得 SystemUI 消失，而只会使得背景很浅，并且去掉 SystemUI 的一些图标或文字。
- 添加了一个flag:SYSTEM_UI_FLAG_HIDE_NAVIGATION,会隐藏NavigationBar,但是由于NavigationBar是非常重要的，因此只要有用户交互（例如点击一个 button），系统就会清除这个flag使NavigationBar就会再次出现。
2.4、Android4.1
- View.SYSTEM_UI_FLAG_FULLSCREEN: 这个标志与WindowManager.LayoutParams.FLAG_FULLSCREEN作用相同(全屏布局且隐藏状态栏)
- 4.1 上顶部下滑没反应
- 4.4 上顶部下滑从新出现状态栏，且挤压 Activity 的布局。
- View.SYSTEM_UI_FLAG_LAYOUT_STABLE: 与其它flag配合使用，防止系统栏隐藏时内容区域发生变化。
- View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN: Activity全屏显示，但状态栏不会被隐藏覆盖，状态栏依然可见，Activity顶端布局部分会被状态遮住
- View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION: 使内容布局到NavigationBar之下。
2.5、Android 4.4
- View.SYSTEM_UI_FLAG_IMMERSIVE
- View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
View.SYSTEM_UI_FLAG_IMMERSIVE 和 SYSTEM_UI_FLAG_HIDE_NAVIGATION 搭配使用，使用 SYSTEM_UI_FLAG_HIDE_NAVIGATION 后，导航栏消失，当用户交互时（例如点击一个 button），导航栏又会出现，添加 View.SYSTEM_UI_FLAG_IMMERSIVE 后，交互时导航栏不会出现，但是会底部滑动导航栏仍会出现。
View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY 和 View.SYSTEM_UI_FLAG_FULLSCREEN 配合使用：状态栏半透明，顶部向下滑动出现，过一段时间消失。
View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY 和 SYSTEM_UI_FLAG_HIDE_NAVIGATION 配合使用：导航栏半透明，交互时，导航栏不出现，底部向上滑动出现，过一段时间消失。
FLAG_TRANSLUCENT_STATUS
当使用这个flag时SYSTEM_UI_FLAG_LAYOUT_STABLE和SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN会被自动添加,同时，设置FLAG_TRANSLUCENT_STATUS也会影响到StatusBar的背景色，但并没有固定的表现：
- 对于7.0以上的机型，设置此flage会使得StatusBar半透明
- 对于6.0以上的机型，设置此flage会使得StatusBar完全透明
- 对于5.x的机型，大部分是使背景色半透明，小米和魅族以及其它少数机型会全透明
- 对于4.4的机型，小米和魅族是透明色，而其它系统上就只是黑色到透明色的渐变。
google 你到底要闹哪样？
FLAG_TRANSLUCENT_NAVIGATION
当使用这这个个flag时SYSTEM_UI_FLAG_LAYOUT_STABLE和SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION会被自动添加。同时，设置FLAG_TRANSLUCENT_STATUS也会影响到 NavigationBar 的背景色,效果与 FLAG_TRANSLUCENT_STATUS 相同
2.6、Android 5.0
- 主题里通过colorPrimaryDark来指定 StatusBar 背景色
- 可以调用 window.setStatusBarColor(@ColorInt int color) 来修改状态栏颜色,但是让这个方法生效有一个前提条件：你必须给window添加FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS并且取消FLAG_TRANSLUCENT_STATUS
2.7、Android 6.0
在Android6以后，我们只要给SystemUI加上SYSTEM_UI_FLAG_LIGHT_STATUS_BAR这个flag，就可以让字体和图标变为黑色。
2.8、fitSystemWindows
在布局内容延伸到状态栏和导航栏时，我们可以给 View 设置 fitSystemWindows 属性，它是一个 boolean 值，可以在xml里直接设置android:fitsSystemWindows="true",也可以通过View#setFitsSystemWindows(boolean fitSystemWindows)在java代码中设置。设置后，空调会调整自己的 padding 用于避开系统控件。
工作原理：
Android系统组件例如状态栏、NavBar、键盘所占据的空间称为界面的WindowInsets,Android系统会在特定的时机从根View派发WindowInsets(深度优先)。一旦有一个View 的 fitSystemWindows 设置为 true，它就会根据WindowInsets来调整自己的 padding,并消耗WindowInsets，不在向下分发 WindowInsets,那么WindowInsets的派发过程就结束了。
需要注意的是：
- fitSystemWindows 设置为 true,会让View原本的padding失效。
- 可以覆写 View 的 onApplyWindowInsets(WindowInsets insets) 方法来自己处理 WindowInsets。
- dispatchApplyWindowInsets 方法可以继续传递 WindowInsets.
3、实现
3.1、Material Design 风格
采用这个效果的应用主要是 Material Design 设计风格的 App,表现形式为：
- Android 5.0+,状态栏颜色略深与 toolbar,颜色值可以来这里找
- Android 5.0以下，状态栏变现为大黑边
实现这样的风格很简单：
- 如果状态栏颜色不变，可以直接在主题（5.0 style）中定义：
xml version="1.0" encoding="utf-8"?>
<resources>
<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
<item name="colorPrimary">@color/colorPrimaryitem>
<item name="colorPrimaryDark">@color/colorPrimaryDarkitem>
<item name="colorAccent">@color/colorAccentitem>
<item name="android:windowDrawsSystemBarBackgrounds">trueitem>
<item name="android:statusBarColor">@android:color/transparentitem>
style>
resources>
需要注意的是：
<item name="android:windowDrawsSystemBarBackgrounds">trueitem>
和
<item name="android:windowTranslucentStatus">trueitem>
不能同时设置为 true，否则设置的颜色失效。
- 如果状态栏颜色在运行过程中需要变化：
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
window.setStatusBarColor(color);
}
3.2、Toolbar 同色
效果和 Material Design 风格类似，设置方法和Material Design 风格相同。
3.3、侧边栏
效果：
- 5.0+：抽屉划出后，状态栏添加一个半透明蒙层，抽屉位于蒙层和原状态栏之间。
- 5.0-：状态栏为大黑边，不参与交互。
曾经，想做个 material design 风格的侧边栏效果，那是相当的复杂，可以看看这篇文章，现在（support 库最新版本 26.1.0）,给 DrawerLayout 设置 fitSystemWindows 为 true，系统就帮你把所有的事办好了，当然包括了老版本的兼容（google 大法好）。
3.4、渐变效果
效果：
5.0+：渐变
5.0-：大黑边
实现：
- 状态栏设置为透明：
v21 的style
<item name="android:windowDrawsSystemBarBackgrounds">trueitem>
<item name="android:statusBarColor">@android:color/transparentitem>
或者
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
getWindow().setStatusBarColor(getResources().getColor(android.R.color.transparent));
}
- 设置从状态栏开始布局
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
View decorView = getWindow().getDecorView();
int uiOptions = View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN;
decorView.setSystemUiVisibility(uiOptions);
}
- 修改布局
不同版本设置不同的布局（代码，xml 均可）
5.0+：在布局顶部加上有渐变效果背景的 View，渐变效果可以使用 shape 实现。
5.0-：正常布局。
3.5、隐藏状态栏，导航栏，滑动时出现
欢迎，登录，全屏视频播放等界面可能会使用这样的效果。
常见的效果有：
视频全屏播放：
- 4.4+：全屏布局，状态栏，导航栏消失，一般交互时不出现，滑动顶部或底部时出现，过一段时间消失。
getWindow().getDecorView().setSystemUiVisibility(
View.SYSTEM_UI_FLAG_FULLSCREEN
| View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
| View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY);
- 4.0+：这个版本就不要指望隐藏导航栏了（这个版本一交互，导航栏必然要出现），状态栏消失，顶部滑动导航栏不出现。
getWindow().addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);
全屏欢迎页面：
- 4.4+：全屏布局，状态栏，导航栏消失，一般交互时不出现，滑动顶部或底部时出现且状态栏导航栏均为半透明，过一段时间消失。
getWindow().getDecorView().setSystemUiVisibility(
View.SYSTEM_UI_FLAG_FULLSCREEN
| View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
| View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY);
- 4.0+：导航栏，状态栏消失。欢迎页没有交互，导航栏不会因为交互出现。
getWindow().addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);
getWindow().getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_HIDE_NAVIGATION);
类似qq的登录页面
- 4.4+：全屏布局，状态栏消失，滑动顶部时出现，过一段时间消失。
getWindow().getDecorView().setSystemUiVisibility(
View.SYSTEM_UI_FLAG_FULLSCREEN
| View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY);
- 4.0+：状态栏消失，顶部滑动导航栏不出现。
getWindow().addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);
3.6、状态栏字体修改为黑色
一般这么干的都是将状态栏设计为浅色的。因为仅 6.0+ 和 小米 魅族支持修改状态栏颜色。5.0 版本会因为浅色状态栏看不清状态栏信息。最好还是让设计改设计稿吧！非要这么做的话，就只有为 5.0 单独设计了，适配 5.0-， 5.0+， 6.0+，这酸爽。
3.7、图片延伸到状态栏
同渐变效果，仅最后一步将添加渐变 view 改为 添加 ImageView 即可。
注意
github 有一些很火热的库，使用了 FLAG_TRANSLUCENT_STATUS 特性，将状态栏适配到了 4.4，上文已指出 FLAG_TRANSLUCENT_STATUS 在不同平台显示效果存在差异，不能保证较为一致的视觉效果，所以状态栏要玩出花样最合适的版本是 5.0+， 5.0- 统一大黑边就可以了。
参考资料
- Android 沉浸状态栏
- Android沉浸式状态栏必知必会
- Material Design 之 侧边栏与 Status Bar 不得不说的故事
作者：runningzou
链接：http://www.jianshu.com/p/c8221fb6b4fc
來源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。