React Native执行run-android时安装APP失败如何修复？

问题场景 #

首次安装Node.js、Android Studio，按React Native安卓开发流程依次执行以下命令后启动失败，目标是实现安卓端实时编码开发：

• npx react-native init 'app'
• cd app
• npx react-native run-android
  报错截图

排查修复步骤 #

按顺序操作，每完成一步重新执行npx react-native run-android验证是否修复：

• 配置安卓环境变量
  打开系统环境变量设置页，新增系统变量ANDROID_HOME，值为本地Android SDK的存储路径（默认路径为C:\Users\你的系统用户名\AppData\Local\Android\Sdk）；随后在系统Path变量中新增4个条目：
  • %ANDROID_HOME%\platform-tools
  • %ANDROID_HOME%\emulator
  • %ANDROID_HOME%\tools
  • %ANDROID_HOME%\tools\bin
    配置完成后关闭所有终端窗口重新打开，执行adb version，正常返回版本号即为配置生效。
• 确认运行设备在线
  执行adb devices查看已连接设备：
  • 用模拟器调试的，提前在Android Studio的AVD Manager中启动对应模拟器，等待模拟器完全加载完成后再执行启动命令
  • 用真机调试的，打开手机开发者选项、开启USB调试，用数据线连接电脑，确认弹出的授权窗口点击允许
    没有任何在线设备时，run-android命令必然报错
• 修复Gradle构建失败问题
  首次构建需要下载Gradle及相关依赖，网络异常会直接构建失败：
  • 打开项目内android/gradle/wrapper/gradle-wrapper.properties文件，确认distributionUrl对应的Gradle版本可正常访问，可替换为国内镜像源地址加速下载
  • 打开项目内android/build.gradle文件，将默认的google、jcenter仓库源替换为国内可访问的Maven镜像地址
• 修正项目名冲突问题
  不要使用app作为React Native项目名——app是安卓构建的默认保留关键字，会引发构建路径冲突。如果前面的步骤都未解决问题，删除当前项目文件夹，重新执行初始化命令替换项目名，例如：npx react-native init MyFirstRNApp

实时开发配置 #

项目成功启动后，在运行终端按d唤起开发菜单，勾选*Fast Refresh（快速刷新）*选项，后续修改代码保存后会自动同步到设备，不需要重复执行启动命令。

内容的提问来源于stack exchange，提问作者Gabriel Patara