如何从Material Design 2迁移到3（MDC1.4.0升MDC1.5.0）无法识别Theme.Material3

1. 升级Material组件依赖版本 #

Theme.Material3 属于Material Design 3的专属主题，需要1.5.0及以上版本的Material组件库支持。请检查你的Module级build.gradle文件的依赖配置，确保引入了符合版本要求的依赖：

dependencies {
    // 推荐使用最新稳定版，当前示例为1.11.0版本
    implementation "com.google.android.material:material:1.11.0"
}

修改完成后同步Gradle配置，再检查主题是否能被识别。

2. 修正主题继承规则 #

原有基于Theme.MaterialComponents的主题需要修改父类为对应的Material3主题，示例如下：

<!-- 迁移前的Material 2主题配置 -->
<style name="AppTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar">
    <!-- 原有主题属性配置 -->
</style>

<!-- 迁移后的Material 3主题配置 -->
<style name="AppTheme" parent="Theme.Material3.DayNight.NoActionBar">
    <!-- 原有主题属性可保留，可额外配置MD3专属属性 -->
    <item name="dynamicColor">true</item>
</style>

3. 异常场景排查 #

如果完成前两步后仍然无法识别主题，尝试以下操作：

• 确认项目的compileSdk版本≥33，低版本编译SDK无法兼容MD3的资源配置
• 清理Android Studio缓存：点击菜单栏 File → Invalidate Caches...，勾选清理缓存后重启IDE，重新编译项目
• 检查项目中是否同时存在Material 2和Material 3的专属属性引用，删除冲突的属性配置即可

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