Back to Details

axiom-macos

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

macOS Development

macOS开发

You MUST use this skill for ANY macOS-specific development including windows, menus, sandboxing, distribution, AppKit bridging, and macOS SwiftUI differences.
任何涉及macOS专属特性的开发工作都必须使用该技能，包括窗口、菜单、沙箱、分发、AppKit桥接以及macOS平台的SwiftUI差异处理。

Quick Reference

快速参考

Symptom / TaskReference
Window management (WindowGroup, Window, MenuBarExtra)See 
skills/windows.md
Menu bar, commands, keyboard shortcutsSee 
skills/menus-and-commands.md
Table, Inspector, NavigationSplitView, focusSee 
skills/swiftui-differences.md
App Sandbox, file access, security-scoped bookmarksSee 
skills/sandbox-and-file-access.md
Developer ID, notarization, Sparkle auto-updatesSee 
skills/direct-distribution.md
NSViewRepresentable, NSHostingController, AppKit bridgingSee 
skills/appkit-interop.md
问题/任务参考文档
窗口管理（WindowGroup、Window、MenuBarExtra）查看 
skills/windows.md
菜单栏、命令、键盘快捷键查看 
skills/menus-and-commands.md
表格、检查器、NavigationSplitView、焦点查看 
skills/swiftui-differences.md
应用沙箱、文件访问、安全范围书签查看 
skills/sandbox-and-file-access.md
Developer ID、公证、Sparkle自动更新查看 
skills/direct-distribution.md
NSViewRepresentable、NSHostingController、AppKit桥接查看 
skills/appkit-interop.md

Cross-Suite Routes

跨套件指引

These topics overlap with macOS development but live in separate suites:
以下主题与macOS开发相关，但属于独立套件：

SwiftUI (shared iOS/macOS)

SwiftUI（iOS/macOS通用）

  • View state, data flow, @Observable → See axiom-swiftui
  • Navigation (NavigationStack basics) → See axiom-swiftui (skills/nav.md)
  • Layout (ViewThatFits, AnyLayout) → See axiom-swiftui (skills/layout.md)
  • Animations → See axiom-swiftui (skills/animation-ref.md)
  • 视图状态、数据流、@Observable → 参考axiom-swiftui
  • 导航（NavigationStack基础）→ 参考axiom-swiftui（skills/nav.md）
  • 布局（ViewThatFits、AnyLayout）→ 参考axiom-swiftui（skills/layout.md）
  • 动画 → 参考axiom-swiftui（skills/animation-ref.md）

Data & persistence

数据与持久化

  • SwiftData, Core Data, GRDB → See axiom-data
  • CloudKit sync → See axiom-data
  • SwiftData、Core Data、GRDB → 参考axiom-data
  • CloudKit同步 → 参考axiom-data

Concurrency

并发

  • Swift 6 concurrency, actors, Sendable → See axiom-concurrency
  • Swift 6并发、actors、Sendable → 参考axiom-concurrency

Other

其他

  • Accessibility (VoiceOver, Dynamic Type) → See axiom-accessibility
  • Networking (URLSession, Network.framework) → See axiom-networking
  • Security (Keychain, passkeys, encryption) → See axiom-security
  • 无障碍（VoiceOver、动态字体）→ 参考axiom-accessibility
  • 网络（URLSession、Network.framework）→ 参考axiom-networking
  • 安全（钥匙串、通行密钥、加密）→ 参考axiom-security

Conflict Resolution

冲突解决

axiom-macos vs axiom-swiftui: When working on a macOS SwiftUI app:
  1. Use axiom-macos for macOS-only concerns: windows, menus, commands, sandboxing, distribution, Table, Inspector, AppKit bridging
  2. Use axiom-swiftui for cross-platform SwiftUI: navigation, layout, state management, animations
  3. Both may apply: A macOS app using NavigationSplitView with Table needs axiom-macos for Table specifics and axiom-swiftui for NavigationSplitView basics
axiom-macos vs axiom-security: For sandbox and code signing:
  1. Use axiom-macos for macOS App Sandbox, security-scoped bookmarks, file access entitlements, Developer ID signing
  2. Use axiom-security for Keychain storage, encryption, passkeys, certificate management
axiom-macos vs axiom-swiftui：开发macOS SwiftUI应用时：
  1. 使用axiom-macos处理macOS专属问题：窗口、菜单、命令、沙箱、分发、表格、检查器、AppKit桥接
  2. 使用axiom-swiftui处理跨平台SwiftUI内容：导航、布局、状态管理、动画
  3. 两者均适用：若macOS应用使用带Table的NavigationSplitView，需用axiom-macos处理Table的专属特性，用axiom-swiftui处理NavigationSplitView的基础功能
axiom-macos vs axiom-security：处理沙箱与代码签名时：
  1. 使用axiom-macos处理macOS应用沙箱、安全范围书签、文件访问权限、Developer ID签名
  2. 使用axiom-security处理钥匙串存储、加密、通行密钥、证书管理

Decision Tree

决策树

dot
digraph macos {
    start [label="macOS development task" shape=ellipse];
    what [label="What area?" shape=diamond];

    start -> what;
    what -> "skills/windows.md" [label="windows/scenes"];
    what -> "skills/menus-and-commands.md" [label="menus/commands/shortcuts"];
    what -> "skills/swiftui-differences.md" [label="Table/Inspector/focus/macOS SwiftUI"];
    what -> "skills/sandbox-and-file-access.md" [label="sandbox/file access"];
    what -> "skills/direct-distribution.md" [label="distribution/notarization/updates"];
    what -> "skills/appkit-interop.md" [label="AppKit bridging"];
    what -> "axiom-swiftui" [label="cross-platform SwiftUI"];
    what -> "axiom-security" [label="Keychain/encryption"];
}
dot
digraph macos {
    start [label="macOS development task" shape=ellipse];
    what [label="What area?" shape=diamond];

    start -> what;
    what -> "skills/windows.md" [label="windows/scenes"];
    what -> "skills/menus-and-commands.md" [label="menus/commands/shortcuts"];
    what -> "skills/swiftui-differences.md" [label="Table/Inspector/focus/macOS SwiftUI"];
    what -> "skills/sandbox-and-file-access.md" [label="sandbox/file access"];
    what -> "skills/direct-distribution.md" [label="distribution/notarization/updates"];
    what -> "skills/appkit-interop.md" [label="AppKit bridging"];
    what -> "axiom-swiftui" [label="cross-platform SwiftUI"];
    what -> "axiom-security" [label="Keychain/encryption"];
}

Resources

资源

WWDC: 2021-10062, 2022-10061, 2022-10075, 2023-10148, 2024-10149
Docs: /security/app-sandbox, /swiftui/windowgroup, /swiftui/table
Skills: axiom-swiftui, axiom-security, axiom-concurrency
WWDC：2021-10062、2022-10061、2022-10075、2023-10148、2024-10149
文档：/security/app-sandbox、/swiftui/windowgroup、/swiftui/table
技能：axiom-swiftui、axiom-security、axiom-concurrency