You need to enable JavaScript to run this app. Xcode运行Quick与Nimble测试突然报错:无法构建Quick Objective-C模块
优惠活动
大模型
产品
解决方案
定价
更多

Xcode运行Quick与Nimble测试突然报错:无法构建Quick Objective-C模块

Quick 编译报 umbrella 头文件找不到的修复步骤

按操作优先级从高到低执行,通常第一步即可解决绝大多数场景的问题:

  • 清理本地构建缓存与Pods残留
    1. 完全退出Xcode
    2. 终端切换到项目根目录,执行命令清理残留产物:
      rm -rf Pods Podfile.lock
      rm -rf ~/Library/Developer/Xcode/DerivedData/
      
    3. 强制更新Pod索引后重新安装依赖:
      pod install --repo-update
      
    4. 重新打开项目编译测试目标
  • 修正架构构建配置
    清理后仍报错时,检查目标架构设置:
    1. 打开项目Build Settings面板,定位Excluded Architectures配置项
    2. 确认Debug配置下的iphonesimulator平台没有错误排除arm64架构——旧版Quick的podspec未正确适配Apple Silicon模拟器架构,会直接导致头文件输出路径错位
    3. 检查测试target的Link Binary With Libraries阶段,确保没有手动重复添加Quick、Nimble的framework引用,避免与CocoaPods的自动注入逻辑冲突
  • 校验公共头文件输出路径
    针对路径匹配异常的场景,手动检查Pods工程配置:
    1. 打开Pods.xcodeproj,选中Quick对应的target
    2. 进入Build Settings,定位Public Headers Folder Path配置,确保值为$(TARGET_BUILD_DIR)/Quick.framework/Headers
    3. 编译Quick target,确认生成的Quick-umbrella.h确实输出到上述配置路径下
  • 升级CocoaPods版本
    旧版CocoaPods在生成静态库模块映射文件时存在路径计算bug,升级到最新正式版即可修复:
    sudo gem install cocoapods
    

内容的提问来源于stack exchange,提问作者SRed

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 11:45:04