Xcode中SceneDelegate与<App Name>App文件差异及适配问题咨询

变更原因 #

这个变化是苹果在iOS 14及以后版本对SwiftUI启动架构的优化——核心是贴合SwiftUI的声明式编程理念，砍掉了UIKit时代遗留的SceneDelegate这套偏命令式的生命周期管理逻辑，把App的启动、场景配置等核心职责整合到单一的@main标记App结构体中，让SwiftUI项目结构更简洁统一，减少UIKit与SwiftUI的代码混合。

带来的行为变化 #

• 启动流程简化：原来需要通过SceneDelegate的scene(_:willConnectTo:options:)方法手动初始化窗口和根视图，现在只需在App里声明WindowGroup，系统会自动处理窗口创建、根视图挂载等流程
• 生命周期管理更贴合SwiftUI风格：原来依赖SceneDelegate代理方法监听场景激活/后台/销毁，现在可以通过@Environment(\.scenePhase)在任意View中声明式监听场景状态变化，代码更灵活分散
• 配置集中化：App支持的场景类型（比如多窗口、文档场景）、外观设置（比如深色模式）等，都可以直接在App结构体里用修饰符配置，不用再去Info.plist里手动修改UIApplicationSceneManifest的复杂配置

旧项目代码迁移与适配 #

• ContentView的UI代码可以直接复制复用，这部分不受架构变更影响
• 但SceneDelegate里的逻辑不能直接照搬，需要做以下适配：
  • 先移除旧项目里的SceneDelegate和AppDelegate（如果有的话），新建带@main的App结构体，基础模板如下：

    @main
    struct YourAppNameApp: App {
        var body: some Scene {
            WindowGroup {
                ContentView()
            }
        }
    }
    

  • 如果原来在SceneDelegate里做了自定义窗口配置（比如设置窗口大小、隐藏状态栏），可以通过WindowGroup的修饰符实现，或者自定义UIWindowSceneDelegate并关联到App结构体中
  • 原来的场景生命周期回调（比如进入后台时保存数据），替换成在View中使用@Environment(\.scenePhase)监听：

    struct ContentView: View {
        @Environment(\.scenePhase) private var scenePhase
        
        var body: some View {
            Text("Hello World")
                .onChange(of: scenePhase) { newPhase in
                    if newPhase == .background {
                        // 执行后台逻辑
                    }
                }
        }
    }
    

  • 如果旧项目需要多场景支持，直接在App结构体里添加多个WindowGroup或者DocumentGroup即可，无需手动配置Info.plist

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