Mobile App Testing

Test native iOS and Android apps with AI-powered automation

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 currently run on cloud-hosted iOS Simulators and Android Emulators. Real device testing on physical iOS and Android hardware is coming soon and will be selectable through device presets.

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

The device model and OS version used for a test are selected automatically based on your uploaded app build. Device selection through device presets is coming in a future update.

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

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:

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

Build with Xcode Command Line Tools

.xcodeproj

xcodebuild -project '{project_name}.xcodeproj' \
  -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.

Android

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

1. Create a Mobile Application

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

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

3. 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)
4. 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.