跳至内容

Gradle 测试洞察

要求

Tuist 的 Gradle 插件会在每次测试任务执行后自动上传测试结果,让你直接在 Tuist 仪表板中查看测试性能和不稳定测试的情况。

一旦应用插件,测试洞察就会自动收集。无需额外配置。

你可以在 Tuist 仪表板中访问测试洞察,并查看其随时间的变化:

包含测试洞察的仪表板

跟踪内容#

该插件会收集所有 Gradle Test 任务的结果,包括:

  • 单个测试用例的通过/失败状态和耗时
  • 测试套件和类结构
  • 跨运行检测不稳定测试

配置上传行为#

默认情况下:

  • 本地构建的测试结果在后台上传。
  • CI 运行的测试结果在前台上传,以避免在短暂存在的代理上丢失遥测数据。

你可以在 settings.gradle.kts 中的 tuist 块中使用 uploadInBackground 来覆盖此行为:

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仅读取检出仓库,不与远程通信。