Xcode 测试洞察

Tuist Test Insights 提供 Xcode 测试分析功能，帮助你通过识别慢速测试或快速理解失败的 CI 运行来监控测试套件的健康状况。随着测试套件的增长，越来越难以发现诸如测试逐渐变慢或间歇性失败等趋势。Tuist Test Insights 为你提供所需的可见性，以维护快速且可靠的测试套件。

借助 Test Insights，你可以回答以下问题：

我的测试变慢了吗？是哪些测试？
哪些测试不稳定并需要关注？
为什么我的 CI 运行失败了？

设置#

要开始跟踪你的测试，你可以利用 tuist inspect test 命令，将其添加到方案的测试后操作中：

用于检查测试的后操作

如果你使用的是 Mise，则需要在后操作环境中激活 tuist：

bash

# -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

Mise 与项目路径

你环境中的 PATH 环境变量不会被方案后操作继承，因此你必须使用 Mise 的绝对路径，这取决于你安装 Mise 的方式。此外，别忘了从项目中的某个目标继承构建设置，以便你可以从 $SRCROOT 指向的目录运行 Mise。

只要你登录了 Tuist 账户，你的测试运行就会被跟踪。你可以在 Tuist 仪表板中访问测试洞察，并查看它们随时间的变化：

带有测试洞察的仪表板

除了整体趋势外，你还可以深入查看每个单独的测试，例如在 CI 上调试失败或慢速测试时：

测试详情

生成的项目#

Note

自动生成的方案会自动包含 tuist inspect test 后操作。

如果你不想在自动生成的方案中跟踪测试洞察，请使用 testInsightsDisabled 生成选项禁用它们。

如果你使用的是带有自定义方案的生成项目，可以为测试洞察设置后操作：

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"
        )
    ]
)

持续集成#

要在 CI 上跟踪测试洞察，你需要确保你的 CI 已认证。

此外，你还需要：

在调用 xcodebuild 操作时使用 tuist xcodebuild 命令。
将 -resultBundlePath 添加到你的 xcodebuild 调用中。

当 xcodebuild 在没有 -resultBundlePath 的情况下测试你的项目时，不会生成所需的结果包文件。tuist inspect test 后操作需要这些文件来分析你的测试。

在 CI 上，Tuist 还会上传检出内容的提交历史：提交 SHA、其父提交、提交日期，以及运行及其拉取请求的基础分支所在的分支。不会上传文件内容、提交消息或作者信息。这能让 Tuist 知道哪些提交合并到了你的默认分支，例如合并队列测试过的提交。Tuist 会读取检出内容已有的历史，如果检出内容没有基础分支，则会向远程询问其最新提交（git ls-remote）。除代码覆盖率外，它不会获取历史。

变量	效果
`TUIST_GIT_UPLOAD_ENABLED=false`	不读取或上传任何 Git 历史。
`TUIST_GIT_UNSHALLOW_ENABLED=false`	仅读取检出内容，不联系远程。

Xcode 测试洞察

设置#

生成的项目#

持续集成#

Git 历史#