如何修复Jetpack Compose主题未使用Color.kt定义颜色的问题

问题现象 #

• 修改Compose主题颜色后，旧主题始终生效
• 新建空白Material3 Compose测试应用，按钮显示旧主题蓝色而非默认紫色
• 仅能通过ButtonDefaults.buttonColors手动设置按钮颜色，MaterialTheme.colorScheme.primary获取到的是未定义的蓝色

问题根源 #

查看你的Theme.kt代码，动态颜色（Dynamic Color）功能默认开启，在Android 12+（API 31+）设备上，系统会优先使用动态生成的颜色方案，完全覆盖了你自定义的DarkColorScheme和LightColorScheme：

@Composable
fun TestTheme(
    darkTheme: Boolean = isSystemInDarkTheme(),
    dynamicColor: Boolean = true, // 默认开启动态颜色
    content: @Composable () -> Unit
) {
    val colorScheme = when {
        // Android12+设备会优先走这个分支，使用系统动态颜色
        dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
            val context = LocalContext.current
            if (darkTheme) dynamicDarkColorScheme(context) else dynamicLightColorScheme(context)
        }
        darkTheme -> DarkColorScheme
        else -> LightColorScheme
    }
    // ...
}

解决方案 #

方案1：关闭动态颜色功能 #

在调用TestTheme时显式传入dynamicColor = false，强制使用自定义配色：

// MainActivity.kt中修改TestTheme调用
TestTheme(dynamicColor = false) {
    Surface(
        modifier = Modifier.fillMaxSize(),
        color = MaterialTheme.colorScheme.background
    ) {
        Greeting("Android")
    }
}

或者直接修改Theme.kt中dynamicColor的默认值为false，全局关闭动态颜色：

@Composable
fun TestTheme(
    darkTheme: Boolean = isSystemInDarkTheme(),
    dynamicColor: Boolean = false, // 修改默认值
    content: @Composable () -> Unit
) {
    // 原有逻辑不变
}

方案2：适配动态颜色并保留自定义配色 #

如果想保留动态颜色功能，同时让自定义配色作为补充，可以合并动态颜色与自定义颜色：

private val DarkColorScheme = darkColorScheme(/* 你的自定义深色配色 */)
private val LightColorScheme = lightColorScheme(/* 你的自定义浅色配色 */)

@Composable
fun TestTheme(
    darkTheme: Boolean = isSystemInDarkTheme(),
    dynamicColor: Boolean = true,
    content: @Composable () -> Unit
) {
    val baseScheme = if (darkTheme) DarkColorScheme else LightColorScheme
    val colorScheme = when {
        dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
            val context = LocalContext.current
            val dynamicScheme = if (darkTheme) dynamicDarkColorScheme(context) else dynamicLightColorScheme(context)
            // 替换动态方案中的指定颜色，比如保留自定义primary
            dynamicScheme.copy(primary = baseScheme.primary)
        }
        else -> baseScheme
    }
    // 原有状态栏设置逻辑不变
    MaterialTheme(
        colorScheme = colorScheme,
        typography = Typography,
        content = content
    )
}

方案3：清理缓存并重建项目 #

如果上述方案无效，可能是项目缓存残留导致旧主题未更新：

• 点击Android Studio工具栏的Build > Clean Project
• 执行Build > Rebuild Project
• 卸载设备上的旧应用，重新安装

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