React Native项目报错求助：执行npx react-native run-android失败

针对执行npx react-native run-android时出现的“error Failed to install the app”报错，可按以下步骤逐一排查：

• 检查Android SDK环境配置

  • 确认ANDROID_HOME环境变量已正确指向Android SDK安装目录，且PATH中包含$ANDROID_HOME/platform-tools和$ANDROID_HOME/tools
  • 打开SDK Manager，确保已安装项目android/build.gradle中指定的compileSdkVersion对应的SDK，以及匹配版本的Build-Tools、Platform-Tools

• 修复Gradle相关问题

  • 进入项目的android目录，执行./gradlew clean清理缓存，返回根目录后重新运行npx react-native run-android
  • 检查android/build.gradle中com.android.tools.build:gradle的版本，若版本与本地Gradle不兼容，可替换为稳定兼容版本（比如7.0.3），同时确保gradle/wrapper/gradle-wrapper.properties中的Gradle版本与之匹配

• 验证设备连接状态

  • 执行adb devices命令，确认模拟器已启动或真机已开启USB调试并正常连接
  • 若设备未被识别，执行adb kill-server && adb start-server重启adb服务后再次检查

• 排除项目依赖冲突

  • 新建一个空白React Native项目，执行npx react-native run-android测试是否能正常运行，以此排查是否为当前项目的依赖或配置问题

• 检查网络与代理

  • 确保Gradle下载依赖时未被防火墙、代理拦截，若使用代理，需在android/gradle.properties中正确配置代理地址和端口

内容的提问来源于stack exchange，提问作者Erhan Karataş