SwiftUI-Agent-Skill macOS 跨平台指南多窗口 Scene、窗口样式与 AppKit 互操作【免费下载链接】SwiftUI-Agent-SkillAdd expert SwiftUI Best Practices guidance to your AI coding tool (Agent Skills open format).项目地址: https://gitcode.com/gh_mirrors/sw/SwiftUI-Agent-SkillSwiftUI-Agent-Skill 是一个面向 AI 编码工具的开源 Agent Skill把实用的 SwiftUI 最佳实践蒸馏成 AI 可即时调用的参考。本文聚焦 macOS 跨平台部分如何选对多窗口 Scene、如何一步到位调好窗口样式以及 SwiftUI 不够用时如何与AppKit 互操作。新手也能跟着这份指南让 AI 第一次就写出苹果味十足的 macOS 窗口代码。1. 认识 SwiftUI-Agent-Skill 与 1 分钟安装一句话介绍这个 Skill 按 Agent Skills 开放格式打包包含一个主入口 SKILL.md 和 30 多份按需加载的参考文档。AI 工具加载后遇到 SwiftUI 任务会自动查阅对应参考而不是把全部内容塞进上下文。它与 macOS 相关的参考文档正是本文主角主题参考文件macOS 多窗口 Scenereferences/macos-scenes.md窗口与工具栏样式references/macos-window-styling.mdmacOS 视图与 AppKit 互操作references/macos-views.md一键克隆安装git clone https://gitcode.com/gh_mirrors/sw/SwiftUI-Agent-Skill然后把skills/swiftui-expert-skill/目录放入你的 AI 工具的技能目录即可各工具的具体安装方式见 INSTALLATION.md。验证方法在 AI 对话里说一句使用 swiftui-expert 技能帮我设计一个带菜单栏、设置窗口的 macOS 多窗口应用——agent 会引用 SKILL.md 并跳转到对应参考文件说明安装成功。2. 多窗口 Scene先选对窗户macOS 版 SwiftUI 应用由若干 Scene 类型拼成各自分工不同。建议先看技能里的速查表macos-scenes.mdScene可用性macOS 独有适用场景WindowGroupmacOS 11否主窗口多实例、标签页、File NewWindowmacOS 13否辅助单例窗口系统保证只有一个UtilityWindowmacOS 15✅浮动工具面板、检查器面板SettingsmacOS 11✅偏好设置窗口Cmd,MenuBarExtramacOS 13✅菜单栏常驻图标 / 菜单DocumentGroupmacOS 11否文档型应用新建/打开/保存全自动化2.1 WindowGroup vs Window最容易选错的一对WindowGroup主窗口担当。用户可以从File New Window打开多个实例还能合并成标签页即使全部关闭应用仍保持运行。Window单例窗口。系统保证只存在一个实例若它是 App 唯一的 Scene关闭窗口时应用直接退出适合视频通话这类工具。经验法则主窗口一律WindowGroupWindow留给连接诊断器这类辅助单例窗口。2.2 MenuBarExtra菜单栏应用的正确打开方式两种形态任选.menu默认——下拉菜单适合操作 / 退出这类轻量工具.window——弹出面板可放任意自定义 SwiftUI 内容适合实时状态展示。再配合 Info.plist 的LSUIElement true即可做出不占 Dock 的纯菜单栏应用。2.3 UtilityWindow懂焦点的浮动窗UtilityWindowmacOS 15是工具面板的原生解法默认浮在主窗口之上、应用失活时自动隐藏、按 Esc 可关闭还会自动在 View 菜单加入显示/隐藏项。它通过FocusedValue读取当前聚焦主窗口的状态天然实现主窗口看什么面板显示什么无需手写窗口管理逻辑。2.4 跨平台必会的两个细节程序化开窗用Environment(\.openWindow)调用openWindow(id: xxx)或openWindow(value: 数据)窗口已打开时直接带到前台不会产生重复窗口。用#if os(macOS)包裹 macOS 专属 Scenemacos-scenes.md同一份工程才能同时在 iOS 与 macOS 编译WindowGroup { ContentView() } #if os(macOS) Settings { SettingsView() } MenuBarExtra(Status, systemImage: bolt) { StatusMenu() } #endif3. 窗口样式一步到位工具栏、标题栏、尺寸与位置窗口外观配置集中在 macos-window-styling.md四组修饰符就能让窗口一眼原生。3.1 工具栏风格windowToolbarStyle风格效果.unified标题栏与工具栏合并为一行多数应用首选.unifiedCompact与 unified 相同但高度更紧凑.expanded标题栏在工具栏上方给按钮更多空间工具栏按钮多时用.expanded其余情况推荐.unified或.unifiedCompact。3.2 标题栏、尺寸与位置控制修饰符作用.windowStyle(.hiddenTitleBar)隐藏标题栏适合播放器等沉浸式窗口.defaultSize(width:height:)新窗口初始尺寸一定要给.defaultPosition(.center)初始位置居中、四边、四角.windowResizability(...).contentSize固定尺寸不可缩放.contentMinSize可缩放但有最小限制黄金组合内容上设minWidth / minHeight.windowResizability(.contentMinSize).defaultSize窗口既不会被缩到坏掉新窗口也能以合理尺寸打开macos-window-styling.md。3.3 精准落位windowIdealPlacementmacOS 15 起支持闭包形式能拿到当前显示器的visibleArea几何信息据此计算窗口位置与大小——主窗口直接开在屏幕右半屏这类需求从此有据可依多显示器也不怕。3.4 原生布局双雄NavigationSplitView 与 InspectorNavigationSplitView在 macOS 上分栏始终并排显示不像 iPhone 那样堆叠侧栏自带半透明材质背景宽度可由用户拖拽。侧边栏导航请选它而不是手写HSplitView。InspectormacOS 14右侧属性面板自动与工具栏集成用户可拖边缘调整宽度。4. AppKit 互操作SwiftUI 搞不定时怎么办macOS 视图与互操作部分以 macos-views.md 为核心第一原则是优先原生 SwiftUI确有需要再桥接 AppKit。4.1 SwiftUI → AppKitNSViewRepresentable要嵌入 WebView 或任意自定义NSView时用NSViewRepresentable包一层实现两个方法makeNSView(context:)——创建 AppKit 视图只调用一次updateNSView(_:context:)——SwiftUI 状态变化时同步过去。需要接收代理回调例如搜索框输入变化时加一个Coordinator把事件转回 SwiftUI参考文档里提供了完整示例macos-views.md。⚠️红线规则永远不要直接修改已托管NSView的frame/bounds——布局归 SwiftUI 管自己设置会导致错位。4.2 AppKit → SwiftUINSHostingController / NSHostingView反过来如果存量 AppKit 工程想局部改用 SwiftUImacos-views.mdNSHostingController——把 SwiftUI 作为窗口的根控制器NSHostingView——把 SwiftUI 视图直接塞进现有NSView层级。这是老工程改造的最低痛路逐窗口迁移而不必一次性重写。4.3 值得知道的 macOS 专属原生控件控件说明HSplitView/VSplitViewIDE 式对等分栏分隔条可拖拽Table.tableStyle(.bordered)多列表格支持隔行背景色CopyButtonmacOS 15一键复制 Transferable 内容到剪贴板fileImporter/fileExporter原生打开/保存面板还能自定义按钮文案特别提醒fileImporter返回的 URL 是安全作用域书签读取前必须调用startAccessingSecurityScopedResource()用完再释放否则会静默失败。5. 新手快速清单交付前让 AI 对照检查一遍主窗口用WindowGroup辅助单例用Window偏好设置用Settings场景自动获得 Cmd, 入口工具栏设为.unified/.unifiedCompact并提供了defaultSizemacOS 专属 Scene 已用#if os(macOS)包裹侧边栏导航用NavigationSplitView浮动面板用UtilityWindowAppKit 桥接仅作最后手段且没有手动改 frame6. 参考文档速查文档内容SKILL.md技能主入口工作流、主题路由表、正确性清单references/macos-scenes.md6 种 Scene 全解生命周期、多窗口、菜单栏references/macos-window-styling.md工具栏、标题栏、尺寸位置与键盘快捷键references/macos-views.mdTable、拖放、文件操作与 AppKit 互操作INSTALLATION.md各 AI 工具的完整安装方式装好之后只需对 AI 说一句使用 swiftui expert 技能检查当前项目的 macOS 窗口与 AppKit 互操作技能就会自动路由到上述参考文档逐条给出最佳实践建议帮你把 macOS 应用做到最原生的观感。【免费下载链接】SwiftUI-Agent-SkillAdd expert SwiftUI Best Practices guidance to your AI coding tool (Agent Skills open format).项目地址: https://gitcode.com/gh_mirrors/sw/SwiftUI-Agent-Skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考