Mobile App Testing

QA.tech supports testing native iOS and Android applications using the same AI agent that powers web testing. The agent interacts with your app through touch gestures, hardware controls, and deep links - covering the full range of user interactions on a mobile device.

Network Access

QA.tech test runs originate from a fixed pool of IP addresses. If your app connects to a backend that has a firewall, VPN gateway, IP allowlist, or rate-limiting rules, you must whitelist these IPs to allow test traffic through.

Without whitelisting, your tests may fail with network errors, timeouts, or unexpected login failures even though the app itself works fine.

QA.tech IP Addresses

Find the current list of mobile testing IP ranges in the app under Settings → Network — see the Mobile Testing IP Whitelist section.

Mobile testing uses a different set of IP ranges than web testing, so the Outbound IPs API does not cover them. IP addresses may change — always use the live Mobile Testing IP Whitelist in Settings → Network as the authoritative source.

How to Add the Whitelist

Add the IP ranges from Settings → Network to your security system’s allowlist. The exact steps depend on your setup — see the IP Access Control guide for platform-specific instructions covering Cloudflare, AWS CloudFront, and other firewalls. Common places to add these rules:

Backend firewall or security group (AWS, GCP, Azure)
API gateway rate-limiting or allowlist rules
VPN / zero-trust gateway (e.g. Tailscale, Cloudflare Access, Zscaler)
Mobile backend service IP allowlists

Test Environments

Mobile tests run on cloud-hosted iOS Simulators and Android Emulators. Configure the simulator or emulator under Settings → Device Presets — see Mobile Device Presets for device model, OS version, orientation, location, network log capture, and override priority.

Environment	Status	Description
Cloud emulators	Available	iOS Simulator and Android Emulator in cloud
Real devices	Coming soon	Physical iOS and Android device testing

Debugging and Observability

Feature	Status	Description
Live view	Available	Watch tests run in real time from the test trace while a session is active
Network request logs	Available	Inspect HTTP requests in the test trace when network capture is enabled on the device preset
Device console logs	Coming soon	App console output in the test trace

AI Chat and Test Dependencies

When mobile testing is enabled for your organization, you can create, edit, and run mobile tests through the AI Chat Assistant — the same natural-language workflow as web testing. For test dependencies:

Wait For — supported. Use it to control execution order between mobile tests.
Resume From — not supported for mobile apps. Mobile tests cannot inherit app state from another test.

Coming Soon

Real device testing on physical iOS and Android hardware (selectable through device presets)
Device console logs in the test trace

Preparing Your App Build

Mobile testing requires a simulator or emulator build of your app, not an AppStore or Play Store distribution build. Follow the steps below for your platform.

iOS
Android

Prepare an iOS Simulator build (.app file compressed as .zip or .tar.gz). AppStore distribution builds (.ipa) are not supported - they are device-specific and cannot run on simulators.

Build with Xcode

Run and build your application in Xcode while targeting an iOS Simulator.Once the build is complete and the app is running in the simulator, locate the .app file:

In Xcode, go to Product → Show Build Folder in Finder
Navigate to Products/Debug-iphonesimulator/
Find your .app file

Build with Xcode Command Line Tools

xcodebuild -project '{project_name}.xcodeproj' \
  -scheme '{scheme_name}' \
  -sdk iphonesimulator \
  -configuration Debug

xcodebuild -workspace '{your_workspace_name}.xcworkspace' \
  -scheme '{scheme_name}' \
  -sdk iphonesimulator \
  -configuration Debug

The .app file is output to:

build/Debug-iphonesimulator/

Compress the .app file

Once you have the .app file, compress it before uploading:

zip -r AppName.zip AppName.app

Upload the resulting .zip (or .tar.gz) file - not the raw .app directory.

Prepare an APK file for your app. If your project produces an Android App Bundle (.aab), convert it to .apk first using the steps below.

Build with Android Studio

Select Build → Build APK(s) → Build APK(s)Once complete, click locate in the dialog that appears, or navigate to:

{project_name}/{app_module}/build/outputs/apk/

Build with Gradle

Run the assemble command for your preferred build variant:

./gradlew assembleDebug

The .apk file is output to:

{project_name}/{app_module}/build/outputs/apk/

Convert AAB to APK

If you only have an Android App Bundle (.aab), convert it using bundletool:

# Generate a universal APK set
bundletool build-apks --bundle=/{your_app}/{name}.aab \
    --output=/{your_app}/{name}.apks \
    --mode=universal

# Extract a single APK from the set
unzip -p /{your_app}/{name}.apks universal.apk > /{your_app}/{name}.apk

Upload the resulting .apk file.

Setting Up a Mobile App in QA.tech

Create a Mobile Application

In your project, go to Settings → Applications & Envs and create a new application. Select Mobile App as the application type.

Add an Environment

Add an environment to your mobile application. Select the platform - iOS or Android - and give the environment a name (for example: Staging or Production).No URL is required for mobile apps.

Upload Your App Build

Upload your app build file:

iOS: .zip or .tar.gz containing your .app simulator build (max 4 GB)
Android: .apk file (max 4 GB)

Create and Run Tests

Create tests for your mobile application. The AI agent will interact with your app using touch gestures and device controls.

AI Agent Capabilities

The agent interacts with your app using the following actions:

Touch Interactions

Action	Description
Tap	Tap at a specific point on the screen
Double tap	Double-tap at a specific point
Long press	Press and hold at a point for a configurable duration
Swipe	Swipe from one point to another
Type	Tap a field and type text
Clear and type	Clear an existing field value, then type

Device Controls

Action	Platforms	Description
Home button	iOS, Android	Press the device home button
Back button	Android only	Press the Android back button
App switcher	iOS, Android	Open the app switcher
Launch app	iOS, Android	Launch an app by bundle ID or package name
Close app	iOS, Android	Close the current app
Open URL	iOS, Android	Open a URL or deep link
Rotate	Android only	Switch between portrait and landscape
Volume up/down	iOS, Android	Press hardware volume keys

Requirements

Mobile testing is enabled per organization. Contact support to enable mobile testing for your account.

Get Started

Core Concepts

Configuration

Best Practices

Test Features

Integrations

Applications

CLI

Mobile App Testing

Mobile App Testing

Network Access

QA.tech IP Addresses

How to Add the Whitelist

Test Environments

Debugging and Observability

AI Chat and Test Dependencies

Coming Soon

Preparing Your App Build

Build with Xcode

Build with Xcode Command Line Tools

Compress the .app file

Build with Android Studio

Build with Gradle

Convert AAB to APK

Setting Up a Mobile App in QA.tech

AI Agent Capabilities

Touch Interactions

Device Controls

Requirements

​Mobile App Testing

​Network Access

​QA.tech IP Addresses

​How to Add the Whitelist

​Test Environments

​Debugging and Observability

​AI Chat and Test Dependencies

​Coming Soon

​Preparing Your App Build

​Build with Xcode

​Build with Xcode Command Line Tools

​Compress the .app file

​Build with Android Studio

​Build with Gradle

​Convert AAB to APK

​Setting Up a Mobile App in QA.tech

​AI Agent Capabilities

​Touch Interactions

​Device Controls

​Requirements

Mobile App Testing

Network Access

QA.tech IP Addresses

How to Add the Whitelist

Test Environments

Debugging and Observability

AI Chat and Test Dependencies

Coming Soon

Preparing Your App Build

Build with Xcode

Build with Xcode Command Line Tools

Compress the .app file

Build with Android Studio

Build with Gradle

Convert AAB to APK

Setting Up a Mobile App in QA.tech

AI Agent Capabilities

Touch Interactions

Device Controls

Requirements