
Android 11 起,传统 SYSTEM_UI_FLAG 已失效,需改用 WindowInsetsController 实现真正的沉浸式全屏(隐藏状态栏和导航栏),并防止用户滑动唤出系统栏。
android 11 起,传统 `system_ui_flag` 已失效,需改用 `windowinsetscontroller` 实现真正的沉浸式全屏(隐藏状态栏和导航栏),并防止用户滑动唤出系统栏。
在 Android 11(API 30)及更高版本中,系统对用户体验与安全性进行了强化,旧版基于 View.setSystemUiVisibility() 的沉浸式模式(如 SYSTEM_UI_FLAG_IMMERSIVE_STICKY)已被弃用且不再可靠——用户轻扫屏幕边缘仍可临时呼出状态栏和导航栏,无法满足 Kiosk(数字标牌)、考试应用、自助终端等需要强管控场景的需求。
✅ 正确做法:使用 WindowInsetsController(自 Android R 引入,推荐搭配 WindowCompat 兼容低版本)
✅ 正确实现方式(Android 11+)
在 Activity 的 onCreate() 中(确保在 setContentView() 之后调用):
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
window.insetsController?.let { controller ->
controller.systemBarsBehavior = WindowInsetsController.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
// 完全隐藏状态栏 + 导航栏
controller.hide(WindowInsets.Type.statusBars() or WindowInsets.Type.navigationBars())
// 可选:禁用通过滑动恢复系统栏(关键!)
controller.systemBarsBehavior = WindowInsetsController.BEHAVIOR_HIDE_TRANSIENT_BARS_BY_SWIPE
}
} else {
// 兼容 Android 10 及以下(降级为传统沉浸式)
@Suppress("DEPRECATION")
window.decorView.systemUiVisibility = (
View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
or View.SYSTEM_UI_FLAG_LAYOUT_STABLE
or View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
or View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
or View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
or View.SYSTEM_UI_FLAG_FULLSCREEN
)
}
? 关键点说明:
Control iOS and Android devices through a deterministic CLI for agent-driven mobile testing and debugging with agent-device下载通过会话感知的CLI驱动真实的移动应用,使代理能够检查UI状态、确定性地操作,并在调试过程中收集日志、网络跟踪和性能证据。
BEHAVIOR_HIDE_TRANSIENT_BARS_BY_SWIPE是 Android 11+ 实现“防滑出”的核心设置,它阻止用户通过边缘滑动恢复系统栏;controller.hide(...)主动隐藏栏,配合该行为才能达到“真正不可见、不可触发”的效果;- 若仅调用
hide()而未设置BEHAVIOR_HIDE...,用户仍可滑动唤出(即你遇到的问题)。
⚠️ 注意事项
-
Kiosk 模式需额外配置:若需长期锁定(如设备管理员场景),仅 UI 隐藏不够,还需结合 Device Policy Controller 或
startLockTask()(需用户授权或设备管理员权限); -
手势导航兼容性:在启用手势导航的设备上,
navigationBars()隐藏后底部仍将保留约 24dp 的“手势提示条”(系统强制保留),此为 Android 设计规范,无法完全移除; -
返回键处理:隐藏导航栏后,物理/虚拟返回键失效,建议在应用内提供明确退出路径(如长按返回、双击退出),并监听
onBackPressed()做自定义控制; -
横竖屏切换:
WindowInsetsController状态不会自动恢复,建议在onConfigurationChanged()中重新应用隐藏逻辑。
✅ 推荐最佳实践(兼顾兼容性与可靠性)
使用 WindowCompat 封装兼容逻辑(需引入 androidx.core:core:1.10.0+):
WindowCompat.setDecorFitsSystemWindows(window, false)
WindowInsetsControllerCompat(window, window.decorView).apply {
hide(WindowInsetsCompat.Type.statusBars() or WindowInsetsCompat.Type.navigationBars())
systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_HIDE_TRANSIENT_BARS_BY_SWIPE
}
? 提示:
WindowInsetsControllerCompat自动桥接新旧 API,大幅简化适配代码,是当前 Jetpack 推荐方案。
综上,Android 11+ 必须转向 WindowInsetsController(或其兼容封装),并显式设置 BEHAVIOR_HIDE_TRANSIENT_BARS_BY_SWIPE,才能突破旧方案的限制,实现接近“真全屏”的强管控体验。











