用途:为 macOS 15+ SwiftUI 应用定制每个窗口的场景与行为,按窗口职责(主浏览窗口、检查器/详情、关于/支持、媒体播放、欢迎页、无边框自定义界面)分别设置工具栏、标题、恢复、尺寸与位置。
主要能力:用 .toolbar(removing: .title) 隐藏标题但保留逻辑标题供辅助功能与菜单使用;用 .toolbarBackgroundVisibility(.hidden, for: .windowToolbar) 隐藏工具栏背景让内容延伸到顶边;需完全移除工具栏时用 .toolbarVisibility(.hidden, for: .windowToolbar)。隐藏工具栏或背景后,用 WindowDragGesture() 配合 .allowsWindowActivationEvents(true) 补回拖拽区域,注意避免抢占控件手势。用 .containerBackground(.thickMaterial, for: .window) 替换默认背景。窗口行为方面:.windowMinimizeBehavior(.disabled)、.restorationBehavior(.disabled)、.defaultLaunchBehavior(.presented)、.windowStyle(.plain)。位置方面:.defaultWindowPlacement 控制新窗口初始尺寸与位置,.windowIdealPlacement 控制缩放后的尺寸,闭包内可用 content.sizeThatFits(.unspecified) 与 context.defaultDisplay.visibleRect,并用 WindowPlacement(size:) 返回结果。
使用方式:先检查场景声明并分类窗口角色,调整工具栏与标题呈现,补回拖拽区域,再细化最小化、恢复、缩放与启动行为,设置默认与理想位置,最后用 build-run-debug 在真实 .app 中验证。SwiftUI 修饰符不足时,仅对 NSWindow 做狭窄的 appkit-interop 桥接。
限制:这些 API 属 macOS 15+,旧部署目标需可用性判断或更多 AppKit 桥接。不要仅为隐藏忘记设置的标题而移除标题;不要硬编码单一显示器尺寸;无边框窗口必须保留可拖动与关闭路径。