跳至內容

CLI

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

用途#

CLI 係 Tuist 嘅核心。佢負責項目生成、自動化工作流程(測試、運行、圖表同檢查),並提供連接 Tuist Server 嘅介面,支援認證、快取、Insights、預覽、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