Troubleshoot Android Device Preparation and Connection

If Ranorex Studio cannot connect to an Android device, add it as an endpoint, or start and stop applications during testing, verify the device settings, USB or network connection, and Ranorex Service App.

The Android device does not appear in Ranorex Studio

Ranorex Studio requires USB debugging to communicate with an Android device through USB.

To verify the setting:

1. On the Android device, open Settings > Developer options.
2. Enable USB debugging.
3. Reconnect the device to the computer.
4. Accept the USB debugging authorization request if it appears on the device.
5. Try adding the device as an endpoint again.

For complete preparation instructions, see Prepare your Android Device.

Windows detects the device, but Ranorex Studio cannot connect

On some Android devices, the default Windows USB driver does not support USB debugging correctly. Windows may detect the device even though Ranorex Studio cannot connect to it or add it as an endpoint.

Install the manufacturer’s developer USB or ADB driver. Then, reconnect the device and try again.

A Wi-Fi connection cannot be established

For a Wi-Fi connection, the Android device and the computer running Ranorex Studio must be able to communicate over the network.

Verify that:

• The device and computer are connected to networks that allow communication between them.
• TCP port 31000 is not blocked.
• UDP port 31000 is not blocked.
• A firewall or other network security tool is not preventing communication.

When possible, use a USB connection. USB is generally more reliable and supports features that are unavailable over Wi-Fi, including unattended deployment and automation of Android system apps.

For connection requirements and supported functionality, see Connect your Android Device.

Ranorex cannot start or stop applications

The Ranorex Service App must be installed and running on the Android device. If the Service App is not running, Ranorex cannot start or stop applications, which limits mobile automation functionality.

To resolve the issue:

1. Verify that the Ranorex Service App is installed on the device.
2. Verify that its version is compatible with your Ranorex Studio version.
3. Start the Ranorex Service App.
4. Keep the app running during mobile testing.
5. Try starting or stopping the application again.

You can obtain a compatible Service App from the Mobile Downloads page.

The Ranorex Service App disconnects or stops running

Android battery optimization or background restrictions may interrupt the connection between Ranorex Studio and the Ranorex Service App.

Disable battery optimization or background restrictions for the Ranorex Service App and any related services used during testing. Also, enable Stay awake in the Android developer options to prevent the device from sleeping while it is connected.

Android blocks the Ranorex Service App installation or permissions

Android security settings may block installation of the Ranorex Service App or prevent it from receiving the required permissions.

Depending on the device and Android version, verify that:

• The app used to open the APK is allowed to install unknown apps.
• Google Play Protect is not blocking the installation.
• Allow restricted settings is enabled for Ranorex Services on Android 13 or later.
• Required permissions, such as Display over other apps, are enabled.

For the complete procedures, see Prepare your Android Device.