Edge to Edge模式下Android状态栏闪烁及颜色异常问题

我刚在新Android项目中完成了Edge2Edge模式配置，整体运行正常，但应用启动时状态栏会出现明显的完全不可见阶段：

• 显示应用Logo时状态栏正常显示：
  
• 随后一段时间状态栏完全或几乎不可见：
  
• 最终状态栏恢复显示：
  

遇到两个核心问题：
a) 状态栏出现闪烁，依次经历显示、消失、再显示的过程。
b) 状态栏颜色接近白色应用背景，但并非完全白色。

相关代码 #

MainActivity.kt

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        enableEdgeToEdge()

        setContent {
            NewToGetThemesTheme {
                // 使用主题中的背景色的Surface容器
                Surface(
                    modifier = Modifier.fillMaxSize().safeDrawingPadding(),
                    color = MaterialTheme.colorScheme.background,

                ) {
                    Greeting("Android")
                }
            }
        }
    }
}

Theme.kt（已注释副作用代码）

private val DarkColorScheme = darkColorScheme(
    primary = Purple80,
    secondary = PurpleGrey80,
    tertiary = Pink80
)

private val LightColorScheme = lightColorScheme(
    primary = Purple40,
    secondary = PurpleGrey40,
    tertiary = Pink40

    /* 可覆盖的其他默认颜色
    background = Color(0xFFFFFBFE),
    surface = Color(0xFFFFFBFE),
    onPrimary = Color.White,
    onSecondary = Color.White,
    onTertiary = Color.White,
    onBackground = Color(0xFF1C1B1F),
    onSurface = Color(0xFF1C1B1F),
    */
)

@Composable
fun NewToGetThemesTheme(
    darkTheme: Boolean = isSystemInDarkTheme(),
    // Android 12+ 支持动态颜色
    dynamicColor: Boolean = true,
    content: @Composable () -> Unit
) {
    val colorScheme = when {
        dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
            val context = LocalContext.current
            if (darkTheme) dynamicDarkColorScheme(context) else dynamicLightColorScheme(context)
        }

        darkTheme -> DarkColorScheme
        else -> LightColorScheme
    }
    val view = LocalView.current
    if (!view.isInEditMode) {
        SideEffect {
            val window = (view.context as Activity).window
            // 以下代码会导致问题更严重，已注释
            //window.statusBarColor = colorScheme.primary.toArgb()
            //WindowCompat.getInsetsController(window, view).isAppearanceLightStatusBars = darkTheme
        }
    }

    MaterialTheme(
        colorScheme = colorScheme,
        typography = Typography,
        content = content
    )
}

themes.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <style name="Theme.NewToGetThemes" parent="android:Theme.Material.Light.NoActionBar" />
</resources>

1. 修复状态栏闪烁问题 #

闪烁根源是启动时XML主题与Compose初始化的时序不匹配：系统先加载themes.xml的默认样式，之后Compose才完成Edge2Edge配置，导致状态切换出现断层。直接在XML主题中提前配置Edge2Edge基础样式：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <style name="Theme.NewToGetThemes" parent="android:Theme.Material.Light.NoActionBar">
        <!-- 提前设置状态栏透明，对齐Edge2Edge要求 -->
        <item name="android:statusBarColor">@android:color/transparent</item>
        <!-- Android 12+ 提前适配浅色主题的状态栏图标亮度 -->
        <item name="android:windowLightStatusBar">true</item>
    </style>
</resources>

2. 修复状态栏颜色异常问题 #

当前状态栏颜色非纯白，是因为启用dynamicColor后，动态生成的background色值与状态栏透明过渡效果叠加导致的，可选两种方案：

方案A：统一背景色（推荐）

在LightColorScheme中显式指定纯白色背景，覆盖动态颜色默认值：

private val LightColorScheme = lightColorScheme(
    primary = Purple40,
    secondary = PurpleGrey40,
    tertiary = Pink40,
    // 显式设置背景色为纯白色
    background = Color.White,
    surface = Color.White
)

方案B：保留动态颜色的对齐配置

若要保留动态颜色，需在SideEffect中正确配置状态栏参数，与Compose主题完全对齐：

@Composable
fun NewToGetThemesTheme(
    darkTheme: Boolean = isSystemInDarkTheme(),
    dynamicColor: Boolean = true,
    content: @Composable () -> Unit
) {
    val colorScheme = when {
        dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
            val context = LocalContext.current
            if (darkTheme) dynamicDarkColorScheme(context) else dynamicLightColorScheme(context)
        }
        darkTheme -> DarkColorScheme
        else -> LightColorScheme
    }
    val view = LocalView.current
    if (!view.isInEditMode) {
        SideEffect {
            val window = (view.context as Activity).window
            // 设置状态栏完全透明
            window.statusBarColor = Color.Transparent.toArgb()
            // 根据主题设置状态栏图标亮度：浅色主题显示深色图标，深色主题显示浅色图标
            WindowCompat.getInsetsController(window, view).isAppearanceLightStatusBars = !darkTheme
        }
    }

    MaterialTheme(
        colorScheme = colorScheme,
        typography = Typography,
        content = content
    )
}

3. 额外优化：启动页适配 #

如果应用有启动页（Splash Screen），需在启动页的主题中添加同样的statusBarColor和windowLightStatusBar配置，避免启动页到主页面切换时的闪烁。

内容的提问来源于stack exchange，提问作者me.at.coding