告别刘海屏适配烦恼：用Jetpack Compose的SystemUiController搞定沉浸式状态栏（附完整代码）

Jetpack Compose沉浸式状态栏实战：从刘海屏适配到厂商定制系统兼容

每次看到设计稿上那个"状态栏透明+内容全屏显示"的标注，作为Android开发者的你是不是已经开始头疼了？不同厂商的定制系统、各种刘海屏水滴屏的异形切割，还有Android版本碎片化带来的兼容性问题，让这个看似简单的需求变成了开发路上的"拦路虎"。今天我们就用Jetpack Compose的SystemUiController和ProvideWindowInsets，一劳永逸地解决这些适配难题。

1. 沉浸式状态栏的进化之路

还记得早期Android开发中那个被滥用的setSystemUiVisibility()吗？这个方法在API 30已经被正式废弃，标志着Android界面适配进入了新时代。传统View系统下，我们需要：

// 传统View系统的实现方式（已过时）
window.decorView.systemUiVisibility = (
    View.SYSTEM_UI_FLAG_LAYOUT_STABLE
    or View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
)
window.statusBarColor = Color.TRANSPARENT

这种写法存在几个致命缺陷：

• 无法感知实际插入区域（insets）
• 与手势导航容易产生冲突
• 在不同厂商ROM上表现不一致

Jetpack Compose带来的SystemUiController和ProvideWindowInsets组合，提供了更声明式的解决方案。核心优势在于：

三大技术支柱对比

2. 基础搭建：透明状态栏四步曲

让我们从零开始构建一个可靠的沉浸式状态栏实现。首先确保在build.gradle中添加必要依赖：

// build.gradle.kts
dependencies {
    implementation("com.google.accompanist:accompanist-systemuicontroller:0.30.1")
    implementatio