To run Xcode tests on Bitrise, you need to have test targets defined in your projects. You need two Steps to run Xcode tests and view their results:
- Xcode Test for iOS.
- Deploy to Bitrise.io.
The Xcode Test for iOS step runs the pre-defined Xcode tests. It has a default configuration that will work if the tests are written correctly. You can find the same configuration options in Xcode, too.
You can also generate code coverage files, and export the test results as a compressed zip file.
Configuring the Xcode tests on Bitrise ⚓
The default input values of the Xcode Test for iOS Step could work if your tests are written correctly. However, we recommend making sure that all the inputs have the value you want so the Step can do what you need!
Check the following required inputs of the Xcode Test for iOS Step before running a build. These inputs determine the sort of tests the Step will run.
- Scheme name: the scheme you use must be marked as Shared in Xcode!
- Device: set it to the value that is shown in Xcode’s device selection dropdown menu.
- OS version: set it to the value that is shown in Xcode’s device selection dropdown menu.
- Platform: set it to the value that is shown in Xcode’s device selection dropdown menu.
Generating code coverage files ⚓
By default, the Xcode Test for iOS Step does not generate code coverage files. If you need them, however, it’s easy to change: just set the Generate code coverage files? to yes.
This sets two additional flags to the xcodebuild command:
xcodebuild GCC_INSTRUMENT_PROGRAM_FLOW_ARCS=YES GCC_GENERATE_TEST_COVERAGE_FILES=YES
If you run a successful build, code coverage files will be included in your results.
Exporting UI test artifacts ⚓
You can export the attachments of your UITest. These attachments include screenshots taken during the UI test, as well as any other artifacts that might have been generated. They are exported as a compressed zip file.
By default, the Xcode Test for iOS Step does not export artifacts of the UITest. If you want to export them, set the Export UITest Artifacts input of the Xcode Test for iOS Step to true.
You can check your test artifacts on the Test Reports page, along all additional results.
Deploy an app to Bitrise to be able to download the .ipa file and install it on devices specified in the app's Development Provisioning Profile. This way, your internal testers...
You can build and deploy your iOS application to a simulator, to show it off in a browser, for example. On Bitrise, we have a dedicated Step to build for...
With Bitrise's iOS device testing solution, you can run iOS tests on physical devices without having to set up and register your own devices: you just need to use our...