Prepare your device

Before you can connect your device to Ranorex Studio and add it as an endpoint, you need to make certain preparations.

Activate developer mode

Mobile testing requires that some developer mode settings be activated. This mode is normally hidden on Android devices. To activate it:

1. Go to your device’s settings.

2. Find the Build number entry. It’s normally located in the About section, but the exact location may vary depending on the device manufacturer and Android version. Refer to your device’s documentation for more information.

3. Tap the Build number quickly seven times.

4. The notification You are now a developer indicates that developer mode is now active.

1. The settings should now contain an entry called Developer options

Activate Stay awake

Enable USB debugging

1. In the Developer options, enable USB debugging.

2. Confirm.

Attention
For some Android devices, USB debugging does not work with the default Windows USB driver. This makes testing with Ranorex Studio impossible. In these cases, you need to install the device manufacturer’s special developer USB drivers.
You can normally see that this is the case if Windows recognizes your device correctly, but you can’t add it as an endpoint in Ranorex Studio.

Connect your device to a power source

Regardless of the connection type (USB/WiFi), make sure that your device is connected to a power source at all times during test creation and execution.

This ensures that everything runs as intended and is particularly important for WiFi connections, as it deactivates power saving.

Deactivate Auto-Lock

1. Go to your device’s settings.

2. Select Display & Brightness.

3. Set Auto-Lock to Never.

Connect your device to a power source

Regardless of the connection type (USB/WiFi), make sure that your device is connected to a power source at all times during test creation and execution.

This ensures that everything runs as intended and is particularly important for WiFi connections, as it deactivates power saving.

To create and run mobile tests on your mobile device, you need to install the Ranorex Service App on your device.

You can install it on your device by running the Instrumentation Wizard or by downloading the app.

Update Service Instrumentation Wizard

After you have added your Android device as an Endpoint, run the Instrumentation Wizard.

1. Select Instrument a mobile device and click Next.
   
   

2. Choose between iOS and Android. Click Next.
   
   

3. Under the Instrument, a mobile device screen, select a device from the drop-down list and click Next.
   
   

4. When the Ranorex Service is not installed on your device, the Instrumentation Wizard opens the Update Service tab. Select the Update checkboxes for Ranorex Service and Ranorex Web Testing and click Finish.
   
   

5. Once the Operation successful message displays, click Finish.
   
   

Hint
After performing the update of the Ranorex services or any other changes on your devices, refresh the registered Endpoints.

Download Ranorex Service App

Go to https://support.ranorex.com/rxApp to download the Ranorex Service App.

Mobile download archive

The mobile download archive is categorized according to Ranorex Studio versions and mobile OS. Simply download the correct Ranorex Service App.

1. Ranorex Service App for Android

2. Ranorex Service App for iOS

Install the Ranorex Service App on Android

1. Tap the download link.

2. Confirm the security dialog.
   

3. Tap Settings in the following dialog.

4. Enable Allow from this source.
   
   

5. Confirm the access dialog.
6. The Ranorex Service App has been installed successfully.
   

Your Android device is now ready to be connected to Ranorex Studio.

Install the Ranorex Service App on iOS

1. Tap the download link.

2. Confirm the security dialog.
   

3. The Ranorex Service App appears on the home screen.
4. iOS considers the Ranorex Service App “untrusted” because it wasn’t downloaded from the App Store. Close the dialog.
   

Confirm Ranorex Service App as trusted

Before you can use the Service App, it needs to be trusted.

1. Go to Settings > General.

2. Go to Device Management.
   
   

3. Tap Ranorex GmbH.
4. Tap Trust “Ranorex GmbH”.
5. Tap Trust.
6. The Ranorex Service App is now trusted.

Your iOS device is now ready to be connected to Ranorex Studio.