React Native构建报错：Task :app:checkDebugAarMetadata执行失败

配置项目:react-native-reanimated
未找到react-native-reanimated的AAR文件，尝试从源码构建。
Android Gradle插件：4.1.0
Gradle：6.7
任务:app:checkDebugAarMetadata执行失败
构建失败，出现异常：
出错原因：任务':app:checkDebugAarMetadata'执行失败。
无法解析配置':app:debugRuntimeClasspath'的所有文件。
无法转换react-native-0.71.0-rc.0-debug.aar（com.facebook.react:react-native:0.71.0-rc.0）以匹配属性{artifactType=android-aar-metadata, com.android.build.api.attributes.BuildTypeAttr=debug, org.gradle.category=library, org.gradle.dependency.bundling=external, org.gradle.libraryelements=aar, org.gradle.status=release, org.gradle.usage=java-runtime}。

JetifyTransform执行失败：/Users/milanshrestha/.gradle/caches/modules-2/files-2.1/com.facebook.react/react-native/0.71.0-rc.0/7a7f5a0af6ebd8eb94f7e5f7495e9d9684b4f543/react-native-0.71.0-rc.0-debug.aar。
Java堆空间不足

• 增加Gradle Java堆内存
  打开项目根目录下的gradle.properties文件，添加或修改以下配置，提升Java虚拟机内存分配：

  org.gradle.jvmargs=-Xmx4096m -XX:MaxMetaspaceSize=512m
  

  若想全局生效，可修改系统Gradle配置文件：Mac/Linux路径为~/.gradle/gradle.properties，Windows路径为C:\Users\<用户名>\.gradle\gradle.properties，添加上述相同配置。

• 升级Gradle与Android Gradle插件（AGP）版本
  React Native 0.71.x要求AGP最低7.3.1、Gradle最低7.5，当前版本不兼容，需更新：

  1. 打开android/build.gradle，修改AGP依赖版本：

     dependencies {
       classpath 'com.android.tools.build:gradle:7.3.1'
     }
     

  2. 打开android/gradle/wrapper/gradle-wrapper.properties，修改Gradle分发URL：

     distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
     

• 修复react-native-reanimated构建问题

  1. 确保依赖安装正确：

     npm install react-native-reanimated@latest
     

  2. 清理Gradle缓存：

     cd android && ./gradlew clean
     

  3. 重新构建项目：

     cd android && ./gradlew assembleDebug
     

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