这不是沉浸式状态栏

前言

首先请大家看几张图：

以上的效果，一般我们统称为沉浸式状态栏。其实，这种叫法不是很准确，而且也没有沉浸式状态栏这一说，只有沉浸模式。以上几种情况，可以称为透明状态栏或者状态栏着色。

一、两种状态

进行Android开发时，有两种方式都会对状态栏进行设置：Translucent Bar（透明栏）和Immersive Mode（沉浸模式）。两者的区别，比较直观的一点，就是体现在屏幕中的View可点击区域，如下所示。

• 沉浸模式
  隐藏status bar（状态栏）,使屏幕全屏，让Activity接收所有的（整个屏幕的）触摸事件。

• 状态栏着色
  设置状态栏颜色，状态栏部分不接收处理触摸事件。布局侵入状态栏的后面，必须启用fitsSystemWindows属性来调整布局才不至于被状态栏覆盖。如透明状态栏、与titlebar颜色一致的状态栏，即如之前的图所示。

二、如何沉浸

从3.x版本开始, 系统DecorView提供了setSystemUiVisibility方法, 可以通过设置Flag更改SystemUI的属性。各个设置的参数含义如下所示：

参数	api版本	含义
View.SYSTEM_UI_FLAG_VISIBLE	14	默认标记
View.SYSTEM_UI_FLAG_LOW_PROFILE	14	低功耗模式, 会隐藏状态栏图标, 在4.0上可以实现全屏
View.SYSTEM_UI_FLAG_LAYOUT_STABLE	16	保持整个View稳定，常跟bar 悬浮、隐藏共用, 使View不会因为SystemUI的变化而做layout
View.SYSTEM_UI_FLAG_FULLSCREEN	16	状态栏隐藏
View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN	16	状态栏上浮于Activity
View.SYSTEM_UI_FLAG_HIDE_NAVIGATION	14	隐藏导航栏
View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION	16	导航栏上浮于Activity
View.SYSTEM_UI_FLAG_IMMERSIVE	19	Kitkat新加入的Flag, 沉浸模式, 可以隐藏掉status跟navigation bar, 并且在第一次会弹泡提醒, 它会覆盖掉之前两个隐藏bar的标记, 并且在bar出现的位置滑动可以呼出bar
View.SYSTEM_UI_FLAG_IMMERSIVE_STIKY	19	与上面唯一的区别是, 呼出隐藏的bar后会自动再隐藏掉

综上所述，要实现全屏沉浸模式，只需如下设置即可：

//Hide
getWindow().getDecorView().setSystemUiVisibility(
                View.SYSTEM_UI_FLAG_LAYOUT_STABLE
                        | View.SYSTEM_UI_FLAG_LOW_PROFILE
                        | View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
                        | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
                        | View.SYSTEM_UI_FLAG_FULLSCREEN
                        | View.SYSTEM_UI_FLAG_IMMERSIVE_STIKY);

实现沉浸效果如下图所示。左边是隐藏状态栏和导航栏的效果，整个屏幕都可以接收触摸反馈；右边图是滑动显示的状态栏和导航栏的效果，内容显示在系统栏的下方，显示一段时间后会自动隐藏。

三、如何着色

3.1 两个系统节点

对于状态栏着色，有两个比较关键的系统节点需要关注，分别是4.4和5.0。基于两个系统节点，我们又可以分成三个阶段进行讨论。

• 4.4以前
  状态栏不支持设置颜色。

• 4.4 ～ 5.0
  状态栏支持透明效果，但是系统不提供接口进行颜色设置（有办法，文章后面会介绍）。

• 5.0及以上
  系统提供接口对状态栏进行任意颜色设置。

3.2 实现的两种方式

3.2.1 主题和布局设置

1. 在values、values-v19、values-v21的style.xml都设置一个 Translucent System Bar 风格的Theme

   • values/style.xml

     <style name="ImageTranslucentTheme" parent="AppTheme">
       <!--在Android 4.4之前的版本上运行，直接跟随系统主题-->
     </style>
     

   • values-v19/style.xml

     <style name="ImageTranslucentTheme" parent="Theme.AppCompat.Light.NoActionBar">
       <item name="android:windowTranslucentStatus">true</item>
       <item name="android:windowTranslucentNavigation">true</item>
     </style>
     

   • values-v21/style.xml

     <style name="ImageTranslucentTheme" parent="Theme.AppCompat.Light.NoActionBar">
       <item name="android:windowTranslucentStatus">false</item>
       <item name="android:windowTranslucentNavigation">true</item>
       <item name="android:statusBarColor">@android:color/transparent</item>
     </style>
     

