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.
Rerunning failed tests ⚓
The Should retry test on failure? input in the Debug section of the Xcode Test for iOS Step allows you to automatically rerun your tests if they fail. If you set the input to
yes, the Step will run
xcodebuild with the
-retry-tests-on-failure flag so that it runs the tests again in case of failure.
With Xcode 13 and above, only your failed test cases will be rerun. With older Xcode versions, all test cases will be rerun. You can use this new Xcode feature with the Xcode Step for iOS Step from version 2.7.x and above.
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...