配置已经可以满足 React Native Android 开发的基本要求。以下是优化后的专业建议:
当前环境状态确认
✅ Node.js v18.20.8 (符合RN要求)
✅ JDK 11.0.28 (Temurin)
✅ Android Command Line Tools 9.0 (非常规兼容但可用)
✅ 所有SDK许可证已接受
关键操作指南
- 必需SDK组件安装:
./sdkmanager "platform-tools" "platforms;android-33" "build-tools;33.0.0" "emulator"
- 环境变量强化配置:
# 永久生效配置(管理员权限)
[Environment]::SetEnvironmentVariable("ANDROID_HOME", "C:\Android", "Machine")
[Environment]::SetEnvironmentVariable("Path", "$env:Path;C:\Android\platform-tools;C:\Android\cmdline-tools\latest\bin", "Machine")
- Gradle专属JDK设置:
在android/gradle.properties中添加:
org.gradle.java.home=C\:\\Program Files\\Eclipse Adoptium\\jdk-11.0.28.6-hotspot
风险规避方案
- 构建缓存控制:
# 每次重大变更后执行
cd android
./gradlew cleanBuildCache
- 版本锁定机制:
# 防止自动升级破坏兼容性
New-Item -Path "C:\Android\cmdline-tools\latest\metadata" -ItemType Directory
Set-Content -Path "C:\Android\cmdline-tools\latest\metadata\version.override" -Value "7.0-compat"
验证流程
# 1. 基础环境检查
adb devices
./gradlew --version
# 2. 试运行构建
npx react-native run-android --variant=debug
特别注意事项
- 当出现
java.lang.UnsupportedClassVersionError时:
# 应急处理方案
$env:JAVA_OPTS="-XX:+IgnoreUnrecognizedVMOptions --add-modules java.se.ee"
- 推荐定期检查:
./sdkmanager --update 2>&1 | Select-String "available"
您的环境目前处于”可用但需谨慎维护”状态。建议在项目稳定后,逐步迁移到以下官方推荐组合:
- Command Line Tools 8.0 + JDK 17
- 或 Command Line Tools 7.0 + JDK 11