Objc框架中Swift类仅iOS模拟器报错：无法找到Swift声明

我之前也碰到过几乎一模一样的问题，折腾了好一阵才理清原因，给你几个针对性的排查和解决步骤：

• 检查框架的Swift编译核心配置
  这是最容易出问题的地方，要确保框架的Build Settings里以下配置在真机和模拟器的所有配置项中保持一致：

  • 把 Defines Module 设置为 YES，这是Swift类能被Objective-C框架正确暴露的前提
  • 确认 Swift Language Version 统一（比如都设为Swift 5.x），别真机和模拟器用不同的Swift版本
  • 开启 Install Objective-C Compatibility Header，并确认 Objective-C Generated Interface Header Name（格式一般是YourFrameworkName-Swift.h）的路径正确，Objective-C代码必须通过这个头文件才能访问Swift类

• 验证框架的架构支持完整性
  模拟器和真机用的是不同架构（旧版模拟器是x86_64，M系列Mac的模拟器是arm64，真机是arm64），要确保框架编译时包含了模拟器所需的架构：

  • 终端里执行命令 lipo -info YourFramework.framework/YourFramework，查看输出的架构列表，确认包含模拟器对应的架构
  • 如果缺少架构，在框架的Build Settings里把 Build Active Architecture Only 设为 NO（Debug模式下可能默认是YES，会导致只编译当前设备的架构），或者手动在 Architectures 中添加对应的架构

• 确认Swift类的暴露方式正确
  Swift类要被Objective-C访问，必须满足两个条件：

  • 类必须继承自 NSObject
  • 类本身用 @objcMembers 修饰，或者类和需要暴露的方法/属性单独加 @objc 标记，比如：

    @objcMembers
    class SwiftClass: NSObject {
        // 你的类实现
    }
    

• 彻底清理编译缓存
  模拟器的编译缓存经常会搞出奇怪的问题，试试这套组合拳：

  • 用 Command + Shift + K 清理项目
  • 打开Xcode的 Settings -> Locations -> Derived Data，点击路径旁的箭头删除整个Derived Data文件夹
  • 重启Xcode和模拟器，然后重新编译框架和主项目

• 检查框架的Embed配置
  在主项目的 General -> Frameworks, Libraries, and Embedded Content 里，确保你的框架设置为 Embed & Sign，并且真机和模拟器的配置完全一致。如果模拟器的Embed配置没正确设置，框架的Swift部分可能无法被正确加载。

按照这些步骤一步步排查，应该能解决模拟器找不到Swift类的问题。我当时是因为框架的Defines Module在模拟器配置里被不小心改成了NO，改回来就正常了。

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