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

Xcodeテスト結果のリッチHTML形式での表示

強化されたXcodeレポート機能を使用すると、Xcodeのテスト結果をリッチなHTML形式ですぐに確認できます。成功したテストケースと失敗したテストケースの両方に加え、テストで生成された動画やスクリーンショットも表示されます。

利用するには、ビルドで次の2つを行う必要があります。

  • Xcodeのテストを実行し、.xcresultファイルを正しい場所に配置します。Xcode Test for iOSとXcode Test for Building Stepsはデフォルトでこれを行うため、追加の設定は必要ありません。fastlaneなど他のStepsを使用することもできますが、その場合はXcodeが.xcresultファイルを配置する場所を指定する必要があります。
  • Generate Xcode HTML report Stepを実行します。これは.xcresultファイルを受け取ってレポートを生成します。テストの実行にXcode Test for iOS Stepを使用している場合、このStepに設定は必要ありません。他のStepsを使用する場合は、.xcresultファイルの場所を手動で設定する必要があります。

テストの実行には、公式のXcode Test for iOS Stepを使用することを強くおすすめします。このStepは.xcresultファイルを生成し、Generate Xcode HTML report Stepが追加の設定なしでそれを検出します。

リッチなテスト結果を表示するには、次の手順に従います。

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

    Xcode Test for iOS Stepの使用をおすすめします

    Xcode Test for iOS Step(およびXcode Test without building Step)を使用すると、結果のエクスポートに追加の設定は必要ありません。

    他のStepsを使用してテストを実行し、後からリッチな結果を表示することもできます。その場合は、Stepが.xcresultファイルを生成することを確認したうえで、Generate Xcode HTML report Stepにその場所を指定する必要があります。たとえば、fastlane Stepや独自のScript Stepを使用できます。

    Stepを設定してXcodeのテストを実行する方法の詳細については、iOSアプリのユニットテストとUIテストの実行を参照してください。

  2. Generate Xcode HTML report StepをWorkflowに追加します。

    これは当然、テストを実行するStepの後に配置する必要があります。

  3. Xcresult file pathsの入力が.xcresultファイルの場所を指していることを確認します。

    この入力には、1つ以上のディレクトリを指定するか、改行(/n)で区切ったファイルパスを指定することで、複数の.xcresultファイルを追加できます。各ファイルにはそれぞれ個別のレポートが作成されます。

    設定は不要です

    Xcode Test for iOS Stepを使用している場合、この入力を変更する必要はありません。

    generate-xcode-reports_input.png

  4. Workflowの末尾にDeploy to Bitrise.io Stepが含まれていることを確認します。

    このStepがないと、結果はエクスポートされません。

    バージョンの要件

    Stepはバージョン2.7.2以降である必要があります。

  5. ビルドが完了したら、build summaryページに移動します。

    失敗したビルド

    ビルドが失敗した場合でも、テスト結果は利用できます。

  6. Testsタブを選択して結果を表示します。

    有効期限

    HTMLテストレポートは生成から7日間利用できます。7日を過ぎると、アクセスできなくなります。

    html-test-result.png

注意

生成されるHTMLレポートは、公式のBitriseコンテンツではないことにご注意ください。このレポートはWorkflowの設定に完全に基づいて生成されます。Bitriseはレポートに表示される内容を直接制御することはできません。