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

Posted 2020-10-01 yangykaifa

介绍

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

API>=20	API=19	API<19

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

原理

第一步-设置透明状态栏

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

    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状态栏高度，覆盖在图片之上，而图片没有不论什么控制。