启用Optimize for Mac时Mac Catalyst DocumentGroup显示空白视图

环境 #

• Xcode 16.1
• macOS 15.1
• SwiftUI + Mac Catalyst
• 基于 DocumentGroup 的文档类应用

代码 #

struct DocumentGroupTestApp: App {
    var body: some Scene {
        DocumentGroup(newDocument: WritingAppDocument()) { file in
            TestView() // 启用“Optimize for Mac”时显示空白
        }
    }
}

struct TestView: View {
    var body: some View {
        Text("Hello, World!")
    }
}

预期行为 #

• 创建或打开文档时，TestView 应正常显示“Hello, World!”文本
• 无论 Mac Catalyst 优化设置如何，视图都能正常工作

实际行为 #

• 启用“Optimize for Mac”时：视图完全空白
• 启用“Scaled to Match iPad”时：视图显示正常

已尝试操作 #

• 确认问题仅在启用“Optimize for Mac”时出现
• 验证基础视图在 iPad 模式下可正常工作

请问有人遇到过此问题或知道如何在保持“Optimize for Mac”启用的情况下修复空白视图问题吗？

解决方法 #

这个问题在 Xcode 16 + macOS 15 的 Mac Catalyst 环境下比较常见，核心原因是优化 Mac 模式下，DocumentGroup 的视图容器布局逻辑和 iPad 缩放模式存在差异，以下是几个可行的修复方案：

1. 给根视图添加全屏布局约束
   优化 Mac 模式下，SwiftUI 不会自动让 DocumentGroup 内的视图填充整个窗口，需要手动指定布局范围。修改 TestView：

struct TestView: View {
    var body: some View {
        Text("Hello, World!")
            .frame(maxWidth: .infinity, maxHeight: .infinity)
    }
}

通过 frame(maxWidth: .infinity, maxHeight: .infinity) 让视图撑满整个文档窗口，直接解决空白问题。

2. 绑定文档对象到视图
   优化 Mac 模式下，DocumentGroup 可能需要明确关联文档实例才能正确触发视图渲染。可以把文档对象传递给 TestView：

struct DocumentGroupTestApp: App {
    var body: some Scene {
        DocumentGroup(newDocument: WritingAppDocument()) { file in
            TestView(document: file.$document)
        }
    }
}

struct TestView: View {
    @Binding var document: WritingAppDocument
    
    var body: some View {
        Text("Hello, World!")
            .frame(maxWidth: .infinity, maxHeight: .infinity)
    }
}

这种方式能确保视图和文档生命周期绑定，避免因视图未关联文档导致的渲染异常。

3. 检查文档类实现
   确认你的 WritingAppDocument 类正确实现了 FileDocument 协议，特别是 init(configuration:) 和 fileWrapper(configuration:) 方法。如果文档初始化逻辑存在问题，优化 Mac 模式下可能会导致视图无法正常加载。

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