多包项目中Xcode Preview因链接错误构建失败求助

架构老林

2026-6-26

解决方案

检查HCPUtilities包的构建配置：
- 打开HCPUtilities的Package项目，进入Build Phases → Link Binary With Libraries，确认CoreAudioTypes.framework已添加且状态为Required，缺失的话手动搜索添加。
- 查看Build Settings → Swift Compiler - Custom Flags，排查是否存在-hidden-symbol类的编译标记，这类标记会导致hideKeyboard()扩展符号无法正常导出。
确认工作区内Package依赖关联正确性：
- 打开主iOS应用的项目设置，进入Package Dependencies，确保HCPUtilities是指向工作区内的本地包，而非远程SPM源。
- 检查依赖HCPUtilities的目标Package的Package.swift，确认依赖路径正确：
```
dependencies: [
    .package(path: "../HCPUtilities") // 路径需匹配工作区内的相对位置
]
```
彻底清理构建缓存：
- 按Command + Shift + K清理当前目标产物，再按Command + Option + Shift + K清理全工作区缓存。
- 终端执行rm -rf ~/Library/Developer/Xcode/DerivedData删除全局DerivedData，之后重启Xcode。
调整SwiftUI预览目标：
- 打开报错的SwiftUI预览文件，确认右上角预览目标选择的是主iOS应用目标，而非单独的Package目标（单独Package预览可能缺失主应用的CocoaPods/SPM依赖上下文）。
- 若需单独预览Package，在HCPUtilities的Package.swift中给target添加链接配置：
```
targets: [
    .target(
        name: "HCPUtilities",
        linkerSettings: [
            .linkedFramework("CoreAudioTypes")
        ]
    )
]
```
对比版本控制的配置差异：
- 和同事同步.xcworkspace、各Package.swift及*.xcodeproj文件，排查是否有本地配置变更导致依赖关联异常。