如何解决Android Activity系统导航栏无法设为黑色的问题？

问题详情 #

要创建新Activity并将系统导航栏设为黑色，目标效果：

当前配置：

Manifest配置 #

<activity
    android:name=".activity.MyActivity"
    android:exported="false"
    android:theme="@style/AppTheme.NoActionBar" />

styles.xml配置 #

<style name="AppTheme.NoActionBar" parent="Theme.AppCompat.Light.DarkActionBar">
    <item name="windowActionBar">false</item>
    <item name="windowNoTitle">true</item>
    <item name="android:navigationBarColor">@color/colorBlack</item>
    <item name="android:windowTranslucentNavigation">false</item>
</style>

实际效果不符合预期：

已尝试代码设置仍无效：

window.navigationBarColor = getColor(R.color.colorBlack)

解决方案 #

试试下面这几个方法，按顺序尝试大概率能解决：

1. 替换为AppCompat兼容属性 #

你使用的是AppCompat主题，原生带android:前缀的navigationBarColor可能不生效，换成AppCompat的兼容属性：

<style name="AppTheme.NoActionBar" parent="Theme.AppCompat.Light.DarkActionBar">
    <item name="windowActionBar">false</item>
    <item name="windowNoTitle">true</item>
    <!-- 移除android:前缀，使用兼容属性 -->
    <item name="navigationBarColor">@color/colorBlack</item>
    <item name="android:windowTranslucentNavigation">false</item>
</style>

2. 确认颜色资源为完全不透明的黑色 #

检查res/values/colors.xml中colorBlack的定义，必须包含不透明的alpha通道：

<color name="colorBlack">#FF000000</color>

如果只写#000000，alpha通道默认透明，会导致导航栏显示半透明效果。

3. 代码中添加系统栏绘制标记 #

在Activity的onCreate方法中补充以下代码，确保窗口有权限绘制系统栏背景：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 开启窗口绘制系统栏背景的标记
    window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS)
    // 清除透明导航栏标记，避免冲突
    window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION)
    // 使用ContextCompat兼容低版本Android
    window.navigationBarColor = ContextCompat.getColor(this, R.color.colorBlack)
    setContentView(R.layout.activity_my)
}

4. 排查主题覆盖问题 #

检查Activity对应的布局文件中是否设置了android:fitsSystemWindows="true"，该属性可能影响系统栏的显示；同时确认没有第三方库、父主题或其他配置覆盖了导航栏的颜色设置。

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