Android 状态栏沉浸式适配（基于Android M，适配异形屏）

前言

我们都知道，世界有多大，设计稿就有多奇葩。为了UI的完美效果，通常情况下都会涉及到状态栏的修改操控，而状态栏的修改分为两种方式，一种是动态代码，一种是style实现，为了方便使用，本文仅介绍通过动态代码对状态栏进行隐藏、透明、内容变色，文末会带有一个工具类直接提供使用，以满足各位奇葩设计稿的要求。希望大家看完之后可以写出更美观的UI，老板看到满意，用户看到喜欢，最终升职加薪，哈哈，xswl

Android状态栏小知识

一个界面的展示是由Window负责的，而在一个Window内包含一个顶级View叫DecorView，DecorView分为actionbar和contentview两部分，这里就不画图了，actionBar就是状态栏和Title部分，contentview是我们在xml写的内容部分，如果需要调整状态栏，我们通过decorView.systemUiVisibility调整actionBar即可，需要注意的是我们对状态栏的调整需要在setContentView之前进行哦

隐藏状态栏

隐藏状态栏的话我们将decorView.systemUiVisibility的值设置为View.SYSTEM_UI_FLAG_FULLSCREEN or View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN，也就是全屏，即可达到想要的效果

/**
     * 隐藏状态栏
     */
    fun hideStatusBar(window: Window) {
        window.decorView.systemUiVisibility =
            View.SYSTEM_UI_FLAG_FULLSCREEN or View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
//                window.addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN)
        //适配一些特殊屏幕，比如刘海屏，水滴屏等
        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.P) {
            return
        }
        val lp = window.attributes
        lp.layoutInDisplayCutoutMode =
            WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
        window.attributes = lp
    }

状态栏透明

状态栏透明也很简单，但是这一次是直接修改Window的statusBarColor，言简意赅，直接将值设置为Color.TRANSPARENT就能达到想要的效果，但是光状态栏透明是不够的，光状态栏透明只会显示Window的背景色，因此我们还需要将内容拓展到状态栏

//支持绘制状态栏背景（好像不写也行，但是查阅各方资料都有这个）
window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS)
window.statusBarColor = Color.TRANSPARENT

内容拓展到状态栏

这个也很好理解，这就是我们实现UI中的内容拓展到状态栏，只需要将window.decorView.systemUiVisibility添加View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN标签就可以成功

window.decorView.systemUiVisibility = window.decorView.systemUiVisibility or View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN

状态栏内容颜色适配

Android仅支持状态栏内容在深色和浅色之间调节，不过通常情况下深色和浅色够我们适配所有情况了

if (isDark) {
    //设置深色内容颜色
    window.decorView.systemUiVisibility = window.decorView.systemUiVisibility or View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR
} else {
    //设置浅色内容颜色
    window.decorView.systemUiVisibility = window.decorView.systemUiVisibility or View.SYSTEM_UI_FLAG_LAYOUT_STABLE
}

内容已完结，最后是答应大家的工具类，直接恰饭

为了大家方便使用，我直接将工具类代码贴上来

import android.graphics.Color
import android.os.Build
import android.view.View
import android.view.Window
import android.view.WindowManager
import com.star.xsb.application.DylyApplication

/**
 * Create：DD_Z
 * CreateDate：2021/9/10 15:49
 * Description：暂未填写
 **/
object StatusBarUtils {
    fun getStatusBarHeight(): Float {
        val resourceId =
            DylyApplication.context.resources.getIdentifier("status_bar_height", "dimen", "android")
        return DylyApplication.context.resources.getDimension(resourceId)
    }

    /**
     * 隐藏状态栏
     */
    fun hideStatusBar(window: Window) {
        window.decorView.systemUiVisibility =
            View.SYSTEM_UI_FLAG_FULLSCREEN or View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
//                window.addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN)
        //适配一些特殊屏幕，比如刘海屏，水滴屏等
        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.P) {
            return
        }
        val lp = window.attributes
        lp.layoutInDisplayCutoutMode =
            WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
        window.attributes = lp
    }

    /**
     * @param windowFullScreen 窗口内容全屏至状态栏，一般配合[barBackgroundColor = Color.TRANSPARENT]使用
     * @param barContentDark 文字深色
     * @param barBackgroundColor 状态栏背景颜色，如果[windowFullScreen == true]将会自动设置为[Color.TRANSPARENT]
     *
     */
    fun setStatusBarStyle(
        window: Window,
        windowFullScreen: Boolean,
        barContentDark: Boolean,
        barBackgroundColor: Int
    ) {
        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) {
            return
        }
        var systemUiVisibility = 0
        if (barContentDark) {
            //设置深色内容颜色
            systemUiVisibility = systemUiVisibility or View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR
        } else {
            //设置浅色内容颜色
            systemUiVisibility = systemUiVisibility or View.SYSTEM_UI_FLAG_LAYOUT_STABLE
        }
        //设置全屏化
        if (windowFullScreen) {
            systemUiVisibility = systemUiVisibility or View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
        }
        window.decorView.systemUiVisibility = systemUiVisibility
        //支持绘制状态栏背景
        window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS)
        //设置状态栏背景颜色(如果窗口拓展到状态栏的话必须要设置透明，否则显示上会出问题)
        if (windowFullScreen) {
            window.statusBarColor = Color.TRANSPARENT
        } else {
            window.statusBarColor = barBackgroundColor
        }
    }
}

最后我还有一句话要说：

早知如此绊人心，何如当初莫相识

《秋风词》李白