Test Reports allows you to view all your test results in a convenient way.
Use our testing Steps, and all your test results will be deployed to the same directory. From there, Test Reports can process them and display them in a way that’s easy to read and analyze.
Test Reports overview ⚓
You can run both UI tests and unit tests on Bitrise and with Test Reports , you can view the results of the different test types on the same page.
Test Reports can read and display test results that are in either of two formats:
- JUnit XML
You can use Test Reports with four of our testing Steps:
- Xcode Test for iOS
- Android Unit Test
- iOS Device Testing
- Virtual Device Testing for Android
These Steps will run the tests defined in your repository and then store the output in an Environment Variable. The Deploy to Bitrise.io Step will do the rest: it can read the results and send it to Test Reports.
Configuring Test Reports ⚓
Test Reports doesn’t require any sort of complicated configuration. All you need is to have tests in your repository, and two Steps in your Workflow.
- Add tests to your app’s repository.
- Add the appropriate testing Steps to your Workflow. For example, if you have an iOS project, you can use the Xcode Test for iOS Step to run Xcode tests.
- Make sure you have the Deploy to Bitrise.io Step in your Workflow.
- Run your build.
And that’s it! Once the build is finished, you will be able to view your test reports.
Checking test results ⚓
Test Reports display the most important information about all the tests you ran on the Test Summary tab. You will see all the tests you ran, their duration, and their results. You can also click on the tabs of the individual tests to see their details.
To access the result of a particular test:
- Open your app’s page on Bitrise.
- Click the Builds tab and select the build that ran the tests.
Under the build status, click See more next to the Test reports label.
On the Test Summary tab, find the test you want to check.
Alternatively, on the top bar, click the tab of the test set you want to check out.
To filter tests based on their results, open the menu on the top right, which is set to All by default.
Click Test cases to see the details.
UI tests are grouped according to device while unit tests are grouped according to test cases.
You will find:
- The total number of tests you ran, as well as the ratio of successful and failed tests.
- The duration of each individual test (both unit tests and UI tests).
- In the case of UI tests, the orientation and the locale of the device.
You can check, depending on the test type:
- Individual test cases
- Performance data
- Test artifacts
As noted above, this depends on test type, too: for unit tests, you won’t see screenshots or videos, of course.
Downloading files ⚓
Every file can be downloaded from Test Reports: that includes screenshots, videos, or APK and IPA files.
- Open a test set.
On the left menu, click a tab that contains files.
For example, Test Artifacts.
Click Download next to the file name.
If you want to download all files available on the tab, click Download All Files.