隔离 Objective-C API 以维护 iOS 混编开发的安全边界

在 iOS 混编开发中，流畅地结合 Swift 和 Objective-C 代码至关重要，而维护清晰的边界同样不可或缺。一个关键挑战是管理 Objective-C API 在 Swift 中的可用性。如果不小心，Objective-C 代码可能会意外暴露给 Swift，从而造成不一致和潜在的安全漏洞。

为此，Apple 引入了 NS_SWIFT_UNAVAILABLE 宏，作为维护 iOS 混编开发安全边界的强大工具。它使开发者能够限制 Objective-C API 在 Swift 中的可用性，防止它们意外使用。

何时使用 NS_SWIFT_UNAVAILABLE

使用 NS_SWIFT_UNAVAILABLE 的理想场景包括：

• 标记过时的 API： 当 Objective-C API 不再使用时，将其标记为 Swift 中不可用可以防止意外使用并鼓励采用推荐的替代方案。
• 隐藏内部实现： Objective-C 中某些内部实现细节可能不需要在 Swift 中公开。将其标记为不可用可以防止直接访问，保持代码库的清晰度和安全。
• 防止 Swift 中的意外使用： 当某些 API 仅适用于 Objective-C 时，将其标记为 Swift 中不可用可以防止意外使用，避免潜在的运行时错误和不一致。

使用 NS_SWIFT_UNAVAILABLE 的语法

NS_SWIFT_UNAVAILABLE 宏的使用方式如下：

NS_SWIFT_UNAVAILABLE("Swift 中不可用")

其中，引号内的消息是当尝试在 Swift 中访问不可用的 API 时显示的错误消息。

好处

使用 NS_SWIFT_UNAVAILABLE 提供了以下好处：

• 增强安全性： 限制 API 可用性有助于防止意外访问和滥用，从而增强代码库的安全性。
• 提高可维护性： 明确标记不可用的 API 使代码库更加清晰，更容易维护。
• 遵循最佳实践： 遵守 Apple 推荐的最佳实践可确保 iOS 混编开发的安全性和稳定性。

实践示例

考虑以下 Objective-C 头文件：

// MyHeader.h
@interface MyClass : NSObject
- (void)privateMethod;
@end

为了在 Swift 中隐藏 privateMethod，可以在头文件中使用 NS_SWIFT_UNAVAILABLE 如下所示：

// MyHeader.h
@interface MyClass : NSObject
- (void)publicMethod;
NS_SWIFT_UNAVAILABLE("Swift 中不可用")
- (void)privateMethod;
@end

现在，当尝试在 Swift 中访问 privateMethod 时，会引发错误消息：“Swift 中不可用”。