コンテンツへスキップ

Gradle テストインサイト

Tuist の Gradle プラグインは、各テストタスクの実行後にテスト結果を自動的にアップロードし、Tuist ダッシュボードでテストのパフォーマンスと不安定なテストを可視化します。

Tuist Gradle プラグインを適用すると、テストインサイトが自動的に収集されます。初期のプラグイン設定以外に追加の設定は不要です。

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=falseGit ヒストリーの読み取りおよびアップロードを行いません。
TUIST_GIT_UNSHALLOW_ENABLED=falseリモートに接続せず、チェックアウトのみを読み取ります。