Android开发-状态栏着色原理和API版本兼容处理

Posted 2020-09-04 李可乐

介绍

先上实际效果图，有三个版本请注意区分API版本

API>=20	API=19	API<19

以上的效果我们称之为对状态栏的着色，而非沉浸式状态栏，那是另外的东西。
想要实现以上的效果并不难，阅读本文了解原理后，就会觉得想要以上的效果真的很简单。
本文旨在总结我的理解告诉读者一步步实现状态栏着色的原理。

原理

第一步-设置透明状态栏

对状态栏的控制一切基础都源于

    static public void setTranslucentWindows(Activity activity) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
            //透明状态栏
            activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
        }
    }

请注意该Flag标识的API版本为19，也就是只能在API>=19以上实现透明状态栏，这就是上文效果图用API区分的原因。

注：以下style样式同上代码，但是有兼容问题，建议直接使用代码设置
<item name="android:windowTranslucentStatus">true</item>

第二步-padding出预留空间

设置透明状态栏之后，内容会顶到屏幕顶部会和状态栏中的内容重叠。

就需要设置padding出和状态栏相同的高度，防止重叠
有两种解决方法：

1. XML中设置：对某个View设置android:fitsSystemWindows="true"（API+14）系统布局时自动找到最外层的View设置paddingTop

2. 代码控制：确定状态栏高度然后给需要View设置paddingTop的值

在XML中直接设置属性比较简单，但是有局限性，只对最外层View有效，如果是Fragment的View视图中设置fitsSystemWindows然后被添加到屏幕上无效。
代码控制，能够解决Fragment的问题，但是确定状态栏高度有点麻烦，一般来说状态栏高度都是24dp，保险起见还是需要读取系统的配置高度，还有设置padding有时也会失效，就需要handler.post(new Runnable())来保证代码的执行

读取系统配置的状态栏高度代码：

    /**
     * 19API以上 读取到状态栏高度才有意义
     *
     * @param context
     * @return
     */
    static public int getStatusBarHeight(Context context) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
            int resourceId = context.getResources().getIdentifier("status_bar_height", "dimen", "android");
            return resourceId > 0 ? context.getResources().getDimensionPixelSize(resourceId) : 0;
        } else {
            return 0;
        }
    }

第三步-着色

这里先说明前两步的结果;

• API<19：不执行
• API=19：黑灰渐进透明的状态栏
• API>=20：系统会自动生成一个半透明的状态栏

所以就需要我们对第二步中产生的预留空间设置颜色，同样有两种方法：

1. 添加View：对整个视图的父容器FrameLayout（ID=android.R.id.content）添加一个状态栏高度带有颜色的View，覆盖到状态栏。
2. 自动渲染：对设置了paddingTop的控件，设置背景色，当该控件被padding处理时，颜色也同时渲染到了状态栏中。

添加覆盖状态栏View的代码：

    /**
     * 设置状态栏颜色为App主色
     * 配合{@link #setTranslucentWindows(Activity)}方法使用
     * 主要方法为添加一个View并设置背景色添加到系统contentView中
     *
     * @param activity
     */
    static public void addStatusBarBackground(Activity activity) {
        int height;
        height = getStatusBarHeight(activity);
        if (height <= 0) {
            return;
        }
        FrameLayout layout = (FrameLayout) activity.findViewById(android.R.id.content);
        FrameLayout statusLayout = new FrameLayout(activity);
        statusLayout.setLayoutParams(new LinearLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, height));

        TypedValue typedValue = new TypedValue();
        TypedArray a = activity.obtainStyledAttributes(typedValue.data, new int[]{R.attr.colorPrimary});
        int color = a.getColor(0, 0);
        a.recycle();
        statusLayout.setBackgroundColor(color);
        layout.addView(statusLayout);
    }

特殊的API21+

当API21+：能够调用系统API直接对状态栏着色
if(Build.VERSION.SDK_INT>=Build.VERSION_CODES.LOLLIPOP){
    this.getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
    this.getWindow().setStatusBarColor(ContextCompat.getColor(this,R.color.red_normal));
}

总结

实现状态栏着色并不复杂，只需要三步，真正使用时其实就是几行代码或者几个方法调用。但是在实际使用中需要考虑实际需求，兼容问题。搭配使用每一步的使用就能实现我们想要的效果。

如上文的效果图实现就是：Activity状态栏透明，导航搜索栏View背景色透明paddingTop状态栏高度，覆盖在图片之上，而图片没有任何控制。