Prepare your device | Ranorex
Help CenterUser GuideWeb and mobile testing

Prepare your device

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

In this chapter

    Android device settings

    Activate developer mode

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

    Go to your device’s settings.

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

    Tap the Build number quickly seven times.

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

    The settings should now contain an entry called Developer options:

    Activate Stay awake

    Enable USB debugging

    In the Developer options, enable USB debugging.

    Confirm.

    tipp icon

    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.

    iOS device settings

    Deactivate Auto-Lock

    Go to your device’s settings.

    Select Display & Brightness.

    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.

    Install the Ranorex Service App

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

    Where can I find the Ranorex Service App?

    Scan the QR code below or go to https://www.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.

    Ranorex Service App for Android

    Ranorex Service App for iOS

    Install the Ranorex Service App on Android

    Tap the download link.

    Confirm the security dialog.

    Tap Settings in the following dialog.

    Enable Allow from this source.

    Confirm the access dialog.

    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

    Tap the download link.

    Confirm the security dialog.

    The Ranorex Service App appears on the home screen.

    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.

    Go to Settings > General.

    Go to Device Management.

    Tap Ranorex GmbH.

    Tap Trust “Ranorex GmbH”.

    Tap Trust.

    The Ranorex Service App is now trusted.

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