Exporting to Test Reports from any Step

You can use the Export test results to the Test reports add-on Step to make sure your test results appear in the Test Reports add-on, even if you use Steps that don’t automatically export their results.

With the correct configuration, the Step finds the test results in your app’s repository, and puts them in the export directory.

You can use your own scripts in a Script Step to export your test results. You just need to make sure that:

  // Test Name ... { "test-name":"My first test" }

Here’s an example script to export your test results:

#!/bin/env bash
set -ex

# Creating a sub-directory for the test run within the BITRISE_TEST_RESULT_DIR:

test_run_dir="$BITRISE_TEST_RESULT_DIR/result_dir_1"
mkdir "$test_run_dir"

# Exporting the JUnit XML test report:

cp "MY/TEST/REPORT/XML/FILE/PATH.xml" "$test_run_dir/UnitTest.xml"

# Creating the test-info.json file with the name of the test run defined:

echo '{"test-name":"MY TEST RUN NAME"}' >> "$test_run_dir/test-info.json"

If all goes well, you should be able to see your test results on the Test Reports page.

The Export test results to Test Reports add-on Step can only export test result files to the Deploy to Bitrise.io Step which supports two formats for results:

If your tests produce an .xcresult file, screenshots generated during the test run are part of the test result. As such, they will be exported to the Test Reports add-on.

If you use the JUnit XML format and want to export screenshots or other images, you cannot use the Export test results to Test Reports add-on Step.

You need to use a custom script to export both the result and the screenshots. The script to export both must be in the same Script Step, and you must have a test-info.json file with the necessary information about the test runs: Using custom scripts to export test results.

To export screenshots with the results, the script must place the images in the $BITRISE_TEST_RESULT_DIR folder.

#!/bin/env bash
set -ex

# Creating a sub-directory for the test run within the BITRISE_TEST_RESULT_DIR:

test_run_dir="$BITRISE_TEST_RESULT_DIR/result_dir_1"
mkdir "$test_run_dir"

# copying the image:

cp "MY/TEST/SCREENSHOTS/screenshot.png" "$test_run_dir/screenshot.png"