Android12 固定导航栏显示异常如何解决？

Question

在 Android 12 中，部分应用在使用固定导航栏（如底部导航栏或沉浸式模式适配不当）时，可能出现导航栏显示异常，例如：导航栏被状态栏遮挡、颜色显示不正确、无法固定显示或在某些操作后消失等问题。此类问题通常与系统 UI 控制方式变更、Insets API 的使用不当有关。如何在 Android 12 中正确适配固定导航栏，确保其稳定显示并避免与系统手势操作冲突？这是开发者在升级目标 SDK 至 31 后常遇到的关键技术难题。

Answer 1

Android 12 固定导航栏适配指南

1. Android 11 与 Android 12 的系统 UI 变化对比

Android 12（API 31）引入了新的系统 UI 控制机制，特别是对 Insets API 的更新，导致原本在 Android 11 中运行良好的导航栏适配逻辑可能失效。

特性	Android 11	Android 12
Insets API	使用 ViewCompat.setOnApplyWindowInsetsListener	推荐使用 WindowInsetsController 和 WindowInsetsCompat
沉浸式控制	主要通过 SYSTEM_UI_FLAG_HIDE_NAVIGATION	使用 WindowInsetsController#hide() 和 WindowInsetsController#show()
导航栏颜色	设置 navigationBarColor 即可生效	需结合 SYSTEM_UI_FLAG_LIGHT_NAVIGATION_BAR 和 ViewCompat.setOnApplyWindowInsetsListener

2. 常见问题与分析

• 问题一：导航栏被状态栏遮挡 —— 原因是未正确处理 WindowInsets，未为底部导航栏预留空间。
• 问题二：导航栏颜色显示异常 —— 可能是因为未设置 SYSTEM_UI_FLAG_LIGHT_NAVIGATION_BAR 或未适配深色模式。
• 问题三：导航栏无法固定显示 —— 通常是因为误用了沉浸式模式或手势操作监听冲突。
• 问题四：导航栏在某些操作后消失 —— 通常是系统 UI 自动隐藏机制触发，未正确监听和恢复导航栏状态。

3. 适配方案详解

1. 使用 WindowInsets API 处理系统边距
   在 onCreate() 中添加如下代码，确保底部导航栏不被遮挡：

   ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.root_view), (v, insets) -> {
       WindowInsetsCompat systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars());
       v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom);
       return insets;
   });

2. 控制导航栏的显示与隐藏
   使用 WindowInsetsController 来控制：

   WindowInsetsController controller = getWindow().getInsetsController();
   if (controller != null) {
       controller.hide(WindowInsetsCompat.Type.navigationBars());
       controller.setSystemBarsBehavior(WindowInsetsCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE);
   }

3. 保持导航栏常显
   在某些场景下需要固定显示导航栏，避免自动隐藏：

   getWindow().getDecorView().setSystemUiVisibility(
       View.SYSTEM_UI_FLAG_LAYOUT_STABLE
       | View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
       | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
   );

4. 沉浸式模式与手势操作兼容性处理

Android 12 强化了手势导航操作，沉浸式模式需与手势兼容，避免冲突。

graph TD A[用户进入全屏模式] --> B{是否启用沉浸式模式?} B -->|是| C[调用 hide(navigationBars)] B -->|否| D[保持导航栏常显] C --> E[用户滑动触发显示] E --> F[调用 show(navigationBars)] D --> G[监听系统 UI 变化] G --> H[使用 OnSystemUiVisibilityChangeListener]