从Material 2迁移至Material 3时修改主题导致应用崩溃求助

我是Android应用开发新手，尝试用Material 3 UI开发，修改基础主题后应用启动就崩溃，试过修改主题内容、更换不同版本的Material3基础主题都没用。我在themes.xml里加了这段代码：

<style name="Theme.MyApp" parent="Theme.Material3.DayNight.NoActionBar">
    <!-- ... -->
</style>

排查及解决步骤 #

• 检查Material3依赖是否正确引入
  打开app模块的build.gradle（或build.gradle.kts），确认添加了Material3依赖，建议用最新稳定版：

  dependencies {
      implementation 'com.google.android.material:material:1.11.0'
  }
  

  点击Sync Now同步依赖后重试。

• 补全主题必要属性
  Material3主题不能只留空注释，必须包含核心颜色属性，否则会因资源缺失崩溃。可以直接复制默认Material3主题的基础属性再修改：

  <style name="Theme.MyApp" parent="Theme.Material3.DayNight.NoActionBar">
      <item name="colorPrimary">@color/purple_500</item>
      <item name="colorOnPrimary">@color/white</item>
      <item name="colorPrimaryContainer">@color/purple_200</item>
      <item name="colorOnPrimaryContainer">@color/purple_900</item>
      <item name="colorSecondary">@color/teal_200</item>
      <item name="colorOnSecondary">@color/black</item>
      <item name="colorSecondaryContainer">@color/teal_700</item>
      <item name="colorOnSecondaryContainer">@color/teal_200</item>
  </style>
  

• 确认Manifest主题配置正确
  打开AndroidManifest.xml，确保application标签指定了你的自定义主题：

  <application
      android:allowBackup="true"
      android:icon="@mipmap/ic_launcher"
      android:label="@string/app_name"
      android:roundIcon="@mipmap/ic_launcher_round"
      android:supportsRtl="true"
      android:theme="@style/Theme.MyApp">
      <!-- 活动配置 -->
  </application>
  

• 替换旧版控件为Material3控件
  如果布局里用了android.widget.Button、android.widget.TextView等旧控件，换成Material3对应的控件（比如com.google.android.material.button.MaterialButton），避免控件与主题不兼容。

• 查看崩溃日志定位问题
  打开Android Studio的Logcat面板，筛选Error级别，找到崩溃堆栈信息。比如出现Resources$NotFoundException说明缺失主题资源，IllegalStateException可能是控件与主题不匹配，根据日志提示精准修复。

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