Building XCUITest
To test with XCUITest on TestingBot, you will need to build and export the XCUITests you have created.
If you do not have a zip file of the XCUITest suite, you can follow the examples below.
The zip file should contain a folder similar to this:
xcuitest-sampleUITests-Runner.app
Code signing is not required. TestingBot re-signs the app and the test runner for its own devices before installing them, so you do not need a provisioning profile that includes TestingBot's devices. You can build without signing (CODE_SIGNING_ALLOWED=NO), which also means your CI machine does not need your certificates. Build for a device (Debug-iphoneos), not for the simulator: XCUITest runs on real devices on TestingBot.
Using XCode (13 and higher)
- From the XCode schemes dropdown menu, select your app scheme and Any iOS Device as device
- Click Product -> Clean (
Cmd+Shift+K) - Click Product -> Build For -> Testing (
Cmd+Shift+U) - Go to Product -> Show Build Folder in Finder
- In Finder, navigate to Products -> Debug-iphoneos. The directory should contain a file that ends with
-Runner.app.
Right click and choose the compress option to generate azipfile.
Using XCode (Lower than 13.0)
- From the XCode schemes dropdown menu, select your app scheme and Generic iOS device as device
- Click Product -> Clean (
Cmd+Shift+K) - Click Product -> Build For -> Testing (
Cmd+Shift+U) - Right click the
.appfile using the Project Navigator, and select Show in Finder - In Finder, the directory should contain a file called
<AppnameUITests>-Runner.app.
Right click and choose the compress option to generate azipfile.
Using Command Line
To build the .zip file from the command line, please follow these steps:
-
Change to the project directory and build for testing:
xcodebuild build-for-testing \ -scheme <scheme-name> \ -destination 'generic/platform=iOS' \ -derivedDataPath build \ CODE_SIGNING_ALLOWED=NOCODE_SIGNING_ALLOWED=NOis optional: TestingBot re-signs the build, so an unsigned build works. -
Go to the products folder for devices,
build/Build/Products/Debug-iphoneos(with-derivedDataPath buildas above; otherwise it is inside Xcode's DerivedData directory, see Settings -> Locations). -
Zip the test runner, and package the app as an
.ipa(a zip with the app inside aPayloadfolder):
cd build/Build/Products/Debug-iphoneos zip --symlinks -r <MyAppUITests>.zip <AppnameUITests>-Runner.app mkdir Payload cp -R <Appname>.app Payload/ zip -r <Appname>.ipa Payload rm -rf Payload