XML+Compose应用中动态颜色异常问题的排查与解决

核心问题原因 #

1. 主题手动覆盖颜色属性：你的AppCompat主题继承了Theme.Material3.DynamicColors.Light，但又手动设置了colorPrimary、colorPrimaryContainer等属性为固定颜色，直接覆盖了DynamicColors机制生成的动态值，导致开启动态颜色后无变化。
2. 自定义View颜色获取逻辑错误：直接通过resourceId获取颜色，未处理动态颜色直接返回颜色值的情况。

修复步骤 #

1. 修正主题配置 #

移除theme.xml中手动设置的颜色属性，让DynamicColors机制自动管理颜色值：

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools">
    <style name="AppCompat" parent="Theme.Material3.DynamicColors.Light">
        <item name="android:windowTranslucentStatus">false</item>
        <item name="android:statusBarColor">@android:color/transparent</item>
        <item name="android:navigationBarColor">@android:color/transparent</item>
        <item name="android:windowLightStatusBar">true</item>
        <item name="android:forceDarkAllowed" tools:targetApi="q">false</item>
        <item name="windowActionBar">false</item>
        <item name="windowNoTitle">true</item>
        <!-- 移除所有手动设置的colorPrimary、colorPrimaryContainer等属性 -->
    </style>
</resources>

如果需要动态颜色关闭时的 fallback 颜色，保留colors.xml中的md_theme_light_*和md_theme_dark_*定义即可，DynamicColors会自动使用这些值作为 fallback。

2. 修正自定义View颜色获取逻辑 #

动态颜色可能直接返回颜色值而非资源ID，需调整获取逻辑：

val typedValue = TypedValue()
val theme = context.theme
val colorAttr = com.google.android.material.R.attr.colorOnSecondaryContainer
if (theme.resolveAttribute(colorAttr, typedValue, true)) {
    val colorOnSecondaryContainer = when {
        typedValue.type in TypedValue.TYPE_FIRST_COLOR_INT..TypedValue.TYPE_LAST_COLOR_INT ->
            typedValue.data // 直接取颜色值
        else ->
            ContextCompat.getColor(context, typedValue.resourceId) // 取资源ID对应的颜色
    }
    // 使用获取到的颜色
}

3. 可选：支持深色模式切换 #

若需跟随系统深色模式，将主题父类改为Theme.Material3.DynamicColors.DayNight：

<style name="AppCompat" parent="Theme.Material3.DynamicColors.DayNight">
    <!-- 其他属性保持不变 -->
</style>

参考仓库 #

Google官方Material3 Android示例仓库包含完整的XML动态颜色实现：
https://github.com/material-components/material-components-android/tree/master/catalog/java/io/material/catalog

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