RN应用USB连接真机时installDebug卡在99%，模拟器运行正常

问题背景 #

React Native应用在模拟器上可正常运行，但通过USB连接真机安装时，进程卡在installDebug 99%，adb devices命令显示设备连接正常：

可行解决方案 #

• 确认设备USB调试授权
  解锁设备屏幕，重新插拔USB线，检查是否弹出调试授权弹窗，务必选择“允许”并勾选“始终允许此计算机”。

• 清理缓存与构建文件
  依次执行以下命令重置缓存并清理Android构建文件：

  npm start -- --reset-cache
  cd android && ./gradlew clean
  cd .. && npx react-native run-android
  

• 重启adb服务
  执行命令重启adb，排除连接异常：

  adb kill-server
  adb start-server
  adb devices
  

  确认设备仍在列表后，重新尝试安装。

• 检查设备存储空间
  设备剩余空间不足会导致安装中断，进入设备设置查看存储情况，确保至少有1GB以上可用空间。

• 调整Gradle构建配置
  打开android/app/build.gradle，在android块中添加堆内存配置，避免构建时内存不足：

  android {
      // 已有配置保留
      dexOptions {
          javaMaxHeapSize "4g"
      }
  }
  

  保存后重新执行安装命令。

• 尝试无线adb连接
  若USB连接问题持续，可切换至无线模式：

  1. 确保设备与Mac在同一局域网，获取设备IP（设置-关于手机-状态信息-IP地址）
  2. 执行命令：

     adb tcpip 5555
     adb connect [设备IP]:5555
     

  3. 断开USB线，运行npx react-native run-android完成安装。

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