为iOS实体设备构建React Native应用时Hot Code Reload失效

问题概述 #

• 环境：React Native 0.69.9（已集成React-Codegen Pod修复），Xcode 14.3（14E222b）+ 对应版本命令行工具，ios-deploy v1.12.1（brew安装），已修改frameworks.sh中source="$(readlink -f "${source}")"
• 异常现象：通过USB-C连接iOS实体设备时，热重载（HCR）完全失效——按下R键或修改代码后，Metro Bundler无任何重载反应；但iOS/Android模拟器、Android实体设备上HCR正常工作
• 构建时警告：执行react-native run-ios --device完成构建即将安装应用前，终端输出：

  xcodebuild[10046:322251] DVTCoreDeviceEnabledState: DVTCoreDeviceEnabledState_Disabled set via user default (DVTEnableCoreDevice=disabled)
  xcodebuild[10046:322374] Requested but did not find extension point with identifier Xcode.InterfaceBuilderBuildSupport.PlatformDefinition
  

• 已排查操作：确认设备与Mac在同一Wi-Fi网络，尝试修改Podfile的SWIFT_VERSION为5.0、检查IP/端口配置，均无效果；更新Xcode前HCR正常，且无法回退旧版Xcode

解决方案 #

1. 启用Xcode CoreDevice（解决第一个警告） #

Xcode 14.3默认可能禁用了CoreDevice，导致设备连接异常：

• 打开Xcode，进入Xcode > Settings > Locations，确认Command Line Tools选中Xcode 14.3
• 在终端执行命令启用CoreDevice：

  defaults write com.apple.dt.Xcode DVTEnableCoreDevice -bool true
  

• 完全关闭Xcode和Metro Bundler，重新启动

2. 强制Metro绑定Wi-Fi IP地址 #

Metro可能自动绑定了错误的网络接口（如USB虚拟接口），需手动指定Mac的Wi-Fi IP：

• 先在终端启动Metro并指定主机IP：

  npx react-native start --host YOUR_MAC_WIFI_IP
  

  （替换YOUR_MAC_WIFI_IP为Mac的实际Wi-Fi地址，可通过ifconfig en0或系统偏好设置查看）
• 打开新终端窗口，执行真机构建命令并同步主机IP：

  npx react-native run-ios --device --host YOUR_MAC_WIFI_IP
  

3. 配置iOS项目网络权限 #

确保应用有权访问本地网络用于热重载：

• 打开Xcode项目中的Info.plist，添加以下配置：
  • 新增App Transport Security Settings字典，添加子项Allow Arbitrary Loads并设为YES（仅调试阶段使用，发布时需关闭）
  • 新增NSLocalNetworkUsageDescription字符串，内容可填"需要访问本地网络以实现代码热重载"

4. 重置依赖工具与Pods #

• 卸载重装ios-deploy，修复可能的版本兼容性问题：

  brew uninstall ios-deploy && brew install ios-deploy
  

• 进入iOS目录清理并重新安装Pods：

  cd ios
  pod deintegrate
  pod install --repo-update
  cd ..
  

5. 手动配置Bundler连接 #

如果自动连接失败，可手动指定设备端的Bundler地址：

• 启动Metro时指定端口（默认8081）：

  npx react-native start --port 8081 --host YOUR_MAC_WIFI_IP
  

• 在iOS真机上打开应用，摇晃设备调出开发者菜单，选择Configure Bundler，输入Mac的Wi-Fi IP和端口8081，点击Connect

关于构建警告的说明 #

• 第一个DVTCoreDeviceEnabledState警告：通过步骤1的命令即可完全解决
• 第二个Xcode.InterfaceBuilderBuildSupport.PlatformDefinition警告：属于Xcode 14.3的已知兼容性问题，不影响应用功能与热重载，可忽略

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