如何实现OEM Design Tokens？替换CarSystemUI中oemColor的方法咨询

1. 核心逻辑梳理 #

OEM设计令牌通过「令牌库+资源覆盖层（RRO）」的层级实现：先创建包含自定义颜色的令牌库，再通过RRO将该颜色关联到CarSystemUI的oemColor引用上，完成全局替换。

2. 创建OEM颜色令牌库 #

• 新建Android库模块（命名如oem-design-tokens），在res/values/colors.xml中定义目标颜色：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- 自定义OEM颜色令牌 -->
    <color name="oem_custom_color">#FF009688</color> <!-- 替换为你需要的颜色值 -->
</resources>

• 在模块的AndroidManifest.xml中声明合法包名（如com.your.oem.design.tokens），并设置为库类型。

3. 构建CarSystemUI专属RRO #

RRO用于覆盖CarSystemUI的资源，步骤如下：

• 新建RRO模块（命名如car-systemui-oem-color-rro），在AndroidManifest.xml中指定覆盖目标为CarSystemUI：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.your.car.systemui.oem.color.rro">

    <application android:hasCode="false" />

    <overlay
        android:targetPackage="com.android.car.systemui"
        android:isStatic="true"
        android:priority="100" /> <!-- 高优先级确保覆盖生效 -->
</manifest>

• 在RRO的res/values/styles.xml中，关联令牌库颜色并覆盖CarSystemUI的oemColor：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- 情况1：若CarSystemUI直接引用@color/oemColor，直接覆盖该资源 -->
    <color name="oemColor">@color/oem_custom_color</color>

    <!-- 情况2：若CarSystemUI通过样式引用oemColor，覆盖对应样式属性 -->
    <style name="OemTextStyle" parent="@style/CarSystemUiOemTextStyle">
        <item name="android:textColor">@color/oem_custom_color</item>
    </style>
</resources>

• 确保RRO模块依赖你创建的OEM颜色令牌库，以正常引用@color/oem_custom_color。

4. 编译与部署 #

• 编译令牌库和RRO模块，生成对应APK文件。
• 将RRO APK推送至车机的/system/product/overlay/目录（或对应分区，取决于Android版本），设置文件权限为644。
• 重启CarSystemUI或车机，使资源覆盖生效。

关键注意点 #

• 先确认CarSystemUI中oemColor的具体引用方式：直接颜色引用或样式属性引用，对应调整RRO的覆盖逻辑。
• RRO优先级需高于默认资源，避免被其他覆盖层抢占。
• 如需适配深色模式，可在令牌库的res/values-night/colors.xml中定义对应颜色值。

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