跳至內容

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僅讀取檢出目錄的內容,不會聯絡遠端。