SwiftUI文档型应用二次打开文档后导航栏消失问题求助

问题描述 #

我在遵循苹果官方《Building a Document-Based App with SwiftUI》教程开发SwiftUI文档型应用时，使用DocumentGroupLaunchScene和DocumentGroup遇到了一个问题：应用启动后，第二次创建或打开文档时导航栏会消失，这个问题在我的应用以及苹果提供的示例代码中都存在。

复现步骤 #

• 启动应用
• 创建或打开文档（此时导航栏可见）
• 返回文档浏览器
• 创建或打开另一个文档
• 观察到导航栏已消失

预期行为 #

无论文档打开或创建的顺序如何，所有文档的导航栏都应保持可见。

解决方案 #

这个问题属于SwiftUI DocumentGroup的已知行为，可通过以下方式修复：

1. 显式指定导航栏属性 #

在文档内容视图中，显式设置导航栏标题并保持导航栏可见，同时保留工具栏按钮，确保导航栏状态稳定：

struct YourDocumentView: View {
    var document: YourDocumentType
    
    var body: some View {
        Text("文档内容")
            .navigationTitle("我的文档")
            .navigationBarTitleDisplayMode(.inline)
            .toolbar {
                ToolbarItem(placement: .navigationBarTrailing) {
                    Button(action: { /* 自定义动作 */ }) {
                        Label("更多", systemImage: "ellipsis.circle")
                    }
                }
            }
    }
}

2. 通过UIKit外观强制设置导航栏可见 #

如果上述方法无效，可在App初始化时全局设置UINavigationBar的外观，确保导航栏始终不被隐藏：

@main
struct YourDocumentApp: App {
    init() {
        UINavigationBar.appearance().isHidden = false
    }
    
    var body: some Scene {
        DocumentGroupLaunchScene()
        DocumentGroup(newDocument: YourDocumentType()) { file in
            YourDocumentView(document: file.document)
        }
    }
}

3. 用NavigationStack包裹文档视图（iOS 16+） #

针对iOS 16及以上版本，使用NavigationStack显式构建导航层级，确保每次打开文档时导航栏都能正确加载：

struct YourDocumentView: View {
    var document: YourDocumentType
    
    var body: some View {
        NavigationStack {
            Text("文档内容")
                .navigationTitle("我的文档")
        }
    }
}

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