依赖UIKit的iOS专属SPM包导致watchOS SwiftUI预览构建失败

这大概率是项目配置问题，而非Xcode bug，以下是具体排查和解决步骤：

• 精准控制SPM包的平台关联
  对于依赖UIKit的iOS专属包，确保它们只关联到iOS目标：

  1. 打开Xcode的File > Add Packages...，找到对应的第三方包
  2. 在添加界面的Add to Target下拉列表中，只勾选iOS项目目标，不要选中WatchKit Extension目标
  3. 如果第三方包本身的Package.swift没做平台限制，你可以手动在项目的SPM依赖设置里，给这些包指定仅支持iOS（在包的Platforms设置里取消watchOS的勾选）

• 检查WatchKit Extension的依赖清单
  确认WatchKit Extension目标的Frameworks, Libraries, and Embedded Content和Build Phases > Link Binary With Libraries中，只包含支持watchOS的SPM包，若有iOS专属包混入，直接移除。

• 清理Xcode缓存
  执行Product > Clean Build Folder（快捷键Cmd+Shift+K），然后重启Xcode，再尝试预览。缓存残留可能导致Xcode误判依赖链。

• 确认预览代码的目标正确性
  在watchOS的SwiftUI预览代码中，确保指定的是watchOS设备，比如：

  struct MyWatchView_Previews: PreviewProvider {
      static var previews: some View {
          MyWatchView()
              .previewDevice("Apple Watch Series 8")
      }
  }
  

为什么不是Xcode bug？ #

Xcode的SwiftUI预览会基于当前目标的完整依赖链构建，但如果SPM包的平台限制配置不清晰，或者项目中错误地将iOS专属包与watchOS目标建立了关联，Xcode就会尝试为watchOS构建这些不兼容的包——这是依赖管理的预期行为，而非bug。

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