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