如何在Kotlin Multiplatform中强制三星设备状态栏透明

问题现象 #

应用在Pixel 7及Android 7.0/9.0/14.0/15.0/16.0模拟器上状态栏可正常透明，但三星Galaxy S23 Ultra（Android 14）设备上状态栏显示为黑色，且该设备其他应用状态栏透明正常。

核心原因 #

代码中**enableEdgeToEdge()和SystemAppearance**的状态栏设置存在冲突，叠加三星One UI的定制化逻辑，导致状态栏颜色被强制覆盖为黑色：

• enableEdgeToEdge()通过Jetpack Compose的系统栏API统一管理样式，后续SystemAppearance中直接修改window.statusBarColor的操作，在One UI下可能被系统默认行为或enableEdgeToEdge的后续处理覆盖。
• 三星One UI对系统栏对比度有特殊定制，直接设置透明色可能被系统替换为黑色以保证可读性。

解决方案 #

方案1：统一使用enableEdgeToEdge管理系统栏（推荐） #

移除SystemAppearance中直接操作窗口状态栏颜色和setDecorFitsSystemWindows的代码，完全通过enableEdgeToEdge配置透明效果：

修改MainActivity的enableEdgeToEdge调用，同步主题的深色/浅色模式：

// MainActivity.kt
val darkTheme = isSystemInDarkTheme()
enableEdgeToEdge(
    statusBarStyle = if (darkTheme) {
        SystemBarStyle.dark(Color.TRANSPARENT)
    } else {
        SystemBarStyle.light(Color.TRANSPARENT, Color.TRANSPARENT)
    },
    navigationBarStyle = if (darkTheme) {
        SystemBarStyle.dark(Color.TRANSPARENT)
    } else {
        SystemBarStyle.light(Color.TRANSPARENT, Color.TRANSPARENT)
    }
)

精简SystemAppearance，仅保留必要的图标亮度和挖孔屏设置：

@Composable
actual fun SystemAppearance(isDark: Boolean) {
    val view = LocalView.current
    
    if (!view.isInEditMode) {
        SideEffect {
            val window = (view.context as Activity).window
            val controller = WindowCompat.getInsetsController(window, window.decorView)
            
            // 控制状态栏/导航栏图标亮度
            controller.isAppearanceLightStatusBars = !isDark
            controller.isAppearanceLightNavigationBars = !isDark
            
            if (Build.VERSION.SDK_INT >= 28) {
                window.attributes.layoutInDisplayCutoutMode = android.view.WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
            }
            
            if (Build.VERSION.SDK_INT >= 29) {
                window.isStatusBarContrastEnforced = false
                window.isNavigationBarContrastEnforced = false
            }
        }
    }
}

方案2：禁用enableEdgeToEdge，手动控制全流程 #

如果坚持手动设置，移除enableEdgeToEdge调用，添加三星设备的特殊处理逻辑：

@Composable
actual fun SystemAppearance(isDark: Boolean) {
    val view = LocalView.current
    val colorScheme = MaterialTheme.colorScheme
    
    if (!view.isInEditMode) {
        SideEffect {
            val window = (view.context as Activity).window
            
            WindowCompat.setDecorFitsSystemWindows(window, false)
            
            val controller = WindowCompat.getInsetsController(window, window.decorView)
            controller.isAppearanceLightStatusBars = !isDark
            controller.isAppearanceLightNavigationBars = !isDark
            
            if (Build.VERSION.SDK_INT >= 28) {
                window.attributes.layoutInDisplayCutoutMode = android.view.WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
            }
            
            // 强制设置透明色
            window.statusBarColor = Color.Transparent.toArgb()
            window.navigationBarColor = if (Build.VERSION.SDK_INT <= 25) colorScheme.primaryContainer.toArgb() else Color.Transparent.toArgb()
            
            if (Build.VERSION.SDK_INT >= 29) {
                window.isStatusBarContrastEnforced = false
                window.isNavigationBarContrastEnforced = false
            }
            
            // 三星设备额外处理：绕过系统强制对比度逻辑
            if (Build.MANUFACTURER.equals("samsung", ignoreCase = true)) {
                try {
                    val field = window.javaClass.getDeclaredField("mStatusBarColor")
                    field.isAccessible = true
                    field.set(window, Color.Transparent.toArgb())
                    window.decorView.postInvalidate()
                } catch (e: Exception) {
                    e.printStackTrace()
                }
            }
        }
    }
}

额外注意事项 #

• 确保Compose组件通过Modifier.systemBarsPadding()或WindowInsetsAPI处理系统栏Insets，避免内容被状态栏遮挡。
• 三星One UI部分版本会强制启用状态栏对比度，window.isStatusBarContrastEnforced = false必须设置才能保证透明生效。

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