React Native run-android卡在97%:app:installDebug问题求助

一、彻底搞定所有RN项目的JVM版本不匹配问题 #

之前改单个项目的gradle-wrapper只能临时解决，要全局统一配置才能避免重复踩坑：

• 先查本地JDK版本，打开终端输java -version，确保是11或更高版本（毕竟Kotlin目标是11）
• 找到用户目录下的.gradle/gradle.properties文件（Windows在C:\Users\<你的用户名>\.gradle，Mac/Linux在~/.gradle），没有就新建一个，添加以下配置：

  org.gradle.java.home=/你的JDK11安装路径
  android.compileOptions.sourceCompatibility=11
  android.compileOptions.targetCompatibility=11
  kotlin.jvmTarget=11
  

  把路径换成实际的，比如Windows可能是C:\Program Files\Java\jdk-11.0.17，Mac是/Library/Java/JavaVirtualMachines/jdk-11.jdk/Contents/Home
• 这样所有RN项目都会自动用统一的JVM版本，不用逐个改了

二、解决:app:installDebug卡顿和Emulator Console启动失败问题 #

针对5554端口的报错，按下面的步骤挨个试：

1. 重启adb和模拟器
   • 终端输adb kill-server，再输adb start-server重启adb服务
   • 打开Android Studio的AVD管理器，删掉当前出问题的模拟器，重新建一个（选带Google Play的稳定系统镜像，比如Android 12/13）
2. 修改模拟器端口避开冲突
   • 找到模拟器的配置文件，路径是~/.android/avd/<模拟器名字>.avd/config.ini（Windows在C:\Users\<你的用户名>\.android\avd\<模拟器名字>.avd）
   • 找到port=5554改成port=5556，grpc.port=8554改成grpc.port=8556，保存后重启模拟器
3. 分开启动打包和安装
   • 先开一个终端输npx react-native start启动metro服务
   • 再开另一个终端输react-native run-android --no-packager，避免打包和安装抢资源导致卡顿
4. 检查防火墙/杀毒软件
   • 临时关掉防火墙或杀毒软件，看看是不是它们拦截了5554端口的通信
5. 换真机测试
   • 如果模拟器死活搞不定，直接连安卓真机（开开发者模式和USB调试），输react-native run-android，真机安装基本不会有端口问题

内容的提问来源于stack exchange，提问作者Marco Di Loreto