Empty Views Activity创建的Activity未应用android:statusBarColor问题

核心结论 #

这个问题和「Empty Views Activity」预设自动生成的代码无关，问题出在Material Components DayNight主题的状态栏颜色配置逻辑上，以下是可行的解决步骤：

1. 使用Material专属属性替代原生属性 #

Material Components主题（尤其是DayNight变体）优先识别materialStatusBarColor属性，而非系统原生的android:statusBarColor。分别在themes.xml(light)和themes.xml(dark)中配置对应颜色：

<!-- 浅色模式主题 -->
<item name="materialStatusBarColor">@color/custom_light_status_bar</item>

<!-- 深色模式主题 -->
<item name="materialStatusBarColor">@color/custom_dark_status_bar</item>

2. 强制开启状态栏背景绘制 #

在主题中添加以下属性，确保系统允许自定义状态栏背景：

<item name="android:windowDrawsSystemBarBackgrounds">true</item>
<!-- 兼容API 21以下的设备，可选 -->
<item name="android:statusBarColor">@color/custom_status_bar</item>

3. 检查布局的fitsSystemWindows属性 #

如果Activity布局的根视图设置了android:fitsSystemWindows="false"，会阻止状态栏颜色生效，建议改为true：

<androidx.constraintlayout.widget.ConstraintLayout
    ...
    android:fitsSystemWindows="true">

4. 动态适配低版本API（可选） #

如果应用最低SDK版本低于21，可在Activity的onCreate方法中动态设置状态栏颜色：

Java #

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
    getWindow().setStatusBarColor(ContextCompat.getColor(this, R.color.custom_status_bar));
}

Kotlin #

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
    window.statusBarColor = ContextCompat.getColor(this, R.color.custom_status_bar)
}

5. 清理缓存并重建项目 #

Android Studio设计器和实际运行环境的缓存可能不一致，执行Build > Clean Project + Build > Rebuild Project后重新测试。

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