升级Expo与React Native后Hermes引擎VisionOS配置致pod install失败

问题背景 #

通过npx expo-doctor将Expo升级至51.0.28、React Native升级至0.74.5后，执行pod install时出现错误：

在ios目录执行pod install时出错，原因是加载hermes-engine podspec失败，提示undefined method 'visionos' for #<Pod::Specification name="hermes-engine/Pre-built">，对应文件路径/Users/my-project/node_modules/react-native/sdks/hermes-engine/hermes-engine.podspec第47行的ss.visionos.vendored_frameworks配置。

已尝试操作：

• 删除node_modules和ios目录后重新安装依赖
• 将React Native升级至0.75.0版本
  以上操作均未解决问题。

可行解决方案 #

1. 升级CocoaPods版本 #

visionos是CocoaPods 1.12.0及以上版本才支持的平台属性，旧版本CocoaPods无法识别该字段。执行命令升级：

sudo gem install cocoapods

升级完成后进入ios目录重新执行pod install。

2. 临时修改hermes-engine.podspec文件 #

若暂时无法升级CocoaPods，可临时注释掉visionos相关配置：

1. 打开/Users/my-project/node_modules/react-native/sdks/hermes-engine/hermes-engine.podspec
2. 定位到第47行左右的ss.visionos.vendored_frameworks = "destroot/Library/Frameworks/Hermes.xcframework"
3. 添加#前缀注释该行，或直接删除
4. 保存文件后重新执行pod install

注意：此修改为临时方案，后续重新安装依赖时会被覆盖，优先推荐升级CocoaPods。

3. 清除Expo缓存并修复依赖 #

若升级过程中存在缓存冲突，执行以下命令：

npx expo install --fix
rm -rf ~/.expo/cache

完成后再尝试启动项目或执行pod install。

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