使用DocumentGroupLaunchScene时如何兼容iOS 17及更早版本？

你遇到的崩溃是因为SwiftUI的SceneBuilder无法直接处理在其闭包内用#available包裹的、仅在高版本系统可用的Scene类型（如iOS 18的DocumentGroupLaunchScene）——即使有版本判断，SceneBuilder在解析阶段仍会尝试识别该Scene，从而触发致命错误。

以下是两种可靠的解决方案：

方案一：封装版本专属Scene结构体 #

将DocumentGroupLaunchScene封装到一个单独的、用@available标记的Scene结构体中，让编译器明确该Scene的版本限制：

// 定义仅iOS 18及以上可用的Scene
@available(iOS 18.0, *)
struct iOS18LaunchScene: Scene {
    var body: some Scene {
        DocumentGroupLaunchScene {
            NewDocumentButton("Start")
        } background: {
            Color.blue
        }
    }
}

// 主App结构体
@main
struct MyApp: App {
    var body: some Scene {
        DocumentGroup(newDocument: MyDocument()) { file in
            ContentView(document: file.$document)
        }
        
        // 条件添加iOS 18专属Scene
        if #available(iOS 18.0, *) {
            iOS18LaunchScene()
        }
    }
}

这种方式是SwiftUI官方推荐的版本专属Scene处理方式，能让SceneBuilder正确识别版本限制，避免旧系统下的解析错误。

方案二：使用条件编译（可选） #

如果需要在编译阶段就排除旧系统下的相关代码，可以结合条件编译指令：

@main
struct MyApp: App {
    var body: some Scene {
        DocumentGroup(newDocument: MyDocument()) { file in
            ContentView(document: file.$document)
        }
        
        // 仅在iOS 18及以上的编译环境中包含该Scene
        #if os(iOS) && swift(>=5.10)
        if #available(iOS 18.0, *) {
            DocumentGroupLaunchScene {
                NewDocumentButton("Start")
            } background: {
                Color.blue
            }
        }
        #endif
    }
}

注意：条件编译需要确保你的编译环境支持Swift 5.10及以上（对应iOS 18 SDK），否则该代码块会被忽略。

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