使用@react-native/gradle-plugin时如何升级Gradle插件？

方法1：通过React Native CLI自动同步版本 #

• 先确认React Native版本对应的Android Gradle插件（AGP）与Gradle版本的兼容映射关系
• 运行npx react-native upgrade命令，该命令会自动更新项目内包括gradle-plugin在内的依赖配置，同步匹配的AGP版本，同时更新Gradle wrapper至对应兼容版本
• 执行完成后检查项目根目录的android/build.gradle文件，此时com.android.tools.build:gradle的版本会被自动设置为匹配值，且与你的Gradle版本兼容

方法2：手动指定版本并同步依赖 #

• 打开项目根目录的android/build.gradle文件，定位到buildscript下的dependencies代码块
• 找到classpath("com.android.tools.build:gradle")行，替换为指定兼容版本的声明（需保证AGP与Gradle版本兼容，比如Gradle 7.5可搭配AGP 7.4.3或7.5.0），示例如下：

  classpath("com.android.tools.build:gradle:7.5.0")
  

• 同时确认classpath("com.facebook.react:react-native-gradle-plugin")的版本与你的React Native版本一致，示例：

  classpath("com.facebook.react:react-native-gradle-plugin:0.72.0")
  

• 保存文件后，点击Android Studio右上角的Sync Project with Gradle Files按钮同步依赖
• 若同步报错，检查AGP与Gradle的版本兼容性，调整至匹配组合即可

方法3：通过gradle.properties强制指定AGP版本 #

• 在项目根目录的gradle.properties文件中添加以下配置，强制指定AGP版本：

  android.useAndroidX=true
  android.enableJetifier=true
  # 指定AGP版本
  com.android.tools.build:gradle.version=7.5.0
  

• 回到android/build.gradle文件，保持classpath("com.android.tools.build:gradle")不变，同步项目后Gradle会自动使用你指定的版本

版本兼容参考 #

• AGP 7.4.x 对应 Gradle 7.5+
• AGP 7.5.x 对应 Gradle 7.5+
• AGP 8.0.x 对应 Gradle 8.0+

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