テストの添付ファイルについて

多くのテストは画像ファイルを生成します（スクリーンショットテスト、XCUITestsなど）。Bitriseは、これらの添付ファイルを関連するテストケースの下に表示できるため、ビルドページのTestsタブで確認できます。添付ファイルとテスト結果を照合する方法は、使用しているテストツールと、そのツールがxcresultファイルを生成するかどうかによって異なります。

サポートされているファイル形式

現在、添付ファイルについては次のファイル形式をサポートしています。

.jpg, .jpeg, .png, .txt, .log, .mp4, .webm, .ogg

添付ファイルとテスト結果の照合

テストがxcresultファイルを生成する場合、Bitriseは自動的に添付ファイルを対応するテストケースに照合します。追加の設定は不要です。

テストがxcresultファイルを生成しない場合は、次の2つの方法があります。

• 各ファイルにテストケース名を付ける。
• 各ファイルをJUnit XMLで参照する。

テストケース名に合わせた添付ファイルの命名

スクリーンショット、録画、ログに、それらを生成したテストケースの名前を付けます。<classname>__<name>[__run<k>]__<label>.<ext>の構造を使用すると、Bitriseは該当するテストの下にそれらを表示します。これには、Deploy to Bitrise.io Stepのバージョン2.26.0以降が必要です。

詳しい手順については、次を参照してください。

• テストケース名に合わせた添付ファイルの命名: ファイル名の構造、Bitrise Stepで添付ファイルをエクスポートする方法、表示されない添付ファイルのトラブルシューティング。
• テストツールの設定: 一般的なテストツールが添付ファイルに正しい名前を付けるように設定する例（Espresso、Paparazzi、Roborazzi、Detox、Playwright）。

JUnit XMLでの添付ファイルの参照

ファイルにテストケース名を付けられない場合は、JUnit XMLの各testcaseに、添付ファイルを列挙する<properties>要素を追加し、その後、Export test results to Test Reports StepでJUnit XMLをエクスポートします。これには、Stepのバージョン1.1.0以降が必要です。

詳しい手順については、JUnit XMLでの添付ファイルの参照を参照してください。