如何在混合使用AppCompatActivity与普通Activity的遗留安卓项目中实现暗模式

1. Android Studio内置自动化工具 #

• 优先使用 Refactor > Migrate to Material Components 功能，可批量将项目中硬编码的浅色文字色、写死的@color/white等固定色值，自动替换为?attr/colorOnSurface、?attr/colorOnPrimary这类随深色/浅色模式自动切换的主题属性，常见场景的文字色覆盖率可达70%以上
• 开启Android Studio内置Dark Theme专项Lint检查：路径为Settings > Editor > Inspections > Android > Lint > Usability > Dark theme，扫描后会自动列出所有未适配深色模式的文字颜色配置，支持一键批量修正，工具可自动识别普通Activity与AppCompatActivity的主题继承差异，不会出现适配冲突

2. 自定义批量转换脚本（适配1500+文件的大规模场景） #

可针对layout、values目录文件编写轻量批量替换脚本，通用规则如下：

• 文字颜色映射替换：将所有android:textColor="@color/xxx_light"类的浅色专属配置，自动替换为android:textColor="@color/xxx"，同步在res/values-night目录下创建同名颜色资源，配置对应的深色模式色值即可
• 硬编码色值批量替换：可提前梳理项目中常用的文字硬编码色值，例如将浅模式主文字色#333333自动替换为@color/text_primary，次级文字色#666666替换为@color/text_secondary，分别在values和values-night目录下定义两个色值的深浅模式对应值即可
• 双Activity类型兼容处理：脚本可自动检测Activity的父类，普通Activity自动修改AndroidManifest.xml中的主题继承自@style/Theme.AppCompat.DayNight，AppCompatActivity则自动补充全局深色模式开关初始化代码，无需逐个修改Activity文件

3. 全局兜底适配方案 #

如果批量替换后仍有遗漏的文字场景，可直接在全局主题中添加以下配置，无需修改单个布局即可覆盖绝大多数未单独指定文字色的控件：

<style name="AppTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar">
    <!-- 全局主文字色 -->
    <item name="android:textColorPrimary">@color/text_primary</item>
    <!-- 全局次级文字色 -->
    <item name="android:textColorSecondary">@color/text_secondary</item>
    <!-- 全局提示文字色 -->
    <item name="android:textColorTertiary">@color/text_tertiary</item>
</style>

该方案同时兼容普通Activity与AppCompatActivity，只需保证所有Activity都继承该全局主题即可生效。

注意：所有自动化方案处理完成后，建议做10%左右的抽样校验，避免半透明文字、自定义Drawable内嵌文字等特殊场景的转换错误，图片类资源仍需手动适配。

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