使用Android Studio创建React Native项目时构建失败求助

问题原因 #

• Gradle构建插件版本缺失：根项目build.gradle中com.android.tools.build:gradle依赖未指定具体版本，导致Gradle无法解析该依赖。
• Java版本不兼容：react-native-gradle-plugin要求运行环境为Java 11，但当前项目配置的是Java 8，引发版本匹配冲突。
• Gradle插件API版本不匹配：项目使用的Gradle版本（8.0.1）与react-native-gradle-plugin的插件API版本不兼容，导致无法找到匹配的组件变体。

解决步骤 #

1. 补全Gradle插件版本号 #

打开项目根目录下的build.gradle（或build.gradle.kts）文件，在buildscript的dependencies块中，为com.android.tools.build:gradle和react-native-gradle-plugin指定与React Native版本匹配的具体版本：

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        // 示例：RN 0.72+对应gradle插件7.3.1，根据你的RN版本调整
        classpath("com.android.tools.build:gradle:7.3.1")
        // 使用与项目RN一致的版本号，例如你的RN是0.72.6则填0.72.6
        classpath("com.facebook.react:react-native-gradle-plugin:0.72.6")
    }
}

2. 升级Java版本至11 #

• Android Studio配置：打开File > Project Structure > SDK Location，在JDK location处选择Android Studio内置的Java 11（路径通常为Android Studio安装目录/jbr）。
• 手动指定路径：若使用本地JDK，在项目根目录的gradle.properties中添加：

org.gradle.java.home=/path/to/your/jdk11

3. 同步并清理项目 #

• 点击Android Studio右上角的「Sync Project with Gradle Files」按钮，同步Gradle配置。
• 执行清理与构建命令：

./gradlew clean
./gradlew assembleDebug

4. 确认版本兼容性 #

确保React Native、Gradle插件、Gradle Wrapper版本相互兼容，典型对应关系如下：

• RN 0.72.x：Gradle插件7.3.1 + Gradle Wrapper 7.5
• RN 0.71.x：Gradle插件7.2.0 + Gradle Wrapper 7.4
• RN 0.70.x：Gradle插件7.0.4 + Gradle Wrapper 7.3.3

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