从SwiftUI迁移至UIKit App Delegate生命周期后更新启动黑屏求助

以下是针对更新后首次启动黑屏、SceneDelegate.willConnectTo未执行问题的排查和解决思路：

• 清理旧SwiftUI场景残留，强制触发新场景创建
  旧版本SwiftUI生命周期的场景状态可能被系统保留，导致更新后未触发新的SceneDelegate。在AppDelegate的didFinishLaunchingWithOptions中添加逻辑，断开旧场景并手动请求新场景激活：

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
      // 断开可能存在的旧SwiftUI场景连接
      if let oldScene = application.connectedScenes.first as? UIWindowScene {
          oldScene.disconnect()
      }
      // 手动触发新场景会话激活
      application.requestSceneSessionActivation(nil, userActivity: nil, options: nil, errorHandler: nil)
      return true
  }
  

• 确保Info.plist场景配置完全覆盖旧配置
  检查Info.plist中的UIApplicationSceneManifest > UISceneConfigurations：

  • 删除所有基于SwiftUI的场景配置（如关联SwiftUI.Scene的条目）
  • 保留唯一的UIKit场景配置，明确指定UISceneDelegateClassName为你的SceneDelegate类，确保UISceneConfigurationName与代码中引用的一致
  • 若使用故事板，需正确设置UISceneStoryboardFile；若纯代码创建窗口，确保配置中无需故事板关联

• 禁用场景状态恢复，避免旧数据干扰
  旧版本SwiftUI的场景恢复数据可能与新UIKit场景不兼容，在SceneDelegate中重写方法阻止状态恢复：

  func stateRestorationActivity(for scene: UIScene) -> NSUserActivity? {
      return nil // 禁用系统自动恢复旧场景状态
  }
  

  同时在AppDelegate中确保返回正确的场景配置：

  func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration {
      let config = UISceneConfiguration(name: "Default Configuration", sessionRole: connectingSceneSession.role)
      config.delegateClass = SceneDelegate.self
      return config
  }
  

• 兜底检查：手动创建窗口（若场景未正常激活）
  在AppDelegate的applicationDidBecomeActive中添加兜底逻辑，确保存在活跃窗口：

  func applicationDidBecomeActive(_ application: UIApplication) {
      guard let windowScene = application.connectedScenes.first as? UIWindowScene else { return }
      // 检查是否存在有效根视图控制器，无则手动创建窗口
      if windowScene.windows.first?.rootViewController == nil {
          let window = UIWindow(windowScene: windowScene)
          window.rootViewController = YourRootViewController() // 替换为你的根视图控制器
          window.makeKeyAndVisible()
          windowScene.windows.append(window)
      }
  }
  

• 确认移除旧SwiftUI入口
  确保已删除或注释掉原SwiftUI生命周期的@main标记的App结构体，新的@main仅标记在AppDelegate上：

  @main
  class AppDelegate: UIResponder, UIApplicationDelegate {
      // 你的AppDelegate逻辑
  }
  

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