React Native构建报错：Android SDK未找到（要求版本34.0.0）

排查与解决步骤 #

1. 确认SDK实际安装状态 #

• 打开Android Studio的SDK Manager，检查**Android 14 (API 34)**的SDK Platform以及配套的Build Tools 34.0.0是否已安装
• 手动核对SDK路径C:\Users\mypc\AppData\Local\Android\sdk下的目录：
  • platforms文件夹需存在android-34目录
  • build-tools文件夹需存在34.0.0目录

2. 修正系统环境变量 #

• 确保系统变量ANDROID_HOME准确指向C:\Users\mypc\AppData\Local\Android\sdk
• 检查Path变量是否包含以下路径：
  • %ANDROID_HOME%\platform-tools
  • %ANDROID_HOME%\tools
  • %ANDROID_HOME%\tools\bin
• 配置完成后重启所有终端和IDE，执行echo %ANDROID_HOME%和adb version验证环境变量是否生效

3. 修复local.properties配置 #

• 调整路径格式：Windows环境下可使用双反斜杠C:\\Users\\mypc\\AppData\\Local\\Android\\sdk或单斜杠C:/Users/mypc/AppData/Local/Android/sdk，避免路径含空格或中文
• 确认文件放置在项目的android目录下（而非项目根目录）
• 临时将文件设置为只读，防止被IDE自动覆盖

4. 检查Gradle配置 #

• 打开android/build.gradle文件，确保以下配置正确：

  buildToolsVersion = "34.0.0"
  compileSdkVersion = 34
  targetSdkVersion = 34
  

• 检查android/gradle/wrapper/gradle-wrapper.properties中的Gradle版本，建议使用7.5及以上版本以兼容API 34

5. 清除缓存后重新构建 #

• 执行以下命令清理缓存：

  cd android
  ./gradlew clean
  cd ..
  npx react-native clean
  

• 重新执行构建命令：npx react-native run-android

6. 完成SDK许可证授权 #

• 在Android Studio的SDK Manager中，安装Android SDK Command-line Tools (latest)
• 打开终端执行sdkmanager --licenses，接受所有未授权的SDK许可证

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