如何为现有Android项目添加Material Design 3主题的专属配置目录

为现有Android项目添加Material Design 3主题配置的步骤 #

首先澄清认知误区：Android的res资源目录下不支持自定义子文件夹，新建项目里看到的「themes目录」是Android Studio的资源分组显示效果，不是实际的文件系统目录结构，不需要手动创建同名文件夹。

• 第一步：先引入Material Design 3依赖，打开模块级build.gradle文件，在dependencies块添加：

  implementation 'com.google.android.material:material:1.11.0' // 可替换为最新稳定版
  

• 第二步：创建浅色模式主题配置
  右键res/values目录 → New → Values Resource File，文件名填themes.xml，直接确认，会在res/values下生成themes.xml文件，用于配置浅色模式主题。
• 第三步：创建深色模式主题配置
  再次右键res/values目录 → New → Values Resource File，文件名仍填themes.xml，在左侧的Available qualifiers列表里选择Night Mode，点击右箭头添加，在Night mode的下拉选项里选择Night，确认后会自动生成res/values-night/themes.xml文件，用于配置深色模式主题。
• 第四步：配置主题内容
  两份themes.xml都继承MD3的基础主题即可，示例配置如下：
  浅色模式（res/values/themes.xml）：

  <style name="AppTheme" parent="Theme.Material3.Light.NoActionBar">
      <!-- 配置主色、次色等自定义属性 -->
      <item name="colorPrimary">@color/md_theme_light_primary</item>
      <item name="colorOnPrimary">@color/md_theme_light_onPrimary</item>
      <!-- 其余属性按需添加 -->
  </style>
  

  深色模式（res/values-night/themes.xml）：

  <style name="AppTheme" parent="Theme.Material3.Dark.NoActionBar">
      <!-- 配置深色模式对应的颜色属性 -->
      <item name="colorPrimary">@color/md_theme_dark_primary</item>
      <item name="colorOnPrimary">@color/md_theme_dark_onPrimary</item>
      <!-- 其余属性按需添加 -->
  </style>
  

• 第五步：应用主题
  打开AndroidManifest.xml，将application节点的android:theme属性值设置为你配置的主题名@style/AppTheme即可。

配置完成后重启Android Studio，就会在res/values目录下看到和新建项目一致的themes分组显示效果，这个分组是Studio自动识别同文件名的多限定符资源生成的，不是实际的文件目录。

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