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が追加の設定なしでそれを検出します。
リッチなテスト結果を表示するには、次の手順に従います。
- Workflow Editor
- Configuration YAML
-
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テストの実行を参照してください。
-
Generate Xcode HTML report StepをWorkflowに追加します。
これは当然、テストを実行するStepの後に配置する必要があります。
-
Xcresult file pathsの入力が
.xcresultファイルの場所を指していることを確認します。この入力には、1つ以上のディレクトリを指定するか、改行(/n)で区切ったファイルパスを指定することで、複数の
.xcresultファイルを追加できます。各ファイルにはそれぞれ個別のレポートが作成されます。設定は不要ですXcode Test for iOS Stepを使用している場合、この入力を変更する必要はありません。

-
Workflowの末尾にDeploy to Bitrise.io Stepが含まれていることを確認します。
このStepがないと、結果はエクスポートされません。
バージョンの要件Stepはバージョン2.7.2以降である必要があります。
-
ビルドが完了したら、build summaryページに移動します。
失敗したビルドビルドが失敗した場合でも、テスト結果は利用できます。
-
Testsタブを選択して結果を表示します。
有効期限HTMLテストレポートは生成から7日間利用できます。7日を過ぎると、アクセスできなくなります。

-
Xcodeのテストを実行するStepをWorkflowに追加します。
これには
xcode-testStepを使用することを強くおすすめします。my-workflow:steps:- xcode-test: {}xcode-test Stepの使用をおすすめしますxcode-testStep(およびxcode-test-without-buildingStep)を使用すると、結果のエクスポートに追加の設定は必要ありません。他のStepsを使用してテストを実行し、後からリッチな結果を表示することもでき ます。その場合は、Stepが
.xcresultファイルを生成することを確認したうえで、generate-xcode-html-reportStepにその場所を指定する必要があります。たとえば、fastlaneStepや独自のscriptStepを使用できます。Stepを設定してXcodeのテストを実行する方法の詳細については、iOSアプリのユニットテストとUIテストの実行を参照してください。
-
generate-xcode-html-reportStepをWorkflowに追加します。これは当然、テストを実行するStepの後に配置する必要があります。
my-workflow:steps:- xcode-test: {}- generate-xcode-html-report: {} -
xcresult_patternsの入力が.xcresultファイルの場所を指していることを確認します。この入力には、1つ以上のディレクトリを指定するか、改行(/n)で区切ったファイルパスを指定することで、複数の
.xcresultファイルを追加できます。各ファイルにはそれぞれ個別のレポートが作成されます。my-workflow:steps:- xcode-test: {}- generate-xcode-html-report:is_always_run: trueinputs:- xcresult_patterns: /path/to/MyApp.xcresult設定は不要ですXcode Test for iOS Stepを使用している場合、この入力を変更する必要はありません。
-
Workflowの末尾に
deploy-to-bitrise-ioStepが含まれていることを確認します。このStepがないと、結果はエクスポートされません。
バージョンの要件Stepはバージョン2.7.2以降である必要があります。
my-workflow:steps:- xcode-test: {}- generate-xcode-html-report:is_always_run: trueinputs:- xcresult_patterns: /path/to/MyApp.xcresult- deploy-to-bitrise-io: {} -
ビルドが完了したら、build summaryページに移動します。
失敗したビルドビルドが失敗した場合でも、テスト結果は利用できます。
-
Testsタブを選択して結果を表示します。
有効期限HTMLテストレポートは生成から7日間利用できます。7日を過ぎると、アクセスできなくなります。

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