React Native项目执行run-android失败，请求排查环境配置问题

1. "adb" 不是内部或外部命令 #

• 确认Android SDK的platform-tools目录已添加到系统PATH环境变量中，Windows下默认路径为C:\Users\<你的用户名>\AppData\Local\Android\Sdk\platform-tools
• 检查ANDROID_HOME环境变量是否正确指向Android SDK根目录，示例路径：C:\Users\<你的用户名>\AppData\Local\Android\Sdk
• 配置完成后重启命令行窗口，执行adb version验证是否生效

2. emulator -list-avds 未找到模拟器 #

• 确保Android SDK的emulator目录已添加到系统PATH，默认路径为C:\Users\<你的用户名>\AppData\Local\Android\Sdk\emulator
• 打开Android Studio的AVD Manager，创建至少一个可用的Android虚拟设备（AVD）
• 若已创建AVD仍无法识别，可尝试删除现有AVD后重新创建，检查配置文件完整性

3. Gradle 7.5.1 编译Kotlin时出现BaseVariant等API弃用警告，不兼容Gradle 8.0 #

• 升级项目根目录build.gradle中的Kotlin插件版本，Gradle 7.5.1建议搭配Kotlin 1.6.21及以上版本：

  buildscript {
      dependencies {
          classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.6.21"
      }
  }
  

• 替换代码中弃用的BaseVariant API，改用Variant或对应版本的新API（如ApplicationVariant）
• 可在项目gradle.properties中添加临时配置屏蔽弃用警告（建议最终完成API适配）：

  android.suppressUnsupportedCompileSdk=33
  

4. 未找到SDK位置导致构建失败 #

• 方法一：配置系统环境变量
  添加ANDROID_HOME环境变量，值为Android SDK根目录；同时将%ANDROID_HOME%\platform-tools和%ANDROID_HOME%\emulator添加到PATH
• 方法二：修改项目local.properties文件
  在项目根目录创建或编辑local.properties，添加SDK路径：

  sdk.dir=C\:\\Users\\<你的用户名>\\AppData\\Local\\Android\\Sdk
  

• 确保路径无空格或特殊字符，配置完成后重新执行npx react-native run-android

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