XCode Preview报错keyWindow访问器多处冲突的原因与修复方案

触发这个编译错误的核心是符号命名冲突：

• 从iOS 15版本开始，苹果官方已经在UIApplication的扩展中内置了同名的keyWindow计算属性，你从网络复制的代码又给UIApplication扩展添加了一个完全同名、同参数、同返回值的计算属性，相当于同一个类存在两份完全相同签名的属性访问器实现。
• Xcode 13.x版本的SwiftUI Preview编译链路不会做运行时的符号裁剪，编译预览模块时会同时加载系统内置的keyWindow实现和你自定义的实现，直接触发重复定义错误；正常真机/模拟器运行时，链接器可能会自动裁剪重复的系统符号，因此不一定会触发报错，这也是为什么只有开Preview才会出问题的原因。

以下两种方案都可以解决问题，优先推荐第一种：

• 方案1：重命名自定义属性（稳定性最高）
  直接把自定义的keyWindow属性修改为不会和系统属性冲突的名称，比如命名为activeKeyWindow，同步修改所有引用该属性的位置即可，修改后的完整代码如下：

extension UIApplication {
    
    var activeKeyWindow: UIWindow? {
        return UIApplication.shared.connectedScenes
            .filter { $0.activationState == .foregroundActive }
            .first(where: { $0 is UIWindowScene })
            .flatMap({ $0 as? UIWindowScene })?.windows
            .first(where: \.isKeyWindow)
    }
    
    var keyWindowPresentedController: UIViewController? {
        // 同步替换属性引用
        var viewController = self.activeKeyWindow?.rootViewController
        
        if let presentedController = viewController as? UITabBarController {
            viewController = presentedController.selectedViewController
        }
        
        while let presentedController = viewController?.presentedViewController {
            if let presentedController = presentedController as? UITabBarController {
                viewController = presentedController.selectedViewController
            } else {
                viewController = presentedController
            }
        }
        return viewController
    }
}

后续项目中所有需要调用该属性的位置，统一使用UIApplication.shared.activeKeyWindow即可，原有逻辑完全不受影响，也不会和后续系统版本的内置属性产生冲突。

• 方案2：添加版本可用性限制
  如果不想修改属性名，可以给自定义的keyWindow属性添加可用性标注，明确告诉编译器该自定义实现仅在iOS 15以下版本生效，iOS 15及以上版本直接使用系统内置实现，修改方式如下：

extension UIApplication {
    @available(iOS, introduced: 13.0, deprecated: 15.0, message: "iOS 15+ 请使用系统内置的keyWindow属性")
    var keyWindow: UIWindow? {
        return UIApplication.shared.connectedScenes
            .filter { $0.activationState == .foregroundActive }
            .first(where: { $0 is UIWindowScene })
            .flatMap({ $0 as? UIWindowScene })?.windows
            .first(where: \.isKeyWindow)
    }
    
    // 其余keyWindowPresentedController代码保持不变即可
}

该方案的缺点是如果后续系统调整keyWindow的内置逻辑，不同系统版本下的代码行为可能出现差异，长期维护稳定性不如第一种方案。

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