从SwiftUI迁UIKit后覆盖安装App SceneDelegate未调用

iOS真机系统会跨App安装周期持久化存储应用的UIScene会话配置。当用户从纯SwiftUI生命周期的旧版本覆盖安装为UIKit Scene生命周期的新版本时，系统会优先读取本地留存的旧版SwiftUI场景配置，不会加载新版info.plist中写入的UIApplicationSceneManifest规则，导致系统找不到匹配的SceneDelegate实现，相关生命周期回调完全不触发，最终出现启动黑屏无响应的问题。
模拟器、Mac端构建无该问题，是因为这些运行环境没有留存旧版本遗留的持久化Scene会话数据，会直接读取新版配置。卸载重装能解决问题也是因为卸载操作会同步清空系统关联存储的所有旧Scene配置，但该操作无法强制存量用户执行。

不需要用户卸载重装，只需要在可正常触发的AppDelegate生命周期回调中增加两层处理，即可全量覆盖存量升级用户：

• 第一层：主动清理系统留存的旧版残留Scene会话，强制系统后续读取新版配置
• 第二层：增加启动兜底逻辑，在SceneDelegate未被正常调用时手动初始化应用窗口，直接解决黑屏问题

具体实现代码 #

修改AppDelegate中的application(_:didFinishLaunchingWithOptions:)方法，代码如下：

// AppDelegate中需先声明window属性，和SceneDelegate中的window属性逻辑兼容
var window: UIWindow?

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 销毁所有旧版本遗留的持久化Scene会话
    application.openSessions.forEach { oldSession in
        application.requestSceneSessionDestruction(oldSession, options: nil, errorHandler: nil)
    }

    // 兜底初始化窗口：仅当SceneDelegate未正常触发、window未创建时执行
    if #available(iOS 13.0, *) {
        if window == nil {
            let fallbackWindow = UIWindow(frame: UIScreen.main.bounds)
            let rootViewController: UIViewController
            // 原有的根控制器判断逻辑保持不变
            if isLoggedIn {
                rootViewController = MainViewController()
            } else {
                rootViewController = UIHostingController(
                    rootView: LandingView().injectingEnvironment()
                )
            }
            fallbackWindow.rootViewController = rootViewController
            fallbackWindow.makeKeyAndVisible()
            window = fallbackWindow
        }
    }
    return true
}

注意事项 #

• 该兜底逻辑和正常SceneDelegate流程无冲突：如果系统正常加载了新版Scene配置、触发了SceneDelegate的scene(_:willConnectTo:session:options:)回调，Scene中创建的window会自动替换兜底创建的实例，用户无感知
• 旧版残留的Scene会话仅在首次升级启动时存在，调用销毁接口清理后，后续冷启动会完全走配置的标准SceneDelegate流程，不会重复触发兜底逻辑
• 不要通过将UIApplicationSupportsMultipleScenes设为false的方式绕问题，该操作会破坏多场景能力适配，且无法保证清空系统留存的旧配置
• 不需要手动清理沙盒内的缓存文件，Scene会话配置是系统级单独存储的，通过系统提供的会话销毁接口即可完成清理

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