React项目执行react-native run-android时，无法在设备上安装应用

嘿，我之前在React Native项目里跑react-native run-android的时候也踩过不少坑！结合这类报错的常见情况，给你整理了几个靠谱的排查步骤，你可以一步步试：

1. 先确认Android环境变量配置 #

• 打开终端执行下面的命令，检查ANDROID_HOME（或ANDROID_SDK_ROOT）是否正确设置：

  echo $ANDROID_HOME
  

  如果输出为空或者路径不对，得去系统环境变量里把它改成你Android SDK的实际安装路径（Mac一般是~/Library/Android/sdk，Windows通常是C:\Users\你的用户名\AppData\Local\Android\Sdk）。
• 还要确保SDK的platform-tools和tools目录已经添加到系统PATH里，这样adb工具才能被正常调用。

2. 手动排查Gradle相关问题 #

• 进入项目的android目录，打开gradle/wrapper/gradle-wrapper.properties文件，确认gradle的版本和你本地的环境兼容（比如React Native 0.70+版本需要gradle 7.x及以上）。
• 在android目录下执行下面的命令，手动清理并编译，能看到更详细的报错信息：

  ./gradlew clean
  ./gradlew assembleDebug
  

  要是这里出现具体的依赖冲突或者资源错误，就能精准定位修复了。

3. 检查设备连接状态 #

• 执行下面的命令，确认模拟器或真机已经正常连接：

  adb devices
  

  如果看不到设备列表，要么是模拟器没启动，要么是真机没打开USB调试权限，或者USB连接模式设成了“文件传输”以外的模式，得调整一下。

4. 清理React Native缓存后重试 #

• 缓存异常也会导致各种奇怪的报错，先重置缓存：

  npx react-native start --reset-cache
  

• 关掉当前的终端窗口，重新打开一个新的终端，再执行react-native run-android试试。

5. 重置项目依赖 #

• 要是上面的方法都没用，可能是依赖版本不兼容。可以删掉旧的依赖文件重新安装：

  rm -rf node_modules package-lock.json
  npm install
  

内容的提问来源于stack exchange，提问作者dina omari