运行应用时出现INSTALL_BASELINE_PROFILE_FAILED错误的原因及解决方法

• AGP版本：8.7.1
• Android Studio版本详情：

Android Studio Ladybug | 2024.2.1 Patch 1
Build #AI-242.23339.11.2421.12483815, built on October 10, 2024
Runtime version: 21.0.3+-79915917-b509.11 aarch64
VM: OpenJDK 64-Bit Server VM by JetBrains s.r.o.
Toolkit: sun.lwawt.macosx.LWCToolkit
macOS 14.7
GC: G1 Young Generation, G1 Concurrent GC, G1 Old Generation
Memory: 5120M
Cores: 10
Metal Rendering is ON
Registry:
  ide.instant.shutdown=false
  ide.experimental.ui=true
  i18n.locale=
Non-Bundled Plugins:
  idea.plugin.protoeditor (242.23339.11)
  io.github.composegears.valkyrie (0.9.1)
  org.norbye.tor.kdocformatter (1.6.5)
  com.jetbrains.kmm (0.8.3(242)-4)
  org.jetbrains.compose.desktop.ide (1.7.0)

项目在debug构建模式下运行正常，但使用自定义密钥库配置release构建签名后，安装时出现以下错误：

The application could not be installed: INSTALL_BASELINE_PROFILE_FAILED Installation failed due to: 'Baseline profile did not install'

原因1：基线配置文件与APK签名不匹配 #

基线配置文件需要和APK使用完全一致的签名密钥。如果release构建用了自定义密钥库，但基线配置文件仍使用debug密钥或未正确配置签名，会导致系统验证失败，触发该错误。

解决步骤： #

• 在模块级build.gradle中，为基线配置指定与release构建相同的签名配置：

baselineProfile {
    signingConfigs {
        release {
            storeFile file("你的密钥库路径.jks")
            storePassword "密钥库密码"
            keyAlias "密钥别名"
            keyPassword "密钥密码"
        }
    }
    signingConfig signingConfigs.release
}

• 重新执行generateReleaseBaselineProfile任务生成新的基线配置文件，再重新打包release APK。

原因2：基线配置文件生成或打包异常 #

基线配置文件生成过程出错，或未正确打包进release APK，也会引发安装失败。

解决步骤： #

• 手动执行generateReleaseBaselineProfile任务，查看执行日志是否有报错，排查生成过程中的问题。
• 解压release APK，检查assets/dexopt/baseline.prof文件是否存在且大小正常。
• 临时禁用基线配置文件（用于排查）：在模块级build.gradle中添加：

baselineProfile {
    enabled = false
}

如果此时release版本能正常安装，即可确认问题出在基线配置文件上，再针对性修复。

原因3：设备Dex优化状态异常 #

部分设备（尤其是Android 12及以下版本）的Dex优化缓存可能干扰基线配置文件的安装，导致验证失败。

解决步骤： #

• 卸载设备上已安装的该应用旧版本，重启设备后重新安装release版本。
• 在不同Android版本的设备上测试，确认是否为特定系统版本的兼容性问题。

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