React Native 0.71项目AGP兼容问题求助：除升级AS外的解决方案

以下是几种不需要升级Android Studio的解决办法：

1. 降级AGP到Android Studio支持的7.2.1版本 #

这是最直接的方案，步骤如下：

• 打开项目根目录下的android/build.gradle文件
• 找到dependencies代码块中的AGP依赖声明：

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

  将版本号修改为7.2.1，修改后如下：

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

• 同步Gradle版本与AGP匹配：AGP 7.2.1对应Gradle 7.4版本，打开android/gradle/wrapper/gradle-wrapper.properties，修改distributionUrl：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.4-all.zip
  

• 点击Android Studio右上角的"Sync Now"，同步完成后重新构建项目

2. 配置Android Studio强制使用兼容环境 #

如果不想修改项目配置，可以在IDE层面调整：

• 打开Android Studio的File > Settings（Mac上是Android Studio > Settings）
• 导航到Build, Execution, Deployment > Build Tools > Gradle
• 在Gradle JDK选项中选择JDK 11（AGP 7.2.1推荐使用JDK 11）
• 勾选Use Gradle from: specified location，选择本地已安装的Gradle 7.4版本
• 同步项目后尝试构建

3. 持久化修改React Native默认AGP配置（适配初始化项目） #

如果是React Native初始化项目时自动生成的AGP配置，可以通过补丁工具持久化修改：

• 安装patch-package工具：

  npm install patch-package --save-dev
  

• 打开node_modules/react-native/react.gradle（或相关配置文件），找到AGP版本声明的位置，修改为7.2.1
• 运行命令生成补丁：

  npx patch-package react-native
  

• 后续执行npm install时，补丁会自动应用，无需重复修改node_modules

注意事项 #

• 降级AGP后，检查项目中是否有依赖AGP 7.3.1新特性的第三方插件或自定义代码，如有需要调整适配7.2.1版本
• 务必保证Gradle版本与AGP版本严格对应，避免出现新的构建错误

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