React Native执行run-android时卡在Installing the app阶段如何解决

1. 设备连接校验 #

• 确认安卓模拟器/真机已正常开启调试模式，执行adb devices命令查看是否有已识别的设备。如果无输出，重启adb服务：

  adb kill-server
  adb start-server
  

• 确认系统已正确配置ANDROID_HOME环境变量，安卓SDK的platform-tools、tools路径已加入系统PATH。

2. Gradle源配置优化 #

绝大多数卡顿是因为Gradle依赖拉取慢，替换国内镜像源即可解决：

• 打开项目android/build.gradle文件，修改buildscript和allprojects下的repositories配置块，将默认的google、mavenCentral等境外源替换为阿里云镜像：

  maven { url 'https://maven.aliyun.com/repository/google' }
  maven { url 'https://maven.aliyun.com/repository/public' }
  maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
  

• 也可以提前下载项目android/gradle/wrapper/gradle-wrapper.properties中指定版本的Gradle压缩包，放到用户目录下的.gradle/wrapper/dists对应文件夹中，跳过在线下载环节。

3. 调整启动参数 #

• 终止当前卡住的进程后，添加参数跳过jetifier步骤重试：
  npx react-native run-android --no-jetifier
  若项目无依赖旧Android Support库的第三方包，该参数可大幅减少前置处理时间。

4. 分步启动排查 #

• 先单独启动Metro服务：新开CMD窗口在项目根目录执行npm start，等待服务完全启动后，再开另一个窗口执行npx react-native run-android安装应用，可清晰区分是JS服务问题还是安卓安装包构建问题。

5. 缓存清理重试 #

如果以上步骤无效，清理所有构建缓存后重试：

cd android
./gradlew clean
cd ..
# Windows环境手动删除node_modules文件夹
rm -rf node_modules
npm install

内容的提问来源于stack exchange，提问作者mohammad amini nasab