SwiftUI开发:无AppDelegate/SceneDelegate的macOS应用如何隐藏窗口标题
首先要明确核心认知偏差:你之前接触到的Mac Catalyst标题栏移除方法,完全不适用于原生SwiftUI搭建、无AppDelegate/SceneDelegate的macOS应用——Catalyst的技术栈是UIKit,需要操作UIWindow实例做配置;而原生SwiftUI macOS应用的技术栈是AppKit,通过SwiftUI提供的原生Scene修饰符就能完成所有配置,完全不需要引入老的代理组件。
核心实现方法(适配纯声明式SwiftUI App架构)
从macOS 13开始,SwiftUI为原生macOS场景提供了完全无代理的窗口配置能力,只需要在对应的Scene定义上追加修饰符即可,不需要在任何代理方法里获取NSWindow实例做零散配置:
- 实现你参考截图中的效果(窗口顶部无独立标题占位,内容直接延伸到窗口顶部):直接给
WindowGroup/Window等Scene添加修饰符.windowStyle(.hiddenTitleBar) - 进一步消除标题栏的残留占位空间:可以追加配置
.windowToolbarStyle(.unified(showsTitle: false)),这个配置会彻底关闭标题文字的显示,同时把工具栏和窗口内容区融合 - 只想隐藏标题文字、保留可拖动的标题栏区域:不需要修改windowStyle,只要给视图层级加上
.navigationTitle(""),再搭配上面的showsTitle: false配置即可
低版本兼容方案(无需引入任何代理组件)
如果需要兼容macOS 12及更早的系统,上面提到的.windowStyle(.hiddenTitleBar)是版本不支持的,这个时候依然不需要创建AppDelegate/SceneDelegate类,直接在App结构体的初始化方法里做全局窗口配置即可:
@main struct MyApp: App { init() { // 全局关闭自动标签页,避免标题栏显示异常 NSWindow.allowsAutomaticWindowTabbing = false // 统一配置所有窗口的标题显示属性 for window in NSApp.windows { window.titleVisibility = .hidden window.titlebarAppearsTransparent = true // 保留窗口的基础操作按钮,不影响正常交互 window.standardWindowButton(.closeBox)?.isHidden = false window.standardWindowButton(.miniaturizeButton)?.isHidden = false window.standardWindowButton(.zoomButton)?.isHidden = false } } var body: some Scene { WindowGroup { ContentView() } } }
常见踩坑提醒
很多人一开始搞错了技术栈的适用边界,把Mac Catalyst项目里的标题栏移除代码直接搬到原生SwiftUI macOS项目里,折腾半天发现完全不生效——这两套技术栈的窗口运行时根本不一样:
Mac Catalyst项目跑的是UIKit运行时,窗口实例是UIWindow,配置逻辑是给UIWindow的titleBar属性设置隐藏状态;原生SwiftUI macOS项目跑的是AppKit运行时,窗口实例是NSWindow,所有配置都可以通过SwiftUI的声明式API完成,根本不需要依赖传统代理组件。
内容的提问来源于stack exchange,提问作者hvkale

