Skip to main content
You can run tests locally on your own iOS or Android devices and emulators using different build types.

​
iOS Builds

​
IPA Builds

To use a custom IPA build, you need to export your app from Xcode. Follow these steps:
1

Archive your app in Xcode

Open your project in Xcode. Select Product → Archive from the menu.
2

Export as .ipa

In the Organizer window, select your archive and click Distribute App → Ad Hoc.
3

Upload .ipa in Dashboard

In the Dashboard, go to Test Cases, click Select build, and add your .ipa file.

​
TestFlight

You can use the latest available build from TestFlight for your app. Requirements:
  • Your Apple ID must have access to the app in TestFlight
  • The app must be visible in your TestFlight account
The agent will always use the most recent build available for testing.

​
No build

If your app is already installed on the device, you can skip the build step entirely — just select “No build” and the agent will use whatever is currently on the device.
This is especially useful during development. If you have your app running on a simulator or device via Xcode, Expo, or Android Studio, you can start testing immediately without exporting a build. See For Developers for more.

​
Android Builds

​
APK Builds

To use a custom Android build, you need to generate an APK from Android Studio. Follow these steps:
1

Build APK in Android Studio

Open your project in Android Studio. Select Build → Build Bundle(s) / APK(s) → Build APK(s) from the menu.
2

Locate the APK

After the build completes, Android Studio will show a notification with a link to the APK location (usually in app/build/outputs/apk/).
3

Upload .apk in Dashboard

In the Dashboard, go to Test Cases, click Select build, and add your .apk file.