如何在XCode Previews中忽略不支持iOS模拟器的Pods/框架？

针对你的场景，有几种可行方案能让Preview正常工作，同时保留框架对核心功能的支持：

1. 用条件编译隔离框架依赖代码 #

将所有依赖该框架的代码用目标环境宏包裹，让模拟器（Preview运行环境）跳过这部分代码的编译，并提供预览用的模拟实现：

// 仅在真机环境引入框架
#if !targetEnvironment(simulator)
import 不支持模拟器的框架名
#endif

class FeatureViewModel: ObservableObject {
    // 真机环境初始化框架服务，模拟器环境跳过
    #if !targetEnvironment(simulator)
    private let frameworkService = FrameworkService()
    #endif
    
    func executeFeature() {
        #if !targetEnvironment(simulator)
        frameworkService.runCoreLogic()
        #else
        // 预览时的模拟逻辑，保证视图能正常渲染
        print("模拟执行核心功能")
        // 也可以更新视图绑定的状态变量，让预览显示真实的UI反馈
        self.isCompleted = true
        #endif
    }
}

这样Preview运行时不会加载框架代码，也就不会触发不兼容模拟器的报错，同时预览视图能获得完整的逻辑支撑。

2. 通过CocoaPods条件安装框架 #

如果该框架是通过CocoaPods管理的，可以在Podfile中设置仅在真机环境安装：

target 'YourApp' do
  # 仅当当前平台不是模拟器时，安装框架
  if ENV['PLATFORM_NAME'] != 'iphonesimulator'
    pod '不支持模拟器的框架名'
  end
end

执行pod install时，模拟器环境不会拉取该框架。注意：真机开发前需要重新执行pod install（确保终端环境的PLATFORM_NAME对应真机），同时项目中依赖框架的代码仍需配合条件编译，避免真机编译报错。

3. 拆分Target隔离核心功能模块 #

把依赖该框架的20%功能拆成独立的Target（比如一个专用Framework）：

• 创建新的Framework Target（如CoreFeatureModule），仅在这个Target中引入不支持模拟器的框架
• 主App Target仅在真机环境依赖CoreFeatureModule，模拟器环境不依赖
• Preview仅使用主App Target中不涉及CoreFeatureModule的代码，或者给Preview提供CoreFeatureModule的模拟实现

这种方案适合功能边界清晰的场景，能彻底隔离框架对Preview的影响，同时保证真机环境的功能完整性。

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