Android 15如何动态设置导航栏颜色并适配深色模式？

Question

在Android 15中，如何动态设置导航栏颜色并适配深色模式？ 开发过程中，我们常需根据主题或用户操作动态调整导航栏颜色，同时确保深色模式下的视觉一致性。直接使用 `WindowCompat.setNavigationBarColor()` 可设置颜色，但深色模式下可能因系统自动调整导致显示异常。如何结合 `UI_MODE_NIGHT_YES` 或 `UI_MODE_NIGHT_NO`，通过代码判断当前模式，并正确应用适配的导航栏颜色？此外，在某些设备上，导航栏透明度或与手势导航冲突的问题该如何解决？这些问题直接影响用户体验，亟需最佳实践方案。

Answer 1

1. 了解动态设置导航栏颜色的基本方法

在Android开发中，动态调整导航栏颜色是常见的需求。通过`WindowCompat.setNavigationBarColor()`方法，可以实现对导航栏颜色的直接设置。以下是一个简单的代码示例：

WindowCompat.setNavigationBarColor(window, ContextCompat.getColor(context, R.color.nav_bar_color));

然而，这种方法在深色模式下可能会因为系统自动调整而导致显示异常。因此，我们需要进一步优化适配逻辑。

1.1 判断当前主题模式

可以通过`UI_MODE_NIGHT_YES`或`UI_MODE_NIGHT_NO`来判断当前设备是否处于深色模式。以下是具体的实现代码：

int currentNightMode = context.getResources().getConfiguration().uiMode & Configuration.UI_MODE_NIGHT_MASK;
boolean isDarkMode = currentNightMode == Configuration.UI_MODE_NIGHT_YES;

通过上述代码，我们可以准确判断当前设备的主题模式，并据此选择合适的导航栏颜色。

2. 深色模式下的适配策略

为了确保深色模式下的视觉一致性，需要结合主题模式动态设置导航栏颜色。以下是一个完整的适配流程：

1. 获取当前主题模式。
2. 根据主题模式选择对应的导航栏颜色。
3. 调用`WindowCompat.setNavigationBarColor()`应用颜色。

具体代码如下：

if (isDarkMode) {
    WindowCompat.setNavigationBarColor(window, ContextCompat.getColor(context, R.color.nav_bar_dark));
} else {
    WindowCompat.setNavigationBarColor(window, ContextCompat.getColor(context, R.color.nav_bar_light));
}

2.1 解决透明度问题

某些设备上，导航栏可能默认带有透明效果，这会导致背景与内容层重叠的问题。为解决此问题，可以通过设置`FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS`标志位来强制绘制导航栏背景：

window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION);

3. 手势导航冲突的处理

在使用手势导航的设备上，导航栏的颜色设置可能会被系统忽略，导致视觉不一致。为解决这一问题，可以尝试以下方法：

• 使用`WindowInsetsControllerCompat`控制手势导航的行为。
• 确保导航栏颜色与手势导航区域的颜色保持一致。

以下是相关代码示例：

WindowInsetsControllerCompat controller = new WindowInsetsControllerCompat(window, window.getDecorView());
controller.setAppearanceLightNavigationBars(!isDarkMode);

3.1 最佳实践总结

为确保用户体验的一致性，建议在应用初始化时完成导航栏颜色的适配，并在主题切换时重新应用颜色。以下是一个流程图展示适配逻辑：

            graph TD
                A[开始] --> B{是否深色模式？};
                B -- 是 --> C[设置深色导航栏颜色];
                B -- 否 --> D[设置浅色导航栏颜色];
                C --> E[检查手势导航];
                D --> E;
                E --> F[结束];
        

4. 综合案例分析

以下表格展示了不同场景下的适配结果：

场景	深色模式	导航栏颜色	手势导航兼容
普通主题切换	开启	#000000	支持
透明导航栏	关闭	#FFFFFF	部分支持
手势导航冲突	开启	#000000	完全支持