创建含依赖的xcframework时遇「No such module」错误求助

1. 确认XCFramework是否嵌入了依赖库 #

你的FirstFramework.xcframework在打包时，必须将MKRingProgressView的二进制文件一同嵌入。如果仅在Swift Package中声明依赖，但实际构建XCFramework时未把依赖包含进去，测试项目必然找不到该模块。

• 重新构建XCFramework时，在Build Phases的Link Binary With Libraries中添加MKRingProgressView，同时在Embed Frameworks中也添加它，并设置为Embed & Sign。

2. 修正Swift Package的Target依赖配置 #

当前的Swift Package配置里，binaryTarget未声明对MKRingProgressView的依赖关联，导致测试项目通过SPM引入你的框架时，不会自动拉取该依赖。需要在target定义中补充依赖：

targets: [
  .binaryTarget(
      name: "FirstFramework",
      path: "./Sources/FirstFramework.xcframework",
      dependencies: [
          .product(name: "MKRingProgressView", package: "MKRingProgressView")
      ])
]

这样SPM会自动为测试项目拉取并关联MKRingProgressView。

3. 检查XCFramework的模块定义文件 #

查看FirstFramework.xcframework内部的模块文件（Swift框架对应FirstFramework.swiftmodule，OC框架对应module.modulemap），确认是否包含对MKRingProgressView的引用。如果模块定义中未声明依赖，编译器无法识别该模块。

• 右键XCFramework文件选择「显示包内容」，进入对应平台的目录下查看模块文件的内容。

4. 统一测试项目的依赖管理方式 #

如果你的框架同时混用了CocoaPods和SPM，测试项目的依赖管理方式可能出现冲突：

• 若测试项目用CocoaPods，需在Podfile中同时添加你的框架和MKRingProgressView的依赖；
• 若测试项目用SPM，确保你的Swift Package配置正确，让SPM能自动解析所有层级的依赖。

5. 清理缓存后重新构建 #

缓存异常可能导致依赖解析失败，执行以下操作后重新构建：

• 用Cmd+Shift+K清理当前项目，再用Cmd+Option+Shift+K清理构建文件夹；
• 删除测试项目的DerivedData目录；
• 在Xcode中选择File > Packages > Reset Package Caches，重新拉取SPM依赖。

内容的提问来源于stack exchange，提问作者Tomás Moyano