Welcome to the Ranorex Support Portal

Create a mobile test

In this chapter, you’ll learn about the basics of creating a mobile test in Ranorex Studio.

In this chapter


Before creating a mobile test, make sure you’ve completed all the necessary preparations:

  1. Apply the necessary ⇢ device settings to your device and install the Ranorex Service App.

  2. ⇢ Connect your device to the computer and ⇢ add it as an endpoint in Ranorex Studio.




If you want to test a mobile app, ⇢ instrument the app.


If you want to carry out a web test on your device, ⇢ install the preinstrumented Ranorex Web Browser for Android (recommended) and/or iOS (required).

Create a solution for mobile testing

To create a mobile test, you must use the RocketStart Wizard.

  1. On the Ranorex Studio start page, click New solution using wizard… or click File > New > New solution using wizard…

  2. Click Mobile.

  1. Follow the instructions of the wizard.


When you get to the screen below, choose which kind of mobile test you want to create and click Continue.


Mobile iOS app test


Mobile Android app test


Mobile iOS web test


Mobile Android web test

  1. Depending on your choice, the wizard will show you a checklist of necessary preparations. If you followed our instructions under Prerequisites, you should already have completed all of them. Click Continue.

  2. Click Finish.

The prebuilt web test will look like this:

  1. Test suite view
    This is where you build and control your tests.

  2. The test suite contains a test case with the empty recording module Recording1.

  1. Recording module view
    In the recording module view of Recording1, you can start creating your mobile test by adding actions.

  2. Empty actions table
    This is where your actions appear.

Create a mobile test

Now that we have our solution, we can start creating the actual mobile test. The procedure is different from that for creating desktop or web tests, but it’s not complicated.

  1. Click RECORD.

  2. The dialog for selecting the mobile device and instrumented app appears.

  1. Select your device and app. If you select the Ranorex Web Browser, also specify the URL for the mobile web test.

Depending on your choice, different test types result. In our example:

  1. Mobile Android web tests using the preinstrumented Ranorex Web Browser

  2. Mobile Android app test using the instrumented Dropbox app

  3. Mobile iOS web tests using the preinstrumented Ranorex Web Browser

  4. obile iOS app test using the instrumented MiniKeePass app

Note Icon


If your app doesn’t appear for selection, make sure that you’ve instrumented it correctly.

Setup mobile test building

  1. Click Create to start the setup process for mobile test creation.

Ranorex Studio will automatically carry out the following processes to set up mobile test building:

In Ranorex Studio

Ranorex Studio starts the selected app on your mobile device and adds the respective action in the action table.

  1. The RUN button changes to reflect that it now runs the test on the current automation root, i.e. the active endpoint/mobile devices, not the computer.

  2. An action that starts the app on the mobile device has been added to the action table.

On the mobile device

The instrumented device starts on the mobile device. In our case, this is the Dropbox mobile app.

Note Icon


Regarding mobile iOS applications, it is necessary that the Ranorex Service Application is running and active on the mobile device. Ensure that it is not running in the background as this may prevent you from using the start/stop functionality for the mobile application.

Ranorex Spy

Ranorex Spy starts in live tracking mode for all UI elements of the instrumented mobile app.

  1. Element browser in Spy showing all the UI elements of the instrumented app.

  2. Live view of the instrumented app on the mobile device

Build the test

Building a mobile test consists of two consecutive, iterated steps:

Step 1: Tap, Track, and Add

In this step, you add a UI element as a repository item to Ranorex Studio to make it available for use in actions.

  1. Tap: Make the element visible in the app, e.g. by tapping it.

  2. Track: Update the live tracking in Spy by clicking Browse endpoint or Refresh.

  3. Add: Select the element in the element tree, right-click it, and add it to the repository. Alternatively, drag and drop it in the repository.

Step 2: Drag, Drop, and Define

In the second step, you “process” the UI element, i.e. you use it in an action.

  1. Drag: From the repository, drag the repository item to the desired position in the action table.

  2. Drop: Drop it by releasing the left mouse button. The context menu opens. Select the desired action.

  3. Define: Make any necessary configurations to the action, e.g. setting timeouts, content of key sequences, etc. The finished action is shown in the action table, linked to the repository item representing the respective UI element in the app.



You can find step-by-step instructions for creating mobile tests in

Web and mobile testing -> Mobile testing > ⇢ Android app testing example / ⇢ Android mobile web test example

Web and mobile testing -> Mobile testing > ⇢ iOS app testing example / ⇢ iOS mobile web test example

Tips for efficient test building

Remote control your app from Spy

You can remote control your app through Spy. This way, you won’t have to carry out all the actions to bring up menus and different screens in the app on the actual mobile device.

  1. In the live view of Spy, right-click a UI element and click Touch/Tap.

  2. The action is executed on your mobile device as if you actually touched the screen.

Enter text in Spy instead

You can also enter text in a similar way.

  1. In Spy, with a UI element selected, click the Advanced tab.

  2. Find the Text attribute, enter your text, and confirm with Enter.

  3. The text appears in the mobile app as if you typed it in using the screen keyboard.



Get the latest test automation information right in your mailbox.


© 2024 Ranorex GmbH. All Rights Reserved