メインコンテンツまでスキップ

テスト結果のデプロイ

Bitrise CIのビルドの後、テスト結果を一か所で確認できます。Workflows内に複数のテストStepsがある場合でも、すべてのテストはビルドページで確認できます。Bitrise上でアクセスしやすくactionableなテスト結果を提供し、テストの失敗からより早く復旧でき、開発者体験全体を向上させることが目標です。

最小限の設定で、テスト結果をビルドページにデプロイできます。必要な設定は環境によって異なります。

  • テストの実行に公式のBitriseテストStepsを使用する場合
  • テストの実行にその他のStepsを使用する場合

デプロイすると、失敗したテストと不安定なテストをプルリクエストのコメントとして投稿することもできます。詳しくは、PRコメントでのビルドの問題の報告を参照してください。

公式のBitriseテストStepsからの結果のデプロイClick to copy link​

サポートされているテストStepsは次のとおりです。

これらのStepsのいずれかを使用している場合は、WorkflowにDeploy to Bitrise.io Stepが含まれていることを確認してください。Bitriseが自動的にテスト結果をビルドページにデプロイします。

添付ファイルと不安定なテスト

テストが添付ファイルを生成する場合や、Bitriseに不安定なテストを表示させたい場合は、Deploy to Bitrise.io Stepのバージョンが2.19.1以降である必要があります。添付ファイルをファイル名でテストケースにリンクするには、バージョン2.26.0以降が必要です。詳しくは、テストケース名に合わせた添付ファイルの命名を参照してください。

その他のStepsからの結果のデプロイClick to copy link​

その他のStepsを使用してテストを実行する場合（たとえば、完全にカスタムなテストソリューションにはScript Stepsを使用できます）、追加の設定が必要です。

  1. テストを実行するStepをWorkflowに追加します。

  2. Export test results to the Test Reports StepをWorkflowに追加します。

  3. Stepを設定します。Export test results to the Test Reports Stepの使い方。

  4. WorkflowにDeploy to Bitrise.io Stepが含まれていることを確認してください。

    添付ファイルと不安定なテスト

    テストが添付ファイルを生成する場合や、Bitriseに不安定なテストを表示させたい場合は、Deploy to Bitrise.io Stepのバージョンが2.19.1以降である必要があります。添付ファイルをファイル名でテストケースにリンクするには、バージョン2.26.0以降が必要です。詳しくは、テストケース名に合わせた添付ファイルの命名を参照してください。

Export test results to Test Reports Stepの使い方Click to copy link​

結果を自動的にエクスポートしないStepsを使用している場合でも、Export test results to Test Reports Stepを使用することで、テスト結果をTestsタブに表示できるようになります。

正しく設定すると、Stepはプロジェクトのリポジトリ内のテスト結果を見つけ、エクスポートディレクトリに格納します。

  1. Bitrise にアクセスして Log in、左側の Bitrise CI を選択し、プロジェクトを選択します。

  2. メインページの Workflows ボタンをクリックします。

  3. テストを実行するStepの後に、Export test results to Test Reports StepをWorkflowに追加します。

  4. The name of the testインプットに、the name of the testの実行名を設定します。

  5. Test result base pathインプットに、テスト結果が格納されているパスを設定します。

    Managing_an_app_s_bitrise.png

    ここにはフォルダーを設定することを推奨しますが、特定のファイルパスを設定することもできます。default valueはプロジェクトのソースディレクトリです。パターンの例:

    • プロジェクトのルートディレクトリがappの場合: app/build/test-results/testDemoDebugUnitTest/
    • テスト結果がプロジェクトフォルダー内にあるが、appがルートディレクトリではない場合: ./app/build/test-results/testDemoDebugUnitTest/

    テストケース名に合わせた名前の添付ファイルをエクスポートするには、テスト結果と添付ファイルの両方を含むフォルダー（たとえばapp/build/）を設定します。

  6. Test result search patternインプットに、テスト結果ファイルに一致するパターンを設定します。

    この検索パターンは、Path where custom test results resideインプットに設定されたパス内のすべてのファイルとフォルダーを検索するために使用されます。

    一致する項目が複数ある場合、Stepは最初に一致したものをエクスポートし、ログに警告を出力します。前のインプットに特定のファイルパスを設定した場合は、ここには*を設定するだけで構いません。

    パターンの例:

    • ベースパス内のすべてのファイルに一致させる場合: *
    • ベースパス内の特定のディレクトリ内のすべてのファイルに一致させる場合: */build/test-results/testDemoDebugUnitTest/*
    • ベースパスがapp/build/のようにより広いフォルダーである場合に、単一のJUnit XMLに一致させる場合: */test-results/testDemoDebugUnitTest/TEST-com.example.ScreenshotTest.xml

  7. Step’s test result directoryインプットで、パスが正しいことを確認します。

    このインプットの値は変更しないでください。これは、Deploy to Bitrise.io Stepがエクスポートするテスト結果を探すフォルダーです。$BITRISE_TEST_RESULT_DIR環境変数を設定する必要があります。

  8. WorkflowにDeploy to Bitrise.io Stepが含まれていることを確認してください。

    テストが添付ファイルを生成する場合は、Stepのバージョンが2.19.x以降であることを確認してください。