12-6.【OC】【Swift+OC 混编】Generated Header 是如何生成的？

在 Swift 与 Objective-C 的混编体系中，Generated Header（即著名的 ProjectName-Swift.h）并不是一个简单的文本拷贝，而是由 Swift 编译器（swiftc） 在构建过程中通过 抽象语法树（AST）分析 动态生成的映射文件。

以下是它的生成逻辑与底层机制：

---

1. 生成触发机制：三步走策略

编译器在处理带有 @objc 标记的代码时，会经历以下阶段：

1. AST 解析：编译器扫描所有的 .swift 源文件，构建抽象语法树（Abstract Syntax Tree）。
2. 符号筛选：编译器遍历 AST，寻找所有标记为 @objc、@objcMembers，或者继承自 NSObject 且具备暴露资格的类、协议、属性和方法。
3. 接口转译：将 Swift 的静态类型、参数标签和命名空间转化为 Objective-C 的语法（如 NSString、NSInteger、NS_ENUM 等）。

---

2. 映射逻辑：Swift 到 OC 的“降级”

Generated Header 的本质是将 Swift 的现代特性“翻译”回 OC 能理解的陈旧格式。

• 属性转换：Swift 的 var 映射为 @property，let 映射为 readonly 属性。

• 方法重命名：Swift 的多参数方法会按照 OC 的 Selector 习惯重排。

  • Swift: func save(record: Data, for user: User)
  • OC: - (void)saveRecord:(NSData *)record forUser:(User *)user;

• 安全性标记：编译器会根据 Swift 的 Optional 自动添加 _Nullable 或 _Nonnull 宏。

---

3. 构建配置：它是如何被定位的？

你不需要手动创建这个 .h 文件，它存在于派生数据目录（Derived Data）中。其生成受构建设置（Build Settings）控制：

• SWIFT_OBJC_INTERFACE_HEADER_NAME：定义了生成的文件名（默认是 $(SWIFT_MODULE_NAME)-Swift.h）。
• Install Objective-C Compatibility Header：必须设置为 YES，编译器才会执行生成动作。

---

4. 增量更新与模块隔离

为了防止编译循环（Circular Dependency），Generated Header 采用了模块化的处理方式：

• 模块导入：Generated Header 顶部通常会自动包含 @import Foundation; 和 @import UIKit;。
• 前向声明（Forward Declarations） ：为了处理类之间的互相引用，编译器在 Header 中大量使用 @class MySwiftClass; 这种前向声明，而不是直接递归导入，以避免头文件冲突。

---

5. 局限性：什么不会出现在 Header 中？

如果某些 Swift 代码无法在 OC 中表达，编译器会保持沉默（直接跳过）：

• 不带 @objc 的泛型类：因为 OC 无法理解 Swift 的泛型元数据。
• 带关联值的枚举：OC 的枚举只能是整数，无法映射 Swift 的复杂枚举。
• Struct 和 Tuple：OC 运行时不支持 Swift 的值类型。
• Swift 特有的访问级别：标记为 fileprivate 或 private 的成员永远不会出现在 Header 中。

---

💡 核心避坑指南

当你修改了 Swift 代码但 OC 端报错“找不到方法”时，通常是因为：

1. 你忘了加 @objc。
2. 你的参数类型（如自定义 Struct）无法映射，导致整个方法被编译器从 .h 中剔除。