2. 在AndroidManifest.xml中对指定Activity的theme进行设置

<activity android:name=".MainActivity"
    android:theme="@style/ImageTranslucentTheme"
    >
</activity>

1. 在Activity的布局文件中设置背景图片，同时，需要把android:fitsSystemWindows设置为true

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/activity_main"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@mipmap/paperscan_guide_step_two_inside"
    android:fitsSystemWindows="true"
    >

    <TextView
        android:text="透明状态栏~"
        android:textColor="@android:color/white"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
</LinearLayout>

如此可以得到效果如下所示

那么，为什么要将android:fitsSystemWindows设置为true呢？如果不设置会怎么样？我们可以来测试下，下图是不设置（默认为false）的效果。可见内容跑到了状态栏的下面，被状态栏覆盖了。所以，最直观的一点我们可以发现，设置了android:fitsSystemWindows为true，可以让内容不会顶到状态栏的下面。文章Android沉浸式状态栏实现对fitsSystemWindows已经做了详细的分析，大家有兴趣可以看看。

接着上面的问题，既然我们实现透明状态栏效果的页面都需要设置fitsSystemWindows属性，所以我们想到了一种方便的方法，在theme中加上如下的android:fitsSystemWindows设置：

<item name="android:fitsSystemWindows">true</item>

运行发现真的可以，显示的内容也没有和状态栏重叠。但是，当我们显示一个toast的时候，发现问题了。

Toast.makeText(MainActivity.this,"toast sth...",Toast.LENGTH_SHORT).show();

如图所示，Toast打印出来的文字都向上偏移了。原因是因为我们是在Theme中设置的fitsSystemWindows属性，会影响使用了该theme的activity或application的行为，造成依附于Application Window的Window（比如Toast）错位。针对Toast错位的问题，解决方法也简单，就是使用应用级别的上下文：

Toast.makeText(getApplicationContext(),"toast sth...",Toast.LENGTH_SHORT).show();

虽说Toast错误问题也是有方法可以解决，但是如果这样使用，不经意间会给我们的应用埋下很多坑。所以我的建议是：不要滥用，只在有需要的地方添加fitsSystemWindows属性。

3.2.2 代码设置

正如前面提到的，只有4.4以上的系统才支持透明状态栏设置，5.0以上的系统支持设置状态栏任意颜色。所以5.0以上的系统设置状态栏的颜色就很简单了，直接调用系统接口就可以了：

// 设置此flag才可对状态栏进行颜色设置
activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
// 取消设置透明状态栏，不然颜色设置不生效
activity.getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
// 设置状态栏颜色
activity.getWindow().setStatusBarColor(color);

而对于系统是4.4到5.0之间的机子，要设置状态栏的颜色就稍微要繁琐一点了。首先，需要设置页面状态栏为透明；然后，新建一个和状态栏高度一致的view，填充到DecorView上；最后，通过设置这个填充view的颜色，我们就能实现类似对状态栏颜色进行控制的效果了。

// 设置透明
activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
// 生成view填充DecorView
ViewGroup decorView = (ViewGroup) activity.getWindow().getDecorView();
View fakeStatusBarView = decorView.findViewById(FAKE_STATUS_BAR_VIEW_ID);
if (fakeStatusBarView != null) {
    if (fakeStatusBarView.getVisibility() == View.GONE) {
        fakeStatusBarView.setVisibility(View.VISIBLE);
    }
    fakeStatusBarView.setBackgroundColor(calculateStatusColor(color, statusBarAlpha));
} else {
    decorView.addView(createStatusBarView(activity, color, statusBarAlpha));
}
// 设置fitsSystemWindows属性
setRootView(activity);

3.3 着色原理

在文章的前面部分，在系统4.4～5.0的机子上，如何设置状态栏颜色的原理其实已经做了说明。就是在透明的状态栏下放置一个和状态栏大小一致的view，通过更改view的颜色来实现更改状态栏颜色的效果。那么，当在5.0及以上的机子，当我们通过如下代码设置状态栏颜色:

getWindow().setStatusBarColor(RED);

其实，这里调用的是PhoneWindow的setStatusBarColor方法，具体实现如下：

@Override
public void setStatusBarColor(int color) {
    mStatusBarColor = color;
    mForcedStatusBarColor = true;
    if (mDecor != null) {
        mDecor.updateColorViews(null, false /* animate */);
    }
}

