> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noqa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Local Builds

> How to use builds for local testing on iOS and Android devices/emulators.

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:

<Steps>
  <Step title="Archive your app in Xcode">
    Open your project in Xcode. Select <b>Product → Archive</b> from the menu.
  </Step>

  <Step title="Export as .ipa">
    In the Organizer window, select your archive and click <b>Distribute App</b> → <b>Ad Hoc</b>.
  </Step>

  <Step title="Upload .ipa in Dashboard">
    In the Dashboard, go to <b>Test Cases</b>, click <b>Select build</b>, and add your .ipa file.
  </Step>
</Steps>

### 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.

<Tip>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.</Tip>

## Android Builds

### APK Builds

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

<Steps>
  <Step title="Build APK in Android Studio">
    Open your project in Android Studio. Select <b>Build → Build Bundle(s) / APK(s) → Build APK(s)</b> from the menu.
  </Step>

  <Step title="Locate the APK">
    After the build completes, Android Studio will show a notification with a link to the APK location (usually in <code>app/build/outputs/apk/</code>).
  </Step>

  <Step title="Upload .apk in Dashboard">
    In the Dashboard, go to <b>Test Cases</b>, click <b>Select build</b>, and add your .apk file.
  </Step>
</Steps>