升级Android Gradle与插件版本后Debug APK无法安装求助

1. 检查Debug签名配置 #

AGP 7.x对签名逻辑做了调整，重点确认debug签名配置：

• 打开app/build.gradle，核对debug签名块的路径、密钥信息是否正确，确保V2签名开启（AGP 7.x默认开启，但手动修改过需检查）：

  signingConfigs {
      debug {
          storeFile file('debug.keystore')
          storePassword 'android'
          keyAlias 'androiddebugkey'
          keyPassword 'android'
          v2SigningEnabled true
      }
  }
  

• 若自定义了debug keystore，确认文件存在且权限正常。

2. 排查自定义APK输出配置 #

AGP 7.x修改了默认输出目录结构，自定义输出规则可能冲突：

• 检查build.gradle中applicationVariants.all的自定义输出配置，暂时注释后重新构建测试：

  // 暂时注释以下代码测试
  // applicationVariants.all { variant ->
  //     variant.outputs.each { output ->
  //         def fileName = "myapp-${variant.name}-${variant.versionName}.apk"
  //         output.outputFileName = fileName
  //     }
  // }
  

3. 关闭Apply Changes功能 #

AGP 7.x的Apply Changes（原Instant Run）可能存在兼容性问题：

• 打开Android Studio设置：File > Settings > Build, Execution, Deployment > Compiler，取消勾选Enable Apply Changes (instant run)，清理重建项目后再尝试安装。

4. 手动验证APK有效性 #

通过工具排查APK本身的问题：

• 使用apksigner验证签名完整性：

  apksigner verify --verbose C:\Users\...\Documents\Android\app\build\intermediates\apk\_int\debug\my.....apk
  

• 若签名验证通过，用adb手动安装获取更详细错误：

  adb install -r C:\Users\...\Documents\Android\app\build\intermediates\apk\_int\debug\my.....apk
  

5. 匹配配套开发工具版本 #

AGP 7.2.0对开发环境有版本要求：

• 确认Android Studio版本为2021.2.1（Chipmunk）或更高。
• 在SDK Manager中，将SDK Build Tools更新至32.0.0及以上版本。

6. 彻底清理构建缓存 #

除常规清理外，删除深层缓存文件：

• 删除项目根目录的.gradle文件夹、app/build文件夹。
• 删除用户目录下的Gradle缓存：C:\Users\<你的用户名>\.gradle\caches。
• 执行File > Invalidate Caches... > Invalidate and Restart重启Android Studio。

7. 校验Manifest文件合法性 #

AGP 7.x对Manifest校验更严格：

• 检查AndroidManifest.xml是否存在重复的组件声明（如<activity>、<service>）、无效权限或格式错误。
• 确认debug模式下android:debuggable未被手动设为false（AGP会自动处理该属性）。

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