最终调用的是DecorView的updateColorViews函数，DecorView是属于Activity的PhoneWindow的内部对象，也就说，更新的对象从所谓的Window进入到了Activity自身的布局视图中，接着看DecorView，这里只关注更改颜色。在方法updateColorViews中，调用了如下代码，代码实现的功能就是修改状态栏颜色：

updateColorViewInt(mNavigationColorViewState, sysUiVisibility,
    mWindow.mNavigationBarColor, navBarSize, navBarToRightEdge || navBarToLeftEdge,
    navBarToLeftEdge,
    0 /* sideInset */, animate && !disallowAnimate, false /* force */);

这里mStatusColorViewState其实就代表StatusBar的背景颜色对象，主要属性包括显示的条件以及颜色值：

 private final ColorViewState mStatusColorViewState = new ColorViewState(
        SYSTEM_UI_FLAG_FULLSCREEN, FLAG_TRANSLUCENT_STATUS,
        Gravity.TOP,
        Gravity.LEFT,
        STATUS_BAR_BACKGROUND_TRANSITION_NAME,
        com.android.internal.R.id.statusBarBackground,
        FLAG_FULLSCREEN);

再来看updateColorViewInt方法：

private void updateColorViewInt(final ColorViewState state, int sysUiVis, int color,
        int size, boolean verticalBar, boolean seascape, int sideMargin,
        boolean animate, boolean force) {
    // 关键点1  
    state.present = (sysUiVis & state.systemUiHideFlag) == 0
            && (mWindow.getAttributes().flags & state.hideWindowFlag) == 0
            && ((mWindow.getAttributes().flags & FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS) != 0
                    || force);
    // 关键点2
    boolean show = state.present
            && (color & Color.BLACK) != 0
            && ((mWindow.getAttributes().flags & state.translucentFlag) == 0  || force);
    boolean showView = show && !isResizing() && size > 0;

    ...

    if (view == null) {
        if (showView) {
                // 关键3 设置view的颜色
            state.view = view = new View(mContext);
            view.setBackgroundColor(color);
            view.setTransitionName(state.transitionName);
            view.setId(state.id);
            visibilityChanged = true;
            view.setVisibility(INVISIBLE);
            state.targetVisibility = VISIBLE;

            LayoutParams lp = new LayoutParams(resolvedWidth, resolvedHeight,
                    resolvedGravity);
            if (seascape) {
                lp.leftMargin = sideMargin;
            } else {
                lp.rightMargin = sideMargin;
            }
            addView(view, lp);
            updateColorViewTranslations();
        }
    } else {
        int vis = showView ? VISIBLE : INVISIBLE;
        visibilityChanged = state.targetVisibility != vis;
        state.targetVisibility = vis;
        LayoutParams lp = (LayoutParams) view.getLayoutParams();
        int rightMargin = seascape ? 0 : sideMargin;
        int leftMargin = seascape ? sideMargin : 0;
        if (lp.height != resolvedHeight || lp.width != resolvedWidth
                || lp.gravity != resolvedGravity || lp.rightMargin != rightMargin
                || lp.leftMargin != leftMargin) {
            lp.height = resolvedHeight;
            lp.width = resolvedWidth;
            lp.gravity = resolvedGravity;
            lp.rightMargin = rightMargin;
            lp.leftMargin = leftMargin;
            view.setLayoutParams(lp);
        }
        if (showView) {
            view.setBackgroundColor(color);
        }
    }
    ...
}

先看下关键点1，这里是根据SystemUI的配置决定是否显示状态栏背景颜色。如果状态栏都不显示，那就没必要显示背景色了。再看关键点2，如果状态栏显示，但背景是透明色，也没必要添加背景颜色，即不满足(color & Color.BLACK) != 0。然后，看一下translucentFlag，默认情况下，状态栏背景色与translucent半透明效果互斥，半透明就统一用半透明颜色，不会再添加额外颜色。最后，再来看关键点3，其实很简单，就是往DecorView上添加一个View，理论上DecorView也是一个FrameLayout，所以最终的实现就是在FrameLayout添加一个有背景色的View。

四、100分状态栏着色实践

目前网上封装好的状态栏设置工具有不少，用得比较多的是StatusBarUtil，还有已经废弃的SystemBarTint。但是有个问题，无论哪个工具库，都不敢保证能够百分百实现状态栏着色的效果。因此，兼容性问题是一直存在的。通过实践分析总结，兼容性问题主要有两类：

• 部分ROM（大多数是4.4~5.0的机子）本身就是不支持状态栏着色效果
• 5.0以上的机子，不支持常规操作方式，需要采用特殊方式处理（4.4～5.0的处理方式）

