Android透明状态栏多版本适应开发总结

案例：

效果：

效果

第一种

思路：

• android5.0以上

1. 利用window将声明Status可绘制，相关Param属性为FLAG_DRAW_SYSTEM_BAR_BACKGROUDS
2. 调用window.setStatusBarCorlor()将Status颜色设置成actionBar颜色

这种方法有一定的局限性，满足toolbar为单一颜色的情况，当toolbar颜色背景为渐变色/图片时无法适用。

代码实现：

        // activity中
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
            getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
            // 颜色为状态栏颜色，可在style中查看
            getWindow().setStatusBarColor(getResources().getColor(R.color.colorPrimary)); 
        }

• 5.0以下

第二种

通常配合Toolbar使用，关于隐藏ActionBar添加Toolbar的方法不是本篇重点，这里不进行赘述。
思路：将status设为半透明，在系统布局中加上一个view充当status的背景

    // activity中
    private View mStatusView;

    private void addToolbarTransparent() {
        // 为window设立半透明状态栏的标签
        getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
        if (mStatusView == null) {
            mStatusView = new View(this);
            // 屏幕宽度
            int screenWidth = getResources().getDisplayMetrics().widthPixels;
            int screenHeight = getStatusBarHeight();
            ViewGroup.LayoutParams layoutParams =  new ViewGroup.LayoutParams(screenWidth,screenHeight);

            mStatusView.setLayoutParams(layoutParams);
            mStatusView.requestLayout();
            
            // 获取系统布局
            ViewGroup systemContent = findViewById(android.R.id.content);
            // 系统布局的第一个元素（用户布局）为 status 预留空间，文章末尾对该方法进行补充
            systemContent.getChildAt(0).setFitsSystemWindows(true);

            systemContent.addView(mStatusView, 0);
            // 设置背景颜色，这里也可设置drawable背景
            mStatusView.setBackgroundColor(getResources().getColor(R.color.colorPrimary));
        }
    }
    
    /** 通过Resource获取status高度 **/
    private int getStatusBarHeight() {
        int statusBarHeight = -1;
        int resourceId = getResources().getIdentifier("status_bar_height", "dimen", "android");
        if (resourceId > 0) {
            statusBarHeight = getResources().getDimensionPixelSize(resourceId);
        }
        return statusBarHeight;
    }

该方法设置透明状态栏的好处是可以任意处理我们添加的StatusView，比如一个activity中多个fragment切换时toolbar颜色跟着切换，status设置为图片背景、渐变色等。

渐变色状态栏

但该方法也有一定局限性，由于我们给window设定的标签FLAG_TRANSLUCENT_STATUS是将状态栏设置为半透明，可让低版本的status全透明，但高版本机型会出现以下情况

无

这时我们需要利用DecorView的两个标签SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN和SYSTEM_UI_FLAG_LAYOUT_STABLE，并结合DecorView#setStatusColor()（5.0以上）将状态栏设置为完全透明，并将FitsSystemWindows设为true。

• SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN：隐藏status，将用户布局全屏显示
• SYSTEM_UI_FLAG_LAYOUT_STABLE：结合上面属性使用，在用户布局全屏显示的时候不隐藏status

代码实现基于上面5.0以下的适配代码。

        private void addToolbarTransparent() {
//        getWindow().addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);
        getWindow().setStatusBarColor(Color.TRANSPARENT);
        getWindow().getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN | View.SYSTEM_UI_FLAG_LAYOUT_STABLE);

        if (mStatusView == null) {
            mStatusView = new View(this);
            int screenWidth = getResources().getDisplayMetrics().widthPixels;
            int screenHeight = getStatusBarHeight();
            ViewGroup.LayoutParams layoutParams =  new ViewGroup.LayoutParams(screenWidth,screenHeight);

            mStatusView.setLayoutParams(layoutParams);
            mStatusView.requestLayout();

            ViewGroup systemContent = findViewById(android.R.id.content);
            ViewGroup userContent = (ViewGroup) systemContent.getChildAt(0);


            userContent.setFitsSystemWindows(true);
            systemContent.addView(mStatusView, 0);

            mStatusView.setBackgroundColor(getResources().getColor(R.color.colorPrimary));
        }

