Swift扩展放独立Target中接口未被调用的问题排查

我有一个属于Target 1的SceneDelegate类，Target 1被编译为静态库：

public class SceneDelegate: UIResponder, UIWindowSceneDelegate {

    public var window: UIWindow?

    // SceneDidBecomeActive
    // other lifecycle events
}

该SceneDelegate在Target 1的AppDelegate的configurationForConnecting方法中通过代码赋值：

config = UISceneConfiguration(name: nil, sessionRole: connectingSceneSession.role)
                                    
// Set the scene delegate
config.delegateClass = SceneDelegate.self

现在我在Target 2中编写了SceneDelegate的扩展，并在其中定义了willConnectTo方法，Target 2同样被编译为静态库：

extension SceneDelegate {

    public func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {

        // ...

    }

    // Also has sceneDidDisconnect
}

App Target已将Target 1和Target 2添加到“Link Binary with Libraries”中。运行应用时，Target 2中的willConnectTo从未被调用，但Target 2中的其他代码可正常执行，Target 1中的SceneDidBecomeActive等生命周期方法可正常触发。请问这种使用扩展的方式存在什么限制吗？

回答 #

核心限制原因 #

• Objective-C运行时兼容性问题：UIKit的场景生命周期方法依赖Objective-C的消息发送机制触发。Swift扩展中的方法默认不会暴露给Objective-C运行时，而UIWindowSceneDelegate的协议方法本质是Objective-C协议方法，UIKit会通过Objective-C运行时检查委托实例是否响应对应选择器。如果扩展方法没有显式标记@objc，运行时会认为该方法不存在。
• 静态库死代码剥离：Target 2作为静态库，如果其中的扩展代码没有被App Target直接引用（比如没有其他代码主动调用扩展里的方法），Xcode的**死代码剥离（Dead Code Stripping）**会将这部分未被引用的代码从最终可执行文件中移除，导致运行时找不到对应的生命周期方法。
• 可选协议方法的实现规则：scene(_:willConnectTo:options:)是UIWindowSceneDelegate的可选方法，当主类中没有实现该方法时，UIKit只会检查实例是否通过Objective-C运行时暴露了该方法。扩展方法若未满足可见性要求，自然不会被触发。

可行解决办法 #

1. 给扩展方法添加@objc标记：确保方法暴露给Objective-C运行时，让UIKit能找到并调用：

extension SceneDelegate {

    @objc public func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
        // ...
    }

    @objc public func sceneDidDisconnect(_ scene: UIScene) {
        // ...
    }
}

2. 避免死代码剥离：要么在App Target中显式引用Target 2的扩展代码（比如在某个初始化方法中调用_ = SceneDelegate().sceneDidDisconnect(nil)），让链接器认为这部分代码有用；要么临时关闭Target 2的Dead Code Stripping选项（不推荐，会增加包体积）。
3. 主类添加空实现：在Target 1的SceneDelegate类中添加这些生命周期方法的空实现，再在扩展中重写。这样既保证方法在运行时存在，也能让扩展代码被正确调用：

// Target 1中的SceneDelegate
public class SceneDelegate: UIResponder, UIWindowSceneDelegate {

    public var window: UIWindow?

    public func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {}

    public func sceneDidDisconnect(_ scene: UIScene) {}

    // SceneDidBecomeActive等其他方法
}

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