如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題
Codex

Codex 應用案例

開發 macOS 應用程式

使用 Codex 和 SwiftUI 建立原生 Mac 應用程式骨架,並進行建置與除錯。

難度 Advanced
任務時間跨度 1h

使用 Codex 和 SwiftUI 開發 macOS 應用程式,建立以 shell 為主、可反覆建置與執行的流程。隨著應用程式逐步成熟,再加入原生桌面場景與視窗、整合 AppKit,並設定簽署流程。

最適合的對象

  • 從零開始開發 macOS SwiftUI 應用程式,希望由 Codex 建立原生桌面應用程式骨架,並撰寫可重複執行的建置指令碼
  • 維護現有 Mac 應用程式,需要 Codex 協助處理視窗、選單、側邊欄、設定、AppKit 整合或簽署問題
  • 希望以 shell 為主開發 macOS 應用程式,同時遵循原生桌面操作慣例的團隊

目錄

    ← 所有應用案例

    開發 macOS 應用程式

    使用 Codex 和 SwiftUI 建立原生 Mac 應用程式骨架,並進行建置與除錯。

    使用 Codex 和 SwiftUI 開發 macOS 應用程式,建立以 shell 為主、可反覆建置與執行的流程。隨著應用程式逐步成熟,再加入原生桌面場景與視窗、整合 AppKit,並設定簽署流程。

    Advanced
    1h

    使用 Codex 和 SwiftUI 開發 macOS 應用程式,建立以 shell 為主、可反覆建置與執行的流程。隨著應用程式逐步成熟,再加入原生桌面場景與視窗、整合 AppKit,並設定簽署流程。

    Advanced
    1h

    最適合的對象

    • 從零開始開發 macOS SwiftUI 應用程式,希望由 Codex 建立原生桌面應用程式骨架,並撰寫可重複執行的建置指令碼
    • 維護現有 Mac 應用程式,需要 Codex 協助處理視窗、選單、側邊欄、設定、AppKit 整合或簽署問題
    • 希望以 shell 為主開發 macOS 應用程式,同時遵循原生桌面操作慣例的團隊

    技能與外掛程式

    • 以 shell 為主建置 macOS 應用程式並進行除錯。使用 SwiftUI 設計原生桌面場景與視窗,視需要橋接 AppKit,並為簽署與公證做好準備。
    技能 使用理由
    Build macOS Apps 以 shell 為主建置 macOS 應用程式並進行除錯。使用 SwiftUI 設計原生桌面場景與視窗,視需要橋接 AppKit,並為簽署與公證做好準備。

    入門提示詞

    請使用 Build macOS Apps 外掛程式建立 macOS SwiftUI 應用程式骨架,並在專案內新增 `script/build_and_run.sh` 作為入口,讓我能透過 `Run` 動作呼叫它。 開發限制: - 以 shell 為主。Xcode 專案優先使用 `xcodebuild`,以 Swift 套件為主的應用程式則優先使用 `swift build`。 - 明確定義 Mac 應用程式的場景。先設定主視窗,只有在符合產品需求時才加入 `Settings`、`MenuBarExtra` 或輔助視窗。 - 優先採用桌面原生的側邊欄、工具列、選單、鍵盤快速鍵與系統材質,避免沿用 iOS 逐層推入畫面的導覽方式。 - 只有在 SwiftUI 難以簡潔實作所需的桌面行為時,才針對該行為橋接 AppKit。 - 每次變更都做一輪小範圍驗證,並逐一列出實際用來建置、啟動或查看記錄的指令。 請提供: - 應用程式骨架或指定的 Mac 功能實作 - 可重複使用的建置與執行指令碼 - 實際執行的必要驗證步驟,步驟越少越好 - 你建議針對桌面環境進行的後續工作
    請使用 Build macOS Apps 外掛程式建立 macOS SwiftUI 應用程式骨架,並在專案內新增 `script/build_and_run.sh` 作為入口,讓我能透過 `Run` 動作呼叫它。 開發限制: - 以 shell 為主。Xcode 專案優先使用 `xcodebuild`,以 Swift 套件為主的應用程式則優先使用 `swift build`。 - 明確定義 Mac 應用程式的場景。先設定主視窗,只有在符合產品需求時才加入 `Settings`、`MenuBarExtra` 或輔助視窗。 - 優先採用桌面原生的側邊欄、工具列、選單、鍵盤快速鍵與系統材質,避免沿用 iOS 逐層推入畫面的導覽方式。 - 只有在 SwiftUI 難以簡潔實作所需的桌面行為時,才針對該行為橋接 AppKit。 - 每次變更都做一輪小範圍驗證,並逐一列出實際用來建置、啟動或查看記錄的指令。 請提供: - 應用程式骨架或指定的 Mac 功能實作 - 可重複使用的建置與執行指令碼 - 實際執行的必要驗證步驟,步驟越少越好 - 你建議針對桌面環境進行的後續工作

    建立應用程式骨架與建置流程

    開發新的 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。

    提示詞範例

    請使用 Build macOS Apps 外掛程式,以 SwiftUI 為這項應用程式功能開發 macOS 原生版本。 限制條件: - 採用桌面原生的場景結構,包含主視窗與設定,並視需要提供可透過工具列或指令執行的操作。 - 如果持續顯示導覽結構有助於使用這項功能,請優先採用側邊欄與詳細內容並列的配置,避免使用 iOS 風格的逐層推入式導覽。 - 只有在 SwiftUI 難以簡潔實作某個特定桌面行為時,才加入一小段 AppKit 橋接程式碼。 - 建立或更新 `script/build_and_run.sh`,讓建置與執行流程以 shell 為主要入口。 - 列出你用來建置、啟動、測試和查看日誌的指令。 交付這次要實作的功能,用範圍最小且與功能相關的建置或測試流程驗證,並簡要說明散布前還需完成哪些簽署或封裝工作。

    實用技巧

    明確定義各個場景

    分別為主視窗、設定視窗、工具視窗和選單列項目定義獨立的場景根節點,避免將整個應用程式塞進單一大型檢視。

    善用系統提供的介面元素

    自訂側邊欄、工具列或材質之前,先確認 SwiftUI 的標準場景與視窗 API 是否已能提供所需的 Mac 操作行為。

    將 AppKit 的使用範圍限於個別需求

    如果缺少某項桌面功能,可使用 NSViewRepresentable、NSViewControllerRepresentable 或專為該功能撰寫的 NSWindow 輔助程式。選取狀態與應用程式狀態仍由 SwiftUI 統一管理。

    本機建置與簽署、公證應分開驗證

    應用程式能在本機成功啟動,並不能證明它已完成簽署或已符合公證條件。保留 Xcode 手動封存流程,以便在個別版本發行前進行檢查,並加入可重複使用的指令碼來封存與公證。當任務從本機開發進入發行階段時,請使用 codesign 和 plutil 進行檢查。

    技術堆疊

    需求

    使用者介面框架

    預設選項

    SwiftUI

    為何需要

    建立視窗、側邊欄、工具列與設定介面時,可優先選用 SwiftUI,也能用場景來組織 Mac 應用程式。

    需求

    AppKit 橋接

    預設選項

    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。

    相關應用案例