React Native项目AGP升级助手失效，如何手动更新Android Gradle Plugin？

一、确认版本兼容性 #

AGP与Gradle版本需严格匹配，常见对应关系：

• AGP 7.4.x → Gradle 7.5
• AGP 8.0.x → Gradle 8.0
• AGP 8.1.x → Gradle 8.0
• AGP 8.2.x → Gradle 8.2
  选择目标AGP版本时，同步确认对应的Gradle版本。

二、修改项目根目录的构建配置 #

1. 打开项目根目录下的build.gradle（或build.gradle.kts）
2. 在buildscript的dependencies块中，更新AGP版本：

   buildscript {
       dependencies {
           // 将7.4.2替换为目标AGP版本，例如8.1.4
           classpath("com.android.tools.build:gradle:8.1.4")
           // 其他依赖（如RN的gradle插件）保持不变
       }
   }
   

三、更新Gradle Wrapper #

1. 打开gradle/wrapper/gradle-wrapper.properties文件
2. 修改distributionUrl为对应版本的Gradle安装包地址：

   # 示例：对应AGP 8.1.4的Gradle 8.0版本
   distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip
   

四、适配React Native项目的Android配置 #

1. 打开android/app/build.gradle文件，调整编译和目标SDK版本（AGP 8.0+要求编译SDK至少为33）：

   android {
       compileSdkVersion 34 // 推荐使用与AGP兼容的最新稳定SDK版本
       defaultConfig {
           targetSdkVersion 34
           // 其他配置保持不变
       }
   }
   

2. 移除过时配置：AGP 8.0+默认启用R8混淆，可删除android.enableR8=false这类旧配置
3. 若项目使用Kotlin，确保Kotlin版本与AGP兼容（如AGP 8.1.x对应Kotlin 1.8.20+）

五、清理并同步项目 #

1. 执行终端命令清理缓存：

   # macOS/Linux
   ./gradlew clean
   
   # Windows
   gradlew clean
   

2. 在Android Studio中点击「File」→「Sync Project with Gradle Files」完成同步

注意事项 #

• 升级前备份项目，避免配置错误导致项目无法运行
• 若出现依赖冲突，检查第三方RN插件是否兼容新的AGP版本，必要时升级插件
• 建议同步升级React Native版本到兼容目标AGP的版本（如RN 0.72+支持AGP 8.0+）

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