This article walks you through the fastest way to run your first mobile test: confirm requirements, connect a device as an endpoint, instrument an app, record a short test, and run it.
Before you start
To execute a test on a mobile device, you need to meet the following prerequisites:
Tip: If you haven’t set an automation root yet, set your mobile endpoint as the automation root before recording/running.
Connect your device and confirm it’s ready
- Start the Ranorex Service App on the device.
- Connect via USB (recommended) or WiFi.
- In Ranorex Studio, open Endpoints and confirm the device shows Connected.
If the device doesn’t connect, review your firewall/ports and device preparation steps (Android/iOS).
Instrument the app you want to test
- In Endpoints, open Endpoint settings for your device.
- Choose Instrument and deploy app (opens the instrumentation wizard).
- Instrument:
- Android app (APK), or
- iOS app (IPA / instrumented app flow)
Attention: Do not touch the screen or any buttons on the mobile device while the test is running. This would result in a test failure.
Note: The various available options for test runs are also the same as for other tests. For more information, refer to Execute a test suite.
Create a mobile test solution
Create a new solution (or add a module in an existing solution) for your mobile scenario:
- Choose Android or iOS as your target.
- Select App test or Mobile web test depending on your AUT.
Record a short flow and add one validation
- Click Record and perform a short, repeatable sequence.
- Add at least one validation (exists/visible/text) to confirm the expected state.
- Stop recording and review the action list.
Run the test and review the report
- Ensure the device remains connected and the endpoint is still Connected.
- Run the test suite.
- Review the report and verify that the validation passed.