# Gradle 測試洞察 {#gradle-test-insights}

Tuist 的 Gradle 外掛程式會在每次測試任務執行後自動上傳測試結果，讓你能直接在 Tuist 儀表板中檢視測試效能與不穩定測試。

套用 Tuist Gradle 外掛程式時會自動收集測試洞察——除了初始外掛程式設定外，無需額外設定。

你可以在 Tuist 儀表板中存取測試洞察，並觀察其隨時間的變化：

![含測試洞察的儀表板](/images/guides/features/build-insights/tests-dashboard.png)

## 追蹤內容 {#what-is-tracked}

此外掛程式會收集所有 Gradle `Test` 任務的結果，包括：
- 個別測試案例的通過/失敗狀態與持續時間
- 測試套件與類別結構
- 跨多次執行的不穩定測試偵測

## 設定上傳行為 {#configure-upload-behavior}

預設情況下：
- 本機建置的測試結果會在背景上傳。
- CI 執行的測試結果會在前台上傳，以避免在短暫存在的代理程式上遺失遙測資料。

你可以使用 `uploadInBackground` 在你的 `settings.gradle.kts` 中的 `tuist` 區塊覆寫此行為：

```kotlin
tuist {
    uploadInBackground = false // always upload in the foreground
}
```

### Git 歷史記錄 {#git-history}

在 CI 上，此外掛程式在回報測試執行時也會上傳檢出的提交歷史記錄：提交 SHA、其父提交、提交日期，以及該執行與其拉取請求基礎分支所在的分支。不會上傳檔案內容、提交訊息或作者。這能讓 Tuist 知道哪些提交已合併到你的預設分支，例如合併佇列測試過的提交。此外掛程式會讀取检出已有的歷史記錄；當检出沒有基礎分支時，會向遠端查詢其最新提交（`git ls-remote`）。它不會抓取歷史記錄。

| 變數 | 效果 |
| --- | --- |
| `TUIST_GIT_UPLOAD_ENABLED=false` | 不會讀取或上傳任何 Git 歷史記錄。 |
| `TUIST_GIT_UNSHALLOW_ENABLED=false` | 僅讀取检出，不會聯絡遠端。 |