Objective-C项目中如何阻止Swift扩展被导出到-Swift.h头文件？

针对你遇到的问题——Swift类中遵循第三方Swift框架协议的扩展被自动导出到-Swift.h头文件，导致Objective-C导入时找不到协议定义，这里有几个可靠的解决方案：

方法一：使用私有代理类隔离协议遵循（推荐） #

既然这些协议仅在Swift内部使用，完全不需要暴露给Objective-C，最彻底的方式是创建一个私有代理类来承载协议的实现，让主类无需直接遵循这些协议。这样既满足了Swift内部的协议需求，又不会让任何协议相关代码被导出到-Swift.h。

示例代码：

// 你的主Swift类，无需遵循MessagingDelegate/MessagingNotificationDelegate
@objc class MessagingExperience: NSObject {
    // 创建私有代理对象，负责实现协议
    private let messagingProxy = MessagingProxy()
    
    func setupMessaging() {
        // 在需要设置代理的地方，使用这个私有代理
        MessagingFramework.shared.delegate = messagingProxy
        MessagingFramework.shared.notificationDelegate = messagingProxy
    }
}

// 私有类，仅当前文件可见，不会被导出到-Swift.h
private class MessagingProxy: NSObject, MessagingDelegate, MessagingNotificationDelegate {
    // 实现所有协议方法
    func messagingObseleteVersion(_ error: Error) {
        // 你的逻辑
    }
    
    func messagingError(_ error: Error) {
        // 你的逻辑
    }
    
    func shouldShowMessagingNotification(with notification: MessagingNotification) -> Bool {
        // 你的逻辑
        return true
    }
    
    func messagingNotificationTapped(_ notification: MessagingNotification) {
        // 你的逻辑
    }
    
    func customMessagingNotificationView(with notification: MessagingNotification) -> UIView {
        // 你的逻辑
        return UIView()
    }
}

这个方法的优势是完全隔离了Swift内部的协议实现，Objective-C端看不到任何相关的协议或方法，从根源上解决了编译错误。

方法二：通过@nonobjc和@objc组合标记扩展 #

如果你一定要让主类直接遵循协议，可以尝试在扩展上标记@nonobjc，同时为每个协议方法单独标记@objc——这样既满足了协议对方法的@objc要求，又阻止整个扩展被导出到-Swift.h。

示例代码：

@nonobjc extension MessagingExperience: MessagingDelegate {
    @objc func messagingObseleteVersion(_ error: Error) {
        // 你的逻辑
    }
    
    @objc func messagingError(_ error: Error) {
        // 你的逻辑
    }
}

@nonobjc extension MessagingExperience: MessagingNotificationDelegate {
    @objc func shouldShowMessagingNotification(with notification: MessagingNotification) -> Bool {
        // 你的逻辑
        return true
    }
    
    @objc func messagingNotificationTapped(_ notification: MessagingNotification) {
        // 你的逻辑
    }
    
    @objc func customMessagingNotificationView(with notification: MessagingNotification) -> UIView {
        // 你的逻辑
        return UIView()
    }
}

注意：部分旧版本Xcode可能仍会出现警告，但这个标记组合通常能阻止扩展被导出到-Swift.h。如果这个方法对你无效，推荐优先使用方法一。

为什么之前的尝试无效？ #

• private/fileprivate修饰扩展：由于协议是第三方框架的公开协议，扩展的访问级别无法低于协议方法的访问级别，因此会编译报错。
• 仅在扩展前加@nonobjc：协议要求方法必须是@objc可见的，因此会触发方法级别的警告，且编译器可能仍会导出协议一致性声明。

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