Android Studio构建React Native安卓项目遇依赖缺失与Gradle兼容问题求解决

一、解决依赖模块找不到react-native debug.aar文件问题 #

• 检查Maven仓库配置：在项目根目录的android/build.gradle文件中，确保repositories块包含Facebook的Maven源和Maven Central，配置如下：

  allprojects {
      repositories {
          mavenCentral()
          maven { url 'https://maven.facebook.com' }
          google()
          // 其他仓库配置
      }
  }
  

• 切换到React Native稳定版本：RC版本（如0.71.0-rc.0）的debug包通常不会上传到Maven Central，建议修改package.json中的react-native版本为对应正式版（比如0.71.0），执行npm install后同步Gradle。
• 本地构建RC版debug包（仅当必须使用RC版本时）：
  1. 克隆React Native仓库并切换到0.71.0-rc.0分支
  2. 在仓库目录执行./gradlew :ReactNative:assembleDebug生成debug.aar
  3. 将生成的aar文件复制到项目android/libs目录
  4. 在模块的build.gradle中添加本地依赖：implementation files('libs/react-native-0.71.0-rc.0-debug.aar')

二、解决Gradle 8.0版本不兼容问题 #

• 匹配React Native与Gradle版本：旧版React Native（如0.71.x）不支持Gradle 8.0，建议降级Gradle到对应兼容版本（比如0.71.x对应Gradle 7.5），修改android/gradle/wrapper/gradle-wrapper.properties中的distributionUrl：

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

• 升级React Native到支持Gradle 8.x的版本：如果需要保留Gradle 8.0，将React Native升级到0.72.0及以上版本，这类版本已经适配了Gradle 8.x的新特性。
• 替换废弃的Gradle语法：检查所有模块的build.gradle文件，将废弃的compile替换为implementation，testCompile替换为testImplementation，确保compileSdkVersion至少设置为33。
• 清理缓存后重新构建：执行./gradlew clean清除旧构建缓存，再重新执行构建命令。

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