当出现如上所述的问题时，我们的处理方式一般是这样（不侵入修改第三方库）：

1. 实现一个兼容性工具类，获取本机信息，判断相关兼容性问题
2. 在业务代码中判断兼容性条件，分情况判断是否设置状态栏颜色。支持状态栏设置的，还需要分情况判断使用哪种方式设置。

if (RomUtil.isCompactSystemVersionForImmersion()) {

    if (RomUtil.isCompactRomForImmersion()) {
        StatusBarUtils.setColor(ActivityMain.this, Color.TRANSPARENT);
    } else {
        setTranslucentStatus(true);
        tintManager = new SystemBarTintManager(this);
        tintManager.setStatusBarTintEnabled(true);
        tintManager.setStatusBarTintColor(Color.TRANSPARENT);//通知栏所需颜色
    }

}

看上面实现，会发现代码逻辑很繁琐。而且当一个新的地方需要设置状态栏颜色时，相应的这一堆代码都需要再写一遍。显然，这种方式不是太友好，当然，我们可以将条件判断都修改到库里面，直接修改库源码。但是这又带来另一个问题，当库有更新了，升级库就很麻烦。

考虑到上述的一些问题，所以在我们设计的库中，将兼容性判断的相关细节隐藏在库中，使用的时候只需调用相关方法即可。库对外提供了兼容性配置接口，用户可以自由配置，决定是否需要设置状态栏颜色。即实现对库无侵入的修改，即使升级了库，相应的兼容性配置信息也不会丢失。整个库设计的UML图如下所示：

要使用库也非常简单，只需要如下几步：

• 在build.gradle中导入库

compile 'com.zr.statusbarmanager:library:1.0.0-beta'

• 实现ICompatConfig接口，重写方法实现兼容性配置。接口主要提供了两个检查配置的方法，分别如下所示：

 /**
 * 检测是否支持状态栏设置
 * @return
 */
boolean checkCompatiblity();

/**
 * 检测是否需要特殊设置的Rom
 * @return
 */
boolean checkSpecialRom();

上述的两个方法，主要用于对应解决我们之前总结的两个兼容性问题。checkCompatiblity用来判断是否支持设置状态栏颜色。如果返回false，则不会对状态栏设置颜色。checkSpecialRom在实际测试过程中，有一款华为手机，搭载EMUI 3.1系统，对应Android系统版本5.1。我们发现用常规直接设置状态栏颜色的方式设置是不生效的，但是用5.0以下系统设置状态栏颜色方式设置就可以生效。所以，该方法就是为了此类特殊ROM而定义的。

当然库也提供了一个默认的实现DefaultStatusBarCompatConfig，这也是我们在项目开发过程中根据兼容性测试发现的一些问题进行的配置，绝对很有参考价值。如果用户自己实现配置，只需要如下设置：

public class StatusBarCompactConfig implements ICompatConfig {
    @Override
    public boolean checkCompatiblity() {
        if (CompatUtil.checkCompatiblity()) {
            // TODO: 17/7/28 自定义的兼容性判断逻辑
        } else {
            return false;
        }
    }

    @Override
    public boolean checkSpecialRom() {
        if (CompatUtil.checkSpecialRom()) {
            return true;
        } else {
            // TODO: 17/7/28 自定义特殊ROM判断逻辑
        }
    }
}

其中CompatUtil是库提供的兼容性判断工具类，若用户在使用库的时候需要带上库已经提供的相关兼容性信息，可以调用工具类的相关方法。如果不需要，也可以完全自己实现。

• 在Application中初始化库的设置

StatusBarManager.getsInstance().init(new DefaultStatusBarCompatConfig());

• 在页面中调用库方法设置状态栏颜色

StatusBarManager.getsInstance().setColor(MainActivity.this, Color.TRANSPARENT);

五、那些坑

5.1 颜色设置不成功回滚

因为库不能保证设置状态栏颜色在所有机子上都生效，部分机子我们可以在兼容性测试的时候做到兼容，但是不保证不会有漏网之鱼。这会导致一个问题，就是在这些不支持的手机上，没有达到预期效果，降低了用户体验。这个时候如果能够发现设置颜色失败，然后对这些不支持的机型能够做特殊处理，那就最好了。

于是想到的一种方案:

