需求
使用者介面框架
預設選項
為何需要
建立視窗、側邊欄、工具列與設定介面時,可優先選用 SwiftUI,也能用場景來組織 Mac 應用程式。
.md ,即可取得該頁面的 Markdown 版本。
Codex 應用案例
使用 Codex 和 SwiftUI 建立原生 Mac 應用程式骨架,並進行建置與除錯。
使用 Codex 和 SwiftUI 開發 macOS 應用程式,建立以 shell 為主、可反覆建置與執行的流程。隨著應用程式逐步成熟,再加入原生桌面場景與視窗、整合 AppKit,並設定簽署流程。
使用 Codex 和 SwiftUI 建立原生 Mac 應用程式骨架,並進行建置與除錯。
使用 Codex 和 SwiftUI 開發 macOS 應用程式,建立以 shell 為主、可反覆建置與執行的流程。隨著應用程式逐步成熟,再加入原生桌面場景與視窗、整合 AppKit,並設定簽署流程。
使用 Codex 和 SwiftUI 開發 macOS 應用程式,建立以 shell 為主、可反覆建置與執行的流程。隨著應用程式逐步成熟,再加入原生桌面場景與視窗、整合 AppKit,並設定簽署流程。
| 技能 | 使用理由 |
|---|---|
| Build macOS Apps | 以 shell 為主建置 macOS 應用程式並進行除錯。使用 SwiftUI 設計原生桌面場景與視窗,視需要橋接 AppKit,並為簽署與公證做好準備。 |
開發新的 Mac 應用程式時,先請 Codex 選擇合適的場景模型:WindowGroup、Window、Settings、MenuBarExtra 或 DocumentGroup。這樣一開始就能採用 Mac 原生的應用程式結構,不必從 iOS 風格的 ContentView 逐步擴充。
以 shell 為主要入口,反覆建置並執行應用程式。Xcode 專案使用 xcodebuild。以套件為主的應用程式則使用 swift build,並在專案內用 script/build_and_run.sh 封裝整個流程:停止舊程序、建置應用程式,再啟動剛建置的版本。也可以視需要透過指令碼查看日誌或遙測資料。
如果完全使用 SwiftPM 建置的應用程式有圖形介面,請將它封裝成 .app 再啟動。直接執行封裝前的執行檔,可能會在本機驗證時遇到 Dock 沒有顯示應用程式圖像、應用程式無法成為作用中程式,或套件身分無法正確辨識等問題。
開發工作開始涉及桌面平台特有的需求時,請加入 Build macOS Apps 外掛程式。它涵蓋以 shell 為主的建置與除錯流程、SwiftPM 應用程式封裝、SwiftUI 原生場景與視窗的常用設計、與 AppKit 整合、統一日誌記錄、測試問題分類,以及簽署與公證流程。
如需瞭解如何安裝與使用外掛程式和技能,請參閱外掛程式文件與技能文件。
優先採用 Mac 的操作慣例,避免直接套用 iOS 導覽模式。使用 NavigationSplitView 並列顯示側邊欄與詳細內容,以獨立的 Settings 場景呈現偏好設定。透過工具列與指令讓使用者容易找到可執行的操作,並用選單列項目提供隨時可用的輕量工具。
優先使用系統材質、語意色彩與標準控制項。只有在產品需要獨特的桌面介面時,才加入自訂視窗樣式、可拖移視窗的區域或 Liquid Glass 介面效果。
如果 SwiftUI 已能滿足大部分需求,只針對缺少的部分加入最小範圍的 AppKit 橋接。適合橋接的情境包括開啟與儲存面板、控制第一回應者、驗證選單項目是否可用、處理拖放的特殊情況,或為單一專用控制項封裝 NSView。
若要檢查執行時的行為,請 Codex 在處理視窗開啟、側邊欄項目選取、選單指令或背景同步的程式碼中,加入幾個 Logger 事件。啟動應用程式後,再用 log stream 確認這些事件是否如預期出現。
測試失敗時,請 Codex 先用 xcodebuild test 或 swift test 執行足以診斷問題的最小範圍測試,再判斷是編譯錯誤、斷言失敗、程式崩潰、測試偶發失敗,還是環境或設定問題。
從本機反覆開發進入散布階段時,請 Codex 準備兩套流程:一套是在 Xcode 中手動封存,另一套是透過指令碼封存並公證,方便日後重複發行。請它使用 codesign 和 plutil 檢查應用程式套件、權限宣告與強化執行環境。如果也想在終端完成上傳,可使用 App Store Connect CLI。
分別為主視窗、設定視窗、工具視窗和選單列項目定義獨立的場景根節點,避免將整個應用程式塞進單一大型檢視。
自訂側邊欄、工具列或材質之前,先確認 SwiftUI 的標準場景與視窗 API 是否已能提供所需的 Mac 操作行為。
如果缺少某項桌面功能,可使用 NSViewRepresentable、NSViewControllerRepresentable 或專為該功能撰寫的 NSWindow 輔助程式。選取狀態與應用程式狀態仍由 SwiftUI 統一管理。
應用程式能在本機成功啟動,並不能證明它已完成簽署或已符合公證條件。保留 Xcode 手動封存流程,以便在個別版本發行前進行檢查,並加入可重複使用的指令碼來封存與公證。當任務從本機開發進入發行階段時,請使用 codesign 和 plutil 進行檢查。
需求
預設選項
為何需要
需求
使用者介面框架
預設選項
為何需要
建立視窗、側邊欄、工具列與設定介面時,可優先選用 SwiftUI,也能用場景來組織 Mac 應用程式。
需求
AppKit 橋接
預設選項
為何需要
如果 SwiftUI 無法實作所需的桌面行為,可使用 NSViewRepresentable、NSViewControllerRepresentable 或 NSWindow,只針對該行為橋接 AppKit。
需求
建置與封裝
預設選項
xcodebuild、swift build 和 App Store Connect CLI
為何需要
建立以終端為主、可重複執行的流程,涵蓋本機建置、手動封存、透過指令碼進行公證,以及上傳至 App Store。
| 需求 | 預設選項 | 為何需要 |
|---|---|---|
| 使用者介面框架 | SwiftUI | 建立視窗、側邊欄、工具列與設定介面時,可優先選用 SwiftUI,也能用場景來組織 Mac 應用程式。 |
| AppKit 橋接 | AppKit | 如果 SwiftUI 無法實作所需的桌面行為,可使用 NSViewRepresentable 、 NSViewControllerRepresentable 或 NSWindow ,只針對該行為橋接 AppKit。 |
| 建置與封裝 | xcodebuild 、 swift build 和 App Store Connect CLI | 建立以終端為主、可重複執行的流程,涵蓋本機建置、手動封存、透過指令碼進行公證,以及上傳至 App Store。 |
使用 Codex 和 Build macOS Apps 外掛程式,以 `NavigationSplitView` 將你的構想做成 Mac...
用 Codex 和 Build macOS Apps 外掛程式,在視窗、側邊欄、指令或同步流程中,用 `Logger` 記錄幾個關鍵事件。接著執行應用程式,透過「主控台」或 `log...
使用 Codex 搭配 Expo 外掛程式,建立 React Native 應用程式的基本架構,並遵循 Expo Router 的路由慣例和 Expo 原生套件的使用慣例。先用...