Jetpack Compose API35应用状态栏无法透明问题求助

问题原因 #

你当前调用enableEdgeToEdge时使用的SystemBarStyle.light(Color.TRANSPARENT, Color.TRANSPARENT)逻辑不符合预期：light风格是针对状态栏文字为深色的场景，传入的参数是内容与状态栏重叠时的遮罩色，并非直接设置状态栏背景。再加上页面根布局用windowInsetsPadding(WindowInsets.statusBars)让内容避开状态栏区域，反而暴露了系统默认的白色状态栏背景。

修复方案 #

1. 正确配置enableEdgeToEdge #

改用SystemBarStyle.auto自动适配，或明确设置透明背景+对应文字颜色：

enableEdgeToEdge(
    statusBarStyle = SystemBarStyle.auto(
        lightScrim = Color.TRANSPARENT,
        darkScrim = Color.TRANSPARENT
    )
)

如果需要固定状态栏文字为深色，可直接使用：

enableEdgeToEdge(
    statusBarStyle = SystemBarStyle.dark(Color.TRANSPARENT)
)

2. 调整布局Insets处理（按需选择） #

• 若要实现沉浸式（内容延伸到状态栏下方）：去掉windowInsetsPadding(WindowInsets.statusBars)，改用占位符预留状态栏高度：

Column(
    modifier = Modifier.fillMaxSize()
) {
    // 预留状态栏高度的空白占位
    Spacer(modifier = Modifier.windowInsetsTopHeight(WindowInsets.statusBars))
    val tabIndex = aboutUsViewModel.tabIndex.observeAsState()
    TabRow(selectedTabIndex = tabIndex.value!!) {
        // Tab内容
    }
}

• 若仍要让内容避开状态栏：需配合主题配置确保系统状态栏背景完全透明。

3. 检查主题配置 #

在主题文件（themes.xml或Theme.kt）中，确保主题继承无ActionBar的Material3主题，且设置状态栏透明：

<style name="Theme.YourApp" parent="Theme.Material3.DayNight.NoActionBar">
    <!-- 其他主题配置 -->
    <item name="android:statusBarColor">@android:color/transparent</item>
</style>

4. 版本兼容性检查 #

确保使用的Compose版本为1.5.0及以上，适配Android 14（API 35）的系统栏处理逻辑。

验证 #

完成修改后重新运行应用，状态栏即可变为透明，布局可按需求选择是否延伸至状态栏区域。

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