Android笔记应用多主题配置：如何定制各主题对应的colors.xml

问题背景 #

开发笔记应用时需要提供多种主题可选，但当前颜色配置存在局限：大部分颜色通过drawable的shape、selector直接引用colors.xml中的硬编码颜色，主题仅能调整少量系统属性，无法实现全应用的主题颜色切换。

解决方案步骤 #

1. 定义自定义主题属性 #

在values/attrs.xml中创建自定义属性，替代drawable中直接引用的硬编码颜色，让颜色值可随主题动态变化：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- 自定义主题属性，对应原colors.xml中的语义化颜色 -->
    <attr name="surface_background" format="color" />
    <attr name="text_primary" format="color" />
    <attr name="text_hint" format="color" />
    <attr name="icon_menu" format="color" />
    <attr name="item_background" format="color" />
    <attr name="item_selected_background" format="color" />
    <attr name="button_ok" format="color" />
    <attr name="button_cancel" format="color" />
    <!-- 根据需求添加更多自定义属性 -->
</resources>

2. 重构颜色资源与主题专属目录 #

• 保留基础固定颜色：将纯黑纯白、错误色color_red等通用固定颜色留在values/colors.xml中。
• 创建主题专属目录：为每个主题创建对应values目录，例如：
  • values-theme-light-blue（浅蓝色主题）
  • values-theme-dark-purple（深紫色深色主题）
  • values-theme-green（绿色主题）

每个主题目录下的colors.xml定义该主题的语义化颜色值，以浅蓝色主题为例：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <color name="theme_surface_background">#f0f8ff</color>
    <color name="theme_text_primary">#1a237e</color>
    <color name="theme_text_hint">#78909c</color>
    <color name="theme_icon_menu">#455a64</color>
    <color name="theme_item_background">#ffffff</color>
    <color name="theme_item_selected_background">#bbdefb</color>
    <color name="theme_button_ok">#2196f3</color>
    <color name="theme_button_cancel">#e0e0e0</color>
</resources>

3. 配置多主题样式 #

修改themes.xml，为每个主题创建独立Style，继承基础主题并为自定义属性赋值：

<resources xmlns:tools="http://schemas.android.com/tools">
    <!-- 基础主题 -->
    <style name="Base.Theme.Notepad" parent="Theme.Material3.DayNight.NoActionBar">
        <item name="popupMenuStyle">@style/PopupMenuStyle</item>
        <item name="windowActionBar">false</item>
        <item name="android:windowLightStatusBar" tools:targetApi="m">true</item>
    </style>

    <!-- 浅蓝色主题 -->
    <style name="Theme.Notepad.LightBlue" parent="Base.Theme.Notepad">
        <!-- 系统属性 -->
        <item name="colorPrimary">@color/theme_button_ok</item>
        <item name="android:statusBarColor">@color/theme_surface_background</item>
        <item name="android:navigationBarColor">@color/theme_surface_background</item>
        <!-- 自定义属性 -->
        <item name="surface_background">@color/theme_surface_background</item>
        <item name="text_primary">@color/theme_text_primary</item>
        <item name="text_hint">@color/theme_text_hint</item>
        <item name="icon_menu">@color/theme_icon_menu</item>
        <item name="item_background">@color/theme_item_background</item>
        <item name="item_selected_background">@color/theme_item_selected_background</item>
        <item name="button_ok">@color/theme_button_ok</item>
        <item name="button_cancel">@color/theme_button_cancel</item>
    </style>

    <!-- 深紫色深色主题 -->
    <style name="Theme.Notepad.DarkPurple" parent="Base.Theme.Notepad">
        <item name="colorPrimary">#9c27b0</item>
        <item name="android:statusBarColor">#1a001a</item>
        <item name="android:navigationBarColor">#1a001a</item>
        <item name="android:windowLightStatusBar" tools:targetApi="m">false</item>
        <!-- 自定义属性赋值 -->
        <item name="surface_background">#1a001a</item>
        <item name="text_primary">#f3e5f5</item>
        <item name="text_hint">#9575cd</item>
        <item name="icon_menu">#b39ddb</item>
        <item name="item_background">#311b92</item>
        <item name="item_selected_background">#673ab7</item>
        <item name="button_ok">#9c27b0</item>
        <item name="button_cancel">#4a148c</item>
    </style>

    <!-- 绿色主题（自行补充属性赋值） -->
    <style name="Theme.Notepad.Green" parent="Base.Theme.Notepad">
    </style>
</resources>

4. 修改Drawable资源引用 #

将drawable中所有@color/xxx的硬编码引用，替换为对应的@attr/xxx自定义属性：

<!-- 修改前的shape文件 -->
<shape xmlns:android="http://schemas.android.com/apk/res/android">
    <solid android:color="@color/bg_main" />
</shape>

<!-- 修改后的shape文件 -->
<shape xmlns:android="http://schemas.android.com/apk/res/android">
    <solid android:color="?attr/surface_background" />
</shape>

Selector中的颜色引用同理替换：

<!-- 修改前的selector文件 -->
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:color="@color/item_selected" android:state_selected="true" />
    <item android:color="@color/item" />
</selector>

<!-- 修改后的selector文件 -->
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:color="?attr/item_selected_background" android:state_selected="true" />
    <item android:color="?attr/item_background" />
</selector>

5. 实现主题切换逻辑 #

在设置页面添加主题选择功能，通过setTheme()切换主题后重启Activity生效：

// 切换到浅蓝色主题
fun switchToLightBlueTheme() {
    setTheme(R.style.Theme_Notepad_LightBlue)
    recreate()
}

// 切换到深紫色深色主题
fun switchToDarkPurpleTheme() {
    setTheme(R.style.Theme_Notepad_DarkPurple)
    recreate()
}

关键说明 #

• 语义化命名：颜色命名要体现用途而非具体色值，比如surface_background表示界面背景，便于后续主题维护。
• 自定义属性是核心：通过自定义属性将drawable与具体颜色解耦，让颜色值由当前主题决定。
• 主题目录规范：遵循Android资源目录命名规则创建主题专属目录，确保系统正确加载对应主题资源。

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