Gradle 測試洞察
必要條件
- 已套用
dev.tuistGradle 外掛程式,詳情請參閱 開始使用 Gradle 專案。
Tuist 的 Gradle 外掛程式會在每次測試任務執行後自動上傳測試結果,讓你可以直接在 Tuist 儀表板中查看測試效能和不穩定測試。
一旦套用外掛程式,就會自動收集測試洞察資料。無需額外設定。
你可以在 Tuist 儀表板中存取測試洞察資料,並觀察其隨時間的變化:

追蹤內容#
此外掛程式會收集所有 Gradle Test 任務的結果,包括:
- 個別測試案例的通過/失敗狀態及持續時間
- 測試套件和類別結構
- 跨多次執行的不穩定測試偵測
設定上傳行為#
預設情況下:
- 本機建構的測試結果會在背景上傳。
- CI 執行的測試結果會在前台上傳,以避免在短暫存活的代理程式上遺失遙測資料。
你可以使用 uploadInBackground 覆寫此行為,該設定位於 tuist 區塊中的 settings.gradle.kts 檔案內:
kotlin
tuist {
uploadInBackground = false // always upload in the foreground
}
Git 歷史記錄#
在 CI 環境中,此外掛程式在報告測試執行時也會上傳檢出目錄的提交歷史記錄:提交 SHA、其父提交、提交日期,以及該次執行和其拉取請求基礎分支所在的分支。不會上傳任何檔案內容、提交訊息或作者資訊。這能讓 Tuist 知道哪些提交已合併到你的預設分支,例如合併佇列所測試的提交。此外掛程式會讀取檢出目錄中已有的歷史記錄;如果檢出目錄沒有基礎分支,它會向遠端查詢最新的提交(git ls-remote)。它不會擷取歷史記錄。
| 變數 | 效果 |
|---|---|
TUIST_GIT_UPLOAD_ENABLED=false | 不會讀取或上傳任何 Git 歷史記錄。 |
TUIST_GIT_UNSHALLOW_ENABLED=false | 僅讀取檢出目錄的內容,不會聯絡遠端。 |