watchOS应用预览报错：找不到QuartzCore模块，构建正常如何解决？

核心原因 #

QuartzCore框架不支持watchOS，Lottie的部分代码在预览环境下未做平台适配；同时FirebaseAnalyticsSwift的预览构建产物缺失，导致预览流程失败。

解决步骤 #

1. 修复Lottie的平台适配问题

   • 确认使用的Lottie版本支持watchOS（推荐v4.0+），版本过低则升级到最新稳定版。
   • 若用Swift Package Manager，在Xcode的Package Dependencies中配置Lottie时，确保勾选watchOS目标；若用CocoaPods，在Podfile中明确指定watchOS平台：

     target 'TestApp Watch App' do
       platform :watchos, '9.0' # 替换为你的最低支持版本
       pod 'lottie-ios', '~> 4.4.0'
     end
     

   • 若Lottie源码存在硬编码的import QuartzCore，可临时添加条件编译（仅作临时方案，优先升级依赖）：

     #if !os(watchOS)
     import QuartzCore
     #endif
     

2. 清理构建缓存并重启Xcode

   • 删除指定的Derived Data文件夹：

     rm -rf /Users/msy/Library/Developer/Xcode/DerivedData/TestApp-gkorwbacqzvxvgcmrpdkaxfxnnmu
     

   • 完全退出Xcode，重新打开项目后尝试生成预览。

3. 修复FirebaseAnalyticsSwift的预览构建问题

   • 升级Firebase到最新稳定版，确保FirebaseAnalyticsSwift支持watchOS预览。
   • 重新安装依赖：SPM点击File > Packages > Update to Latest Package Versions；CocoaPods执行pod install --repo-update。

4. 验证预览目标配置

   • 在Xcode预览面板中，确认预览目标设备为watchOS模拟器/设备，而非iOS目标。
   • 检查watch App目标的Build Settings，确保Supported Platforms设置为watchOS，未错误引入iOS专属依赖。

5. 检查SPM依赖的构建目标

   • 进入项目设置的Package Dependencies，点击Lottie和Firebase的Configure按钮，确保勾选对应watchOS版本的构建目标。

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