Expo AndroidNavigationBar生产构建失效问题求助

可能的原因及修复方案 #

1. 清理构建缓存并确认配置完整性 #

生产构建时常会因为缓存残留导致配置未生效：

• 执行缓存清理命令：如果是Expo项目用expo r -c，原生React Native项目则运行./gradlew clean
• 检查打包脚本或构建流程，确保app.json的androidNavigationBar配置在生产构建时没有被覆盖或忽略

2. 补充主动设置沉浸式的代码逻辑 #

仅依赖app.json配置在部分生产环境中可能不稳定，建议在代码中主动设置：

• Expo项目可使用expo-navigation-bar库，在App启动时初始化：

  import * as NavigationBar from 'expo-navigation-bar';
  import { useEffect } from 'react';
  
  useEffect(() => {
    const setupImmersiveNav = async () => {
      await NavigationBar.setBehaviorAsync('immersive');
    };
    setupImmersiveNav();
  }, []);
  

• 原生React Native项目，在MainActivity.java的onCreate方法中添加原生层设置：

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    getWindow().getDecorView().setSystemUiVisibility(
      View.SYSTEM_UI_FLAG_HIDE_NAVIGATION |
      View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
    );
  }
  

3. 排查系统版本与ROM兼容性 #

• 沉浸式模式仅支持Android 4.4（API 19）及以上版本，确认目标设备系统版本达标
• 部分国产定制ROM会修改系统UI逻辑，建议在不同品牌设备上测试验证

4. 检查是否有代码覆盖导航栏设置 #

排查项目中是否存在第三方库或自定义代码，无意中修改了系统UI可见性状态，比如某些全屏组件、权限请求逻辑可能会重置导航栏配置。

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