最后，当状态栏字体需要从黑色变为浅色时，可以调用以下方法

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    getWindow().getDecorView()
        .setSystemUiVisibility(View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR);
}

总结：

• 应用场景总结：

1. 当toolbar为单一颜色且只需适配5.0以上机型时，用第一种方法，直接将status设为应用状态栏颜色，省时省力。
2. 当需要适配低版本时或者需要status设为图片背景时，用第二种方法，虽然麻烦一点，但灵活性相对高一些。

• 属性总结：

1. setFitsSystemWindows：即用户视图(user_content)为status预留空间，当设为false时，会是用户视图会全屏显示。如下(相当难看)

   
   
   image
2. getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS) ： 这个标签会将status设为半透明，在高版本机型中是半透明形式显示，但在低版本中是全透明(通常用于适配低版本手机)。笔者测试小米5.0是全透明显示。
3. DecorView的结构，上面多次用到DecorView，那么DecorView的结构是如何的呢？我们通过以下代码找出其结构关系

    private void printView(ViewGroup viewGroup) {
        Log.d(TAG, "printView: viewgroup:" + viewGroup.getClass().getSimpleName());

        for (int i = 0; i < viewGroup.getChildCount(); i++) {
            View childView = viewGroup.getChildAt(i);
            Log.d(TAG, "printView: childView:" + childView.getClass().getSimpleName());
        }

        for (int i = 0; i < viewGroup.getChildCount(); i++) {
            View childView = viewGroup.getChildAt(i);
            if (childView instanceof ViewGroup) {
                printView((ViewGroup) childView);
            }
        }
    }

    // onCreate()中调用
    printView((ViewGroup)getWindow().getDecorView());
    
    // 打印日志如下
    printView: viewgroup:DecorView
    printView: childView:LinearLayout
    printView: viewgroup:LinearLayout
    printView: childView:ViewStub
    printView: childView:FrameLayout
    printView: viewgroup:FrameLayout
    printView: childView:FitWindowsLinearLayout
    printView: viewgroup:FitWindowsLinearLayout
    printView: childView:ViewStubCompat
    printView: childView:ContentFrameLayout
    printView: viewgroup:ContentFrameLayout
    printView: childView:View
    printView: childView:LinearLayout
    printView: viewgroup:LinearLayout
    printView: childView:Toolbar
    printView: viewgroup:Toolbar
    printView: childView:AppCompatTextView

根据打印日志画出DecorView的结构图，如下：

image

在设置透明状态栏的方法中，我们用下面方法找到的布局属于那一层呢？

            ViewGroup systemContent = findViewById(android.R.id.content);
            ViewGroup userContent = (ViewGroup) systemContent.getChildAt(0);

一样用日志打出

            Log.d(TAG, "addToolbarTransparent: systemContent / " + systemContent.getClass().getSimpleName());
            Log.d(TAG, "addToolbarTransparent: userContent / " + userContent.getClass().getSimpleName());
            // 输出日志如下
            addToolbarTransparent: systemContent / ContentFrameLayout
            addToolbarTransparent: userContent / LinearLayout

systemContent对应ContentFrameLayout，而userContent对应LinearLayout，userContent的布局取决于你注入的布局文件的父布局，通过这些关系我们可以得出我们第二种方法的思路是 将ContentFrameLayout下的View设为透明，然后添加自定义View StatusView代替它。且userContent.setFitSystemWindow(true)表示的就是为View预留空间。
参考文章中有一个方法实现是在userContent层添加StatusView，经过以下分析，如果注入的布局最外层不是LinearLayout的话，会达不到我们想要的效果，所以应该在systemtContent添加。
示例代码传送门：github地址

参考 关于Android状态栏开发那几件事