小米MIUI13设备上Android Studio模板应用启动崩溃求助

针对性修复步骤 #

1. 调整调试签名配置 #

MIUI 部分版本对默认调试签名的兼容性较差，可尝试：

• 生成自定义调试 keystore，替换项目默认的 debug.keystore：
  在项目根目录的 gradle.properties 中添加以下配置（替换为自己的 keystore 路径和密码）：

  android.injected.signing.store.file=/Users/xxx/.android/my_debug.keystore
  android.injected.signing.store.password=android
  android.injected.signing.key.alias=my_debug_key
  android.injected.signing.key.password=android
  

• 或者直接用 release 签名打包调试版本，验证是否还会崩溃。

2. 修正 Manifest 配置 #

除了添加 AppLocalesMetadataHolderService，补充以下调整：

• 确保 application 标签开启备份权限（部分 MIUI 版本限制禁用备份的应用）：

  <application
      ...
      android:allowBackup="true">
  

• 检查是否存在默认模板中隐含的 MIUI 不兼容配置，比如未正确设置的 exported 属性（针对 Android 12+ 的组件必须明确声明该属性）。

3. 降级 AppCompat 依赖版本 #

默认模板的高版本 AppCompat 库可能与 MIUI13 存在兼容性问题：

• 在 app/build.gradle 中降低 AppCompat 版本，例如：

  implementation 'androidx.appcompat:appcompat:1.4.2'
  

• 同步项目后重新打包测试。

4. 关闭 MIUI 安全管控 #

MIUI 的系统权限管控可能拦截调试签名应用：

• 打开设备「设置」→「隐私保护」→「特殊权限设置」→「安装未知应用」，确保对应安装渠道（如 USB 安装、文件管理器）的权限已开启。
• 关闭「纯净模式」：进入「设置」→「隐私保护」→「纯净模式」，选择关闭。

5. 从崩溃日志定位核心问题 #

如果以上步骤无效，重点分析崩溃日志的关键异常信息：

• 找到 Caused by 开头的异常行，例如：

  Caused by: java.lang.ClassNotFoundException: Didn't find class "androidx.appcompat.app.AppLocalesMetadataHolderService" on path: DexPathList[...]
  这种情况需确认依赖库是否正确同步，或开启 multidex 支持；如果是 SecurityException，则优先排查签名或权限配置问题。

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