该技能专注于使用 SwiftUI 构建 macOS 菜单栏应用,提供从应用配置到界面模式的一整套代码示例与最佳实践。
【适用场景】
- 构建仅存在于菜单栏、不显示 Dock 图标的应用
- 创建状态项并搭配弹出窗口(popover)或菜单
- 实现键盘快捷键与全局热键
- 系统托盘集成与后台应用功能
- 登录项(开机自启动)配置
【应用配置】 在 Info.plist 中可通过 LSUIElement 设为 true 隐藏 Dock 图标,并用 LSApplicationCategoryType 指定应用分类(示例为 public.app-category.utilities)。
【MenuBarExtra 样式】 提供两种样式示例:
- .menuBarExtraStyle(.window):以弹出窗口形式展示内容视图
- .menuBarExtraStyle(.menu):展示传统菜单,可放置 Button 与 Divider,例如执行操作按钮与退出按钮(调用 NSApp.terminate(nil))
【常见模式】
- AppDelegate:实现 applicationDidFinishLaunching(启动时设置)、applicationWillTerminate(清理)、applicationShouldHandleReopen(处理 Dock 图标点击,若可见)
- 设置窗口:在 App 的 Scene 中使用 Settings 场景;可通过 NSApp.sendAction 配合 showSettingsWindow: 以编程方式打开设置,旧版本 macOS 使用 showPreferencesWindow:,并给出基于 macOS 14.0 的可用性判断写法
- 全局快捷键:使用 Carbon 的 RegisterEventHotKey 注册热键,示例为 Cmd + Shift + U,并维护 EventHotKeyRef
- 登录项:使用 ServiceManagement 的 SMAppService.mainApp 在 macOS 13.0 及以上注册/注销开机自启动,并可通过 SMAppService.mainApp.status 判断是否已启用
- 定时更新:使用 Timer 以 60 秒间隔重复触发,加入 RunLoop 的 .common 模式,并在主线程刷新数据
- 带状态的菜单栏图标:根据状态在 label 中切换 SF Symbol(如 chart.bar.fill 与 chart.bar)并设置前景色
【小组件集成】 在两个 target 中启用 App Groups 能力,使用 UserDefaults(suiteName:) 共享数据;主应用写入共享数据后调用 WidgetCenter.shared.reloadAllTimelines(),小组件读取同一 key 的数据。
【界面模式】
- 统一样式:给出 VStack 布局示例,包含头部(标题与设置按钮)、分隔线、内容列表与底部操作区(刷新、退出),并设置 padding 与宽度
- 进度指示:示例 UsageBar 根据当前值/上限计算百分比,按区间着色(绿/黄/红),并使用 GeometryReader 与圆角矩形绘制进度条
【最佳实践】 保持弹出面板轻量、打开迅速;使用系统颜色自动适配深色/浅色模式;通过 .tint(.accentColor) 尊重用户强调色;在不同菜单栏密度下测试;处理新机型刘海(菜单栏空间有限);考虑“减弱动态效果”辅助功能设置。
该页面未提供具体的收费、价格、平台版本要求或使用效果等信息,暂未提供。