跳至內容

CLI

來源:github.com/tuist/tuist/tree/main/Tuist 與 github.com/tuist/tuist/tree/main/cli

用途#

CLI 是 Tuist 的核心。它負責專案生成、自動化工作流程(測試、執行、圖表與檢查),並提供與 Tuist 伺服器的介面,以支援驗證、快取、洞察、預覽、Registry 與選擇性測試等功能。

如何貢獻#

需求#

  • macOS 14.0+
  • Xcode 26+

本機設定#

  • 複製儲存庫:git clone [email protected]:tuist/tuist.git
  • 使用官方安裝腳本安裝 Mise(而非 Homebrew),然後執行 mise install
  • 安裝 Tuist 相依套件:tuist install
  • 生成工作區:tuist generate

生成的專案會自動開啟。若稍後需要重新開啟,請執行 open Tuist.xcworkspace。

xed .

若嘗試使用 xed . 開啟專案,將會開啟套件而非 Tuist 生成的工作區。請使用 Tuist.xcworkspace。

執行 Tuist#

從 Xcode#

編輯 tuist scheme 並設定參數,例如 generate --no-open。將工作目錄設為專案根目錄(或使用 --path)。

ProjectDescription 編譯

CLI 依賴 ProjectDescription 完成建置。若執行失敗,請先建置 Tuist-Workspace scheme。

從終端機#

先生成工作區:

bash
tuist generate --no-open

接著用 Xcode 建置 tuist 可執行檔,並從 DerivedData 執行:

bash
tuist_build_dir="$(xcodebuild -workspace Tuist.xcworkspace -scheme tuist -configuration Debug -destination 'platform=macOS' -showBuildSettings | awk -F' = ' '/BUILT_PRODUCTS_DIR/{print $2; exit}')"
"$tuist_build_dir/tuist" generate --path /path/to/project --no-open

或透過 Swift Package Manager:

bash
swift build --product ProjectDescription
swift run tuist generate --path /path/to/project --no-open