Deploying and viewing test results

Generate a JUnit.xml file from your tests.

The general file structure should look something like this:

<?xml version="1.0" encoding="UTF-8"?>
<testsuites time="15.682687">
    <testsuite name="Tests.Registration" time="6.605871">
        <testcase name="testCase1" classname="Tests.Registration" time="2.113871" />
    </testsuite>
</testsuites>

Add a <properties> element to associate an attachment with a testcase.

The name attribute of the element must be set with a value attachment_# where # is the ordered index of the attachment file, and the value is the filename. Bitrise will show attachments for any test with the attachment properties, but it's most common to only attach screenshots to failed tests. Mark a test as failed with a <failure> element.

<testcase name="testCase1" classname="Tests.Registration" time="2.113871" />
  <failure message="Assertion error message" type="AssertionError">
    Call stack printed here
  </failure>
  <properties>
    <property name="attachment_1" value="pp1.jpg" />
    <property name="attachment_2" value="pp2.jpg" />
  </properties>            
</testcase>

Add the custom-test-results-export Step to your Bitrise Workflow after generating your JUnit XML file.

workflows:
  inline_attachment:
    steps:
    - generate-text-file:
        inputs:
        - file_name: junit.xml
        - file_content: "xml content with references to image files here"
    - custom-test-results-export:

Set a test name in the test_name input.

- custom-test-results-export@1:
    inputs:
    - test_name: example_tests

Set the path to your JUnit XML file in the search_pattern input.

- custom-test-results-export@1:
    inputs:
    - test_name: example_tests
    - search_pattern: junit.xml

Add a custom script Step to your Workflow

In the content input, add a script that copies images to the Bitrise test directory.

Replace the name_of_test_report with the name you set in the test_name input in the custom-test-results-export Step.

- script:
    inputs:
    - content: |
        #!/usr/bin/env bash
        set -ex
        set -o pipefail

        TEST_RESULTS_DIR=$(find "$BITRISE_TEST_DEPLOY_DIR" -type d -name "example_tests" -print -quit)
        cp ~/*.jpg $TEST_RESULTS_DIR

This script places the images into the specific subdirectory of BITRISE_TEST_DEPLOY_DIR where your test report is located.

Add the deploy-to-bitrise-io Step to the end of your Workflow.

You don't have to change the default input values. The full Workflow in your configuration YAML file might look something like this:

workflows:
  inline_attachment:
    steps:
    - generate-text-file@0:
        inputs:
        - file_name: junit.xml
        - file_content: "xml content with references to image files here"
    - custom-test-results-export@1:
        inputs:
        - test_name: example_tests
        - base_path: "."
        - search_pattern: junit.xml
    - script@1:
        inputs:
        - content: |
            #!/usr/bin/env bash
            set -ex
            set -o pipefail

            TEST_RESULTS_DIR=$(find "$BITRISE_TEST_DEPLOY_DIR" -type d -name "example_tests" -print -quit)
            cp ~/*.jpg $TEST_RESULTS_DIR
        title: Copy image files to test directory
    - deploy-to-bitrise-io@2: {}