静态构建XCFramework时外部依赖导入失败问题求助

核心原因 #

静态构建的XCFramework不会将依赖的GenericPubSub、GenericAnalytics模块打包进去，而Swift的.swiftinterface文件会保留对这些模块的导入声明。当主工程通过CocoaPods集成时，若依赖模块的.swiftmodule没有被正确暴露给主工程的编译环境，就会触发No such module错误。

具体解决方案 #

1. 确认依赖库的构建兼容性 #

• 检查GenericPubSub和GenericAnalytics的podspec，确保它们支持静态构建（设置spec.static_framework = true），或同时兼容静态、动态模式。如果依赖库是动态框架，需确认主工程Podfile没有强制所有库静态化（比如use_frameworks! :linkage => :static会导致动态库无法被正确引用）。

2. 调整XCFramework的构建参数 #

构建MySDK时，在Xcode的Build Settings中做以下配置：

• 确保Build Libraries for Distribution设为YES（依赖模块也需开启该选项，否则无法生成可被外部引用的.swiftinterface）。
• 若为Release构建，在Other Swift Flags中添加-Xfrontend -embed-bitcode-marker，并保持依赖模块的构建参数与MySDK一致。
• 在Xcode的Frameworks, Libraries, and Embedded Content中，将依赖库设置为Do Not Embed（静态依赖无需嵌入主工程）。

3. 优化Podspec配置 #

除声明spec.dependency外，补充以下配置确保依赖模块的接口能被主工程访问：

# 声明当前SDK为静态框架
spec.static_framework = true

# 配置Pod目标的编译参数，指定依赖模块的搜索路径
spec.pod_target_xcconfig = {
  'SWIFT_INCLUDE_PATHS' => '$(PODS_ROOT)/GenericPubSub/** $(PODS_ROOT)/GenericAnalytics/**',
  'OTHER_SWIFT_FLAGS' => '-Xcc -I$(PODS_ROOT)/GenericPubSub/include -Xcc -I$(PODS_ROOT)/GenericAnalytics/include'
}

# 配置主工程目标的编译参数，同步依赖搜索路径
spec.user_target_xcconfig = {
  'SWIFT_INCLUDE_PATHS' => '$(PODS_ROOT)/GenericPubSub/** $(PODS_ROOT)/GenericAnalytics/**'
}

4. 验证依赖模块的必要文件存在 #

检查GenericPubSub和GenericAnalytics的Pod包中，是否包含对应架构的.swiftmodule文件（如ios-arm64/GenericPubSub.swiftmodule）。若依赖库是纯Objective-C编写，需确保其生成了.modulemap文件，且Podspec中通过spec.module_map声明了文件路径。

5. 清理缓存重新构建 #

• 删除主工程的Pods文件夹和Podfile.lock，执行pod install重新安装依赖。
• 执行Xcode的Product > Clean Build Folder清理缓存，重启Xcode后重新构建主工程。

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