Mobile App Testing

Aiqaramba can install an Android APK on a hosted emulator and let a mobile agent test it from natural-language instructions. Mobile testing is in early access. Device startup can take time, and a run can remain queued while the limited emulator pool is busy.

Current support: Android APK files up to 500 MB. iOS applications and Android App Bundles are not supported.

The workflow

Upload the APK. Open Mobile Apps, use the API, or attach the APK in assistant chat.
Create a test. Select Android as the device and choose the uploaded mobile app.
Describe the goal. Name visible labels, required data, credentials, and the result to verify.
Run and review. The run records its actions, screenshots, result, and findings like a browser test.

An Android test can omit the mobile app. In that case, the agent starts from the emulator home screen.

Write durable mobile prompts

Describe what a person should accomplish. Do not encode screen coordinates or a brittle sequence of gestures.

Open the app and sign in with the supplied test account. Add the first available product to the cart. Complete checkout with the test payment details. Verify that an order confirmation and order number appear.

Provide credentials and test data that the flow requires.
Name visible text when several controls could match the same action.
End with an observable result that the agent can verify.
Attach a mailbox when signup, verification, or password reset needs email.

Networking and app builds

The hosted emulator must reach every backend used by the APK. Localhost and private development networks are not reachable without a public tunnel.

Each upload creates an immutable mobile-app record. Upload a new record for each build, then update the tests that should use it.

You cannot delete an app while a queued or active test run uses it. Wait for those runs, or stop them first.

Use the API

Upload an APK directly:

curl -X POST "$AIQARAMBA_URL/api/v1/mobile-apps/upload" \ -H "Authorization: Bearer $AIQARAMBA_API_KEY" \ -F "file=@customer-app.apk"

Then create a saved Android test with the returned ID:

{ "project_id": "...", "name": "Android checkout", "prompt_template": "Sign in, complete checkout, and verify the order number.", "device": "android", "app_artifact_id": "..." }

Open the Mobile Apps API reference.

Discover an Android app

A mobile discovery explores the installed APK, maps its screens and flows, and proposes reusable tests. Select Android and the uploaded app when creating the discovery.

Review the proposed tests before saving them. Add credentials or setup details that the discovery could not infer.