为何isAppearanceLightStatusBars无法通过代码修改状态栏内容颜色？

可能原因 #

1. 调用时机过早：在onCreate中设置时，窗口的WindowInsetsController可能尚未完全绑定到decorView，导致设置无法生效。此时主题中定义的属性会在后续生命周期阶段覆盖代码设置的值。
2. WindowCompat.setDecorFitsSystemWindows的影响：当设置该方法为false后，布局会延伸至系统栏区域，若decorView未完成初始化，直接调用ViewCompat.getWindowInsetsController可能返回null，导致设置代码不执行。

解决方案 #

方案1：延迟设置，确保decorView初始化完成 #

将状态栏内容颜色的设置逻辑放在decorView的post回调中，确保视图已完成初始化：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_splash_screen)
    WindowCompat.setDecorFitsSystemWindows(window, false)

    window.decorView.post {
        val controller = ViewCompat.getWindowInsetsController(window.decorView)
        controller?.isAppearanceLightStatusBars = true
    }
}

方案2：调整设置时机到onStart或onResume #

将设置逻辑移至onStart或onResume生命周期方法中，此时窗口状态已稳定：

override fun onStart() {
    super.onStart()
    val controller = ViewCompat.getWindowInsetsController(window.decorView)
    controller?.isAppearanceLightStatusBars = true
}

方案3：使用setSystemBarsAppearance方法显式设置 #

替代直接赋值isAppearanceLightStatusBars，使用setSystemBarsAppearance方法显式设置状态栏外观，兼容性更可靠：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_splash_screen)
    WindowCompat.setDecorFitsSystemWindows(window, false)

    window.decorView.post {
        val controller = ViewCompat.getWindowInsetsController(window.decorView)
        controller?.setSystemBarsAppearance(
            WindowInsetsController.APPEARANCE_LIGHT_STATUS_BARS,
            WindowInsetsController.APPEARANCE_LIGHT_STATUS_BARS
        )
    }
}

额外注意事项 #

• 确保设备系统版本在API 23及以上（isAppearanceLightStatusBars和android:windowLightStatusBar均从API 23开始支持）。
• 若状态栏背景为透明，需确保布局顶部有足够的内边距或避开状态栏区域，避免内容重叠导致状态栏颜色变化不明显。

内容的提问来源于stack exchange，提问作者Abdelillah