如何在Jetpack Compose应用中实现可下拉唤起状态栏的全屏模式

问题根源 #

你用enableEdgeToEdge()后，系统会将状态栏设为透明，但窗口布局并未完全延伸到状态栏区域；当你隐藏状态栏后，原状态栏位置就会出现黑块。要实现真正的全屏，得调整窗口布局参数，同时正确配置Insets控制器。

正确代码实现 #

1. Activity窗口配置 #

替换原有代码，移除enableEdgeToEdge()，改用以下配置：

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 设置窗口全屏，移除状态栏/导航栏占位
        window.setFlags(
            WindowManager.LayoutParams.FLAG_FULLSCREEN,
            WindowManager.LayoutParams.FLAG_FULLSCREEN
        )
        
        val insetsController = WindowCompat.getInsetsController(window, window.decorView)
        insetsController.apply {
            // 隐藏状态栏和导航栏
            hide(WindowInsetsCompat.Type.systemBars())
            // 设置行为：下拉临时显示系统栏，松手后自动隐藏
            systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
        }

        setContent {
            FullScreenDemoTheme {
                // 处理Insets，避免下拉状态栏时内容被遮挡
                val systemUiController = rememberSystemUiController()
                // 可选：设置状态栏文字颜色，防止下拉时看不清
                systemUiController.setStatusBarColor(Color.Transparent, darkIcons = false)
                
                // 你的Compose内容，用fillMaxSize占满屏幕
                Box(
                    modifier = Modifier.fillMaxSize(),
                    contentAlignment = Alignment.Center
                ) {
                    Text(text = "全屏模式测试，下拉顶部唤起状态栏")
                }
            }
        }
    }
}

2. 关键说明 #

• window.setFlags(FLAG_FULLSCREEN, FLAG_FULLSCREEN)：让窗口真正全屏，彻底移除状态栏的占位区域，解决黑块问题。
• BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE：确保下拉时临时显示系统栏，松开后自动隐藏，完全匹配你的需求。
• rememberSystemUiController()：动态调整状态栏颜色，避免下拉时文字与背景冲突。
• 根Compose组件用Modifier.fillMaxSize()：保证内容占满整个屏幕空间。

额外注意事项 #

• 若需支持横竖屏切换，在Manifest中给Activity添加android:configChanges="orientation|screenSize"，避免切换时Activity重建导致全屏状态失效。
• 不同Android版本系统栏行为略有差异，但上述代码兼容Android 8.0及以上主流版本。

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