React Native项目执行react-native run-android后Android Studio模拟器不显示应用

1. 确认构建过程无错误 #

• 执行react-native run-android时，完整检查终端输出日志，是否存在BUILD FAILED类的构建失败提示，若有报错优先处理对应问题（常见为gradle版本不兼容、依赖包缺失）

2. 检查Metro服务运行状态 #

• 正常执行react-native run-android时会自动拉起Metro打包服务终端窗口，若该窗口被关闭或启动失败，应用将无法完成加载
• 若Metro未启动，先在项目根目录新开终端执行npx react-native start保持后台运行，再开另一终端执行npx react-native run-android重试

3. 验证应用安装状态 #

• 打开模拟器的全部应用列表，查找对应项目的应用图标：
  • 若图标存在，手动点击打开，若出现红屏报错，基本为Metro服务连接异常导致
  • 若图标不存在，说明应用未完成安装，按以下步骤清理缓存重试：
    • 进入项目android目录，Windows环境执行gradlew clean清理本地构建缓存
    • 关闭模拟器，在Android Studio的AVD管理器中选中对应模拟器，执行Wipe Data清除模拟器数据后重启
    • 重新执行react-native run-android

4. 校验环境变量配置 #

• 除ANDROID_HOME外，需确认%ANDROID_HOME%\platform-tools路径已添加到系统Path变量中，配置完成后重启VS Code终端再操作

5. 低版本RN兼容处理 #

• 若使用0.60以下的React Native版本，模拟器启动后手动执行adb reverse tcp:8081 tcp:8081配置端口反向代理，再重新运行应用

内容的提问来源于stack exchange，提问作者Hacker Rhino