React Native Android 项目中的配置文件及具体字段做个对应清单,方便理解和查找:
| 项目组件 | 版本/值 | 对应配置文件路径 | 对应字段或配置位置 | 说明 |
|---|---|---|---|---|
| Android Studio | Iguana (2023.2.1) 或 Giraffe | — | — | IDE版本,影响 AGP 支持,非项目内文件配置 |
| Android SDK | Android 14 (API 34) | SDK Manager(Android Studio内) | — | 需要在 Android Studio SDK Manager 安装对应版本 |
| JDK | JDK 17 | — | — | 环境变量 JAVA_HOME 指向,React Native 运行时依赖 |
| AGP(Android Gradle Plugin) | 8.3.0 | android/build.gradle | classpath("com.android.tools.build:gradle:8.3.0") | 构建插件版本,决定编译环境 |
| Gradle | 8.4 | android/gradle/wrapper/gradle-wrapper.properties | distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-all.zip | Gradle 版本,用于执行构建任务 |
| compileSdkVersion | 34 | android/app/build.gradle | compileSdkVersion 34 | 编译时使用的 Android API 版本 |
| targetSdkVersion | 34 | android/app/build.gradle | targetSdkVersion 34 | 应用目标运行环境版本 |
| minSdkVersion | 21 | android/app/build.gradle | minSdkVersion 21 | 应用支持的最低 Android 版本 |
详细路径和字段示例
1. android/build.gradle(项目根 build.gradle)
buildscript {
dependencies {
classpath("com.android.tools.build:gradle:8.3.0") // AGP 版本
}
}
2. android/gradle/wrapper/gradle-wrapper.properties
distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-all.zip // Gradle 版本
3. android/app/build.gradle
android {
compileSdkVersion 34 // 编译 SDK 版本
defaultConfig {
applicationId "com.example.myapp"
minSdkVersion 21 // 最低支持版本
targetSdkVersion 34 // 目标 SDK 版本
versionCode 1
versionName "1.0"
}
...
}
4. JDK 设置(系统环境变量)
- macOS/Linux 终端:
export JAVA_HOME=$(/usr/libexec/java_home -v 17)
- Windows:
setx JAVA_HOME "C:\Program Files\Java\jdk-17"
5. Android SDK
- 通过 Android Studio → Preferences (或 Settings) → Appearance & Behavior → System Settings → Android SDK
- 确保安装 Android 14 (API 34) 和对应的 Build Tools 34.0.0