1. 先设置颜色
2. 然后在页面打开后，进行应用内截屏，获取当前DecorView的图像截屏（不需要root权限）
3. 取截屏图片状态栏部分的颜色与设置的颜色比对，如果颜色一致表明设置成功，否则说明设置失败。如果设置失败的话，此时可以弹框提示用户进行操作，将设置失败的影响降到最低。

方案看着还是可行的，那么开始验证。实际测试的时候，发现并不是我们想的那样的。我们测试是正确实现了状态栏的设置，但是实际的视觉效果并没有变成设置的颜色，还是显示的系统的状态栏颜色。如下图所示，红框内是截屏图像，发现与实际屏幕显示的图像状态栏颜色并不一致。

猜测是有些ROM对状态栏进行了定制，在状态栏相同的位置覆盖了一个相同的view，且这个view的层级比Decoeview高，截图获取的是view下方的DecorView视图。（大家如果有什么好的判断的方式，期待交流～）

5.2 windowTranslucentStatus与statusBarColor不能同时生效

Android4.4的时候，加了个windowTranslucentStatus属性，实现了状态栏导航栏半透明效果，而Android5.0之后以上状态栏、导航栏支持颜色随意设定，所以，5.0之后一般不使用需要使用该属性，而且设置状态栏颜色与windowTranslucentStatus是互斥的。所以，默认情况下android:windowTranslucentStatus是false。也就是说：‘windowTranslucentStatus’和‘windowTranslucentNavigation’设置为true后就再设置‘statusBarColor’和‘navigationBarColor’就没有效果了

boolean show = state.present
                && (color & Color.BLACK) != 0
                && ((mWindow.getAttributes().flags & state.translucentFlag) == 0  || force);

可以看到，添加背景View有一个必要条件

(mWindow.getAttributes().flags & state.translucentFlag) == 0

也就是说一旦设置了

 <item name="android:windowTranslucentStatus">true</item>

相应的状态栏或者导航栏的颜色设置就不在生效。不过它并不影响fitSystemWindow的逻辑。

5.3 设置SystemUiVisibility属性

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
    activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
    activity.getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
    activity.getWindow().setStatusBarColor(calculateStatusColor(color, statusBarAlpha));
} else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
    activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
    ...
}

以上代码设置状态栏颜色，当设置状态栏透明时，我们发现一个现象。在5.0之前的机子上，内容可以延伸到状态栏下面；而在5.0以上的机子上，顶部会有一块空出的view，如图所示。

为什么会导致这个现象呢？这里要从WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS这个属性说起。在5.0之前系统上，该属性设置为true，5.0及之后系统，属性设置为false。查看WindowManager中该属性的注释，发现如下一段话：

<p>When this flag is enabled for a window, it automatically sets
 * the system UI visibility flags {@link View#SYSTEM_UI_FLAG_LAYOUT_STABLE} and
 * {@link View#SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN}.</p>

原来设置FLAG_TRANSLUCENT_STATUS为true之后，会自动设置SYSTEM_UI_FLAG_LAYOUT_STABLE和SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN的系统UI属性，通过前面沉浸设置，可以知道这就是实现内容显示到状态栏下的设置。因为5.0以上系统FLAG_TRANSLUCENT_STATUS为false，当然内容也将不会显示到导航栏下。所以，在5.0的机子上，需要加上此段设置代码：

activity.getWindow().getDecorView().set(View.SYSTEM_UI_FLAG_LAYOUT_STABLE | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN);

六、结束

在Android项目开发过程中，免不了要和系统栏打交道。以上是作者根据平时项目开发经验、并结合网上查阅的资料对状态栏相关设置进行的总结。希望对大家有帮助，欢迎大家交流讨论～

项目地址：https://github.com/yushiwo/StatusBarManager

参考文章

1. Android App 沉浸式状态栏解决方案
2. StatusBarUtil 状态栏工具类（实现沉浸式状态栏/变色状态栏）
3. 令人困惑的fitsSystemWindows属性
4. what-are-windowinsets
5. Android沉浸式状态栏实现
6. 沉浸式管理：让你的APP更优雅
7. 使用setSystemUiVisibility适配statusbar和navigationbar
8. StatusBarAdapt
9. 全屏、沉浸式、fitSystemWindow使用及原理分析：全方位控制“沉浸式”的实现
10. Android SystemBar
11. 探索Android半透明状态栏
12. 沉浸式状态栏
13. 由沉浸式状态栏引发的血案
14. Android开发：Translucent System Bar 的最佳实践
15. 全屏、沉浸式、fitSystemWindow使用及原理分析：全方位控制“沉浸式”的实现
    

本文来自网易实践者社区，经作者郑睿授权发布。