Android应用隐藏导航栏问题求助：现有代码相关疑问

看起来你正在尝试实现全屏隐藏导航栏的功能，但代码似乎没写完，而且针对不同Android版本的适配可能还有遗漏。我来帮你梳理下常见问题和优化后的实现：

你的现有代码分析 #

你已经区分了Android 19（KitKat）前后的处理逻辑，但在高版本（Android 11及以上）系统中，SYSTEM_UI_FLAG_HIDE_NAVIGATION这类旧Flag已经被废弃，需要改用WindowInsetsController来处理系统UI的显示隐藏。另外，旧方法中很容易遇到“导航栏隐藏后，用户触摸屏幕就重新弹出”的痛点，这也是很多开发者踩过的坑。

优化后的完整实现 #

下面是适配从Android 4.0到最新版本的全屏隐藏导航栏（可选择同时隐藏状态栏）的代码：

public class Initer {
    public static void fullScreen(Window window) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            // Android 11及以上使用WindowInsetsController API
            WindowInsetsController insetsController = window.getInsetsController();
            if (insetsController != null) {
                // 隐藏导航栏
                insetsController.hide(WindowInsets.Type.navigationBars());
                // 可选：同时隐藏状态栏
                insetsController.hide(WindowInsets.Type.statusBars());
                // 设置行为：仅当用户从屏幕边缘滑动时才临时显示导航栏，触摸其他区域不会弹出
                insetsController.setSystemBarsBehavior(WindowInsetsController.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE);
            }
        } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
            // Android 4.4到Android 10的兼容处理
            View decorView = window.getDecorView();
            int uiOptions = View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
                    | View.SYSTEM_UI_FLAG_FULLSCREEN
                    | View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY;
            decorView.setSystemUiVisibility(uiOptions);
        } else {
            // Android 4.4以下的旧版本处理
            window.setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,
                    WindowManager.LayoutParams.FLAG_FULLSCREEN);
        }
    }
}

关键细节说明 #

• Android 11+适配核心：WindowInsetsController是官方推荐的新API，BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE设置能让导航栏保持隐藏状态，只有用户主动从边缘滑动才会临时显示，几秒后自动隐藏。
• Android 4.4-10适配核心：SYSTEM_UI_FLAG_IMMERSIVE_STICKY是解决“触摸弹出导航栏”的关键，它让导航栏隐藏后，用户短暂触摸只会显示半透明的临时导航栏，不会永久停留。如果需要触摸后导航栏一直显示，可以换成SYSTEM_UI_FLAG_IMMERSIVE，但需要手动再次调用隐藏方法。
• 额外注意点：如果页面包含滚动控件（如RecyclerView、ScrollView），滚动操作可能触发系统UI自动显示，建议在Activity的onResume方法中重新调用全屏方法，或者在控件的滚动监听中补充处理。

常见问题排查 #

• 导航栏隐藏后自动弹出：检查是否添加了IMMERSIVE_STICKY（Android 10及以下）或设置了正确的SystemBarsBehavior（Android 11+）。
• 高版本Android上失效：务必使用WindowInsetsController，旧Flag在Android 11+已不再生效。
• 状态栏和导航栏不同时隐藏：确认代码中同时处理了navigationBars()和statusBars()（Android 11+），或同时添加了SYSTEM_UI_FLAG_FULLSCREEN与SYSTEM_UI_FLAG_HIDE_NAVIGATION（旧版本）。

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