Rust 專案

plaintext

Help me get started with Tuist. Follow the setup at:
https://tuist.dev/en/docs/guides/get-started/rust-project

必要條件#

Tuist 可與你現有的 Cargo 專案搭配使用。你不需要新增 Rust 相依性，也不需要變更專案的建置方式。

安裝 Tuist CLI 與 Rust。在儀表板中建立專案，並將建置系統設為 Cargo (Rust)。在儲存庫根目錄新增 tuist.toml：

toml

project = "account/project"
# url = "https://your-tuist-server.example.com"

使用 tuist auth login 登入，然後透過 Tuist 執行你慣用的 Cargo 指令。在 CI 中，將 TUIST_TOKEN 設為專案權杖。你也可以設定 TUIST_PROJECT 來取代新增設定檔，若使用自行託管的伺服器，則設定 TUIST_URL。

bash

tuist cargo build --workspace
tuist cargo check --all-targets
tuist cargo test --workspace

使用你通常傳給 Cargo 的相同引數，包括功能、工具鏈與測試篩選器。即使 Tuist 無法上傳報告，Cargo 仍會維持其慣用的輸出與結束碼。

啟用 mise 的命令包裝器後，將以下内容加入 mise.toml：

toml

[wrappers.cargo]
command = "tuist"
args = ["cargo"]

新增包裝器後執行 mise reshim。接著即可照常使用 cargo build、cargo check 與 cargo test。Mise 會替你透過 Tuist 執行這些指令。

Coding agents

這在使用編碼代理程式時很有用：它們可以持續執行 cargo build 與 cargo test，而不需要被提醒加上 tuist 前綴。

tuist cargo build 會自動快取符合条件的註冊表葉節點函式庫，包含本機與透過 Kura 的遠端快取。不需要額外的工具或快取設定。此快取處於實驗階段，尚未涵蓋所有編譯或在不同檢出路徑間的复用。請參閱 Rust 快取以了解支援的編譯、驗證方式與如何確認复用。

在儀表板中開啟 Builds，查看建置耗時並比較本機建置與 CI 建置。選擇一個建置，找出編譯時間最長的 crate，並檢查其警告與錯誤。

編譯器計時是以 crate 為單位，而非個別原始檔。請參閱 Rust 建置洞察以了解更多關於解讀建置報告的資訊。

照常執行你的測試：

bash

tuist cargo test --workspace

在儀表板中開啟 Tests，查看通過、失敗與忽略的測試，包含文件測試。Cargo 會回報測試套件的歷時，但穩定的 libtest 並未揭露單一測試的計時。

若只執行文件測試：

bash

tuist cargo test --doc