# Xcode 測試洞察 {#xcode-test-insights}

Tuist Test Insights 提供 Xcode 測試分析，助你識別緩慢測試或快速了解失敗的 CI 運行，從而監控測試套件的狀況。隨著測試套件增長，越來越難察覺如測試逐漸變慢或間歇性失敗等趨勢。Tuist Test Insights 提供你所需的可見度，以維持快速且可靠的測試套件。

透過 Test Insights，你可以回答以下問題：
- 我的測試是否變慢了？哪些測試？
- 哪些測試不穩定並需要關注？
- 為何我的 CI 運行失敗？

## 設定 {#setup}

要開始追蹤你的測試，你可以將 `tuist inspect test` 指令加入至方案的測試後置動作中：

![檢查測試的後置動作](/images/guides/features/build-insights/inspect-test-scheme-post-action.png)

如果你使用 [Mise](https://mise.jdx.dev/)，你的腳本需要在後置動作環境中啟動 `tuist`：
```sh
# -C ensures that Mise loads the configuration from the Mise configuration
# file in the project's root directory.
$HOME/.local/bin/mise x -C $SRCROOT -- tuist inspect test
```

> [!TIP]
> **Mise 與專案路徑**
>
> 你環境中的 `PATH` 環境變數不會被方案後置動作繼承，因此你必須使用 Mise 的絕對路徑，這取決於你如何安裝 Mise。此外，別忘了從專案中的目標繼承建置設定，以便你能從 $SRCROOT 指向的目錄執行 Mise。

只要你登入 Tuist 帳戶，你的測試運行就會被追蹤。你可以在 Tuist 儀表板中存取測試洞察，並查看它們隨時間的變化：

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

除了整體趨勢外，你還可以深入檢視每個單獨測試，例如在 CI 上除錯失敗或緩慢測試時：

![測試詳情](/images/guides/features/build-insights/test-detail.png)

## 產生的專案 {#generated-projects}

> [!NOTE]
> 自動產生的方案會自動包含 `tuist inspect test` 後置動作。

>
> 如果你無意追蹤自動產生方案中的測試洞察，可以使用 [testInsightsDisabled](https://projectdescription.tuist.dev/documentation/projectdescription/tuist) 產生選項將其停用。

如果你使用帶有自訂方案的產生專案，可以為測試洞察設定後置動作：

```swift
let project = Project(
    name: "MyProject",
    targets: [
        // Your targets
    ],
    schemes: [
        .scheme(
            name: "MyApp",
            shared: true,
            buildAction: .buildAction(targets: ["MyApp"]),
            testAction: .testAction(
                targets: ["MyAppTests"],
                postActions: [
                    // Test insights: Track test duration and flakiness
                    .executionAction(
                        title: "Inspect Test",
                        scriptText: """
                        $HOME/.local/bin/mise x -C $SRCROOT -- tuist inspect test
                        """,
                        target: "MyAppTests"
                    )
                ]
            ),
            runAction: .runAction(configuration: "Debug")
        )
    ]
)
```

如果你不使用 Mise，你的腳本可以簡化為：

```swift
testAction: .testAction(
    targets: ["MyAppTests"],
    postActions: [
        .executionAction(
            title: "Inspect Test",
            scriptText: "tuist inspect test"
        )
    ]
)
```

## 持續整合 {#continuous-integration}

要在 CI 上追蹤測試洞察，你需要確保你的 CI 已<.localized_link href="/guides/integrations/continuous-integration#authentication">驗證</.localized_link>。

此外，你需要：
- 在叫用 `xcodebuild` 動作時使用 <.localized_link href="/cli/xcodebuild#tuist-xcodebuild">`tuist xcodebuild`</.localized_link> 指令。
- 將 `-resultBundlePath` 加入至你的 `xcodebuild` 叫用中。

當 `xcodebuild` 測試你的專案而沒有 `-resultBundlePath` 時，不會產生所需的结果捆綁檔案。`tuist inspect test` 後置動作需要這些檔案來分析你的測試。

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

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

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