升级Xcode 16.1后Expo iOS应用无法构建,求助解决方案
解决Xcode 16.1升级后Expo iOS构建失败问题
问题症状
升级Xcode到16.1后,Expo应用构建失败,关键报错包括:
- 忽略重复库
-lc++ - 找不到自动链接的
CoreAudioTypes框架 - 无法直接链接
SwiftUICore - arm64架构下缺失
absl::lts_20240116::CHexEscape符号 - 最终
xcodebuild退出码65
已尝试清理Pods、删除派生数据、重装node_modules,无效。
解决方案
1. 锁定grpc依赖版本适配Xcode 16.1
报错里的absl符号缺失来自grpc,Xcode 16.1对C++标准库的处理有变化,需要指定兼容版本:
- 用yarn的话,在项目根目录
package.json中添加resolutions:
"resolutions": { "@grpc/grpc-js": "1.10.9", "grpc": "1.24.11" }
- 用npm的话,在
package.json里添加overrides:
"overrides": { "@grpc/grpc-js": "1.10.9", "grpc": "1.24.11" }
- 执行
yarn install或npm install重新安装依赖
2. 手动处理CoreAudioTypes框架链接
Xcode 16.1自动链接逻辑出错,手动添加框架:
- 打开iOS项目的
ios/[项目名].xcworkspace - 选中主target,进入Build Phases > Link Binary With Libraries
- 点击
+,搜索CoreAudioTypes.framework并添加 - 将该框架的Status设为
Optional(避免真机/模拟器差异)
3. 禁用SwiftUICore的自动链接
报错提示无法直接链接SwiftUICore,通过Podfile配置阻止自动链接:
- 在
ios/Podfile中添加:
post_install do |installer| installer.pods_project.targets.each do |target| if target.name == '你的Expo项目target名' target.build_configurations.each do |config| config.build_settings['OTHER_LDFLAGS'] ||= [] config.build_settings['OTHER_LDFLAGS'] << '-weak_framework' << 'SwiftUICore' end end end end
- 执行
cd ios && pod install && cd ..重新安装Pods
4. 更新Expo SDK到兼容版本
Xcode 16.1需要较新的Expo SDK支持,建议升级到51或更高版本:
- 运行
expo upgrade升级SDK - 按提示完成依赖更新和配置调整
5. 清理深层缓存
除常规操作外,清理这些缓存:
- 清理Expo缓存:
expo r -c - 清理Xcode缓存:
rm -rf ~/Library/Caches/com.apple.dt.Xcode - 清理CocoaPods缓存:
pod cache clean --all
验证步骤
- 执行完所有清理和更新后,运行
expo prebuild --clean重新生成iOS项目 - 尝试构建:
expo run:ios或直接在Xcode中构建
内容的提问来源于stack exchange,提问作者robo
相关产品推荐
相关产品推荐

