Connect Android mobile devices

You can connect Android devices to the UFT Mobile server, or to a connector machine.

Initial device configuration

When connecting the device for the first time, there are a few steps that you need to perform on each device that you intend to connect to UFT Mobile. After the initial connection has been set up, the device is "plug-and-play".

  1. Check that your devices are supported by UFT Mobile.
  2. Enable Developer options. In general, on most devices with Android 4.2 and higher, you can do this by navigating to Settings > About phone and tapping the Build number seven times.
  3. Under Developer options, enable the following:

    • Stay awake
    • USB debugging
    • Allow mock locations

      To enable GPS simulation when using Android 6.0 and higher, set the mock location app to UFTM Agent after connecting the device UFT Mobile. (Settings > Developer options > Select mock location app). If you reinstall the Agent for any reason, you will need to repeat this step.


  4. Under Developer options, disable Verify apps via USB (available in Android 4.20 and higher).
  5. Enable the following additional settings:
    • In Settings > Display, select Auto rotate screen.
    • If you simulate GPS events during your test, prevent collisions with your real location from WiFi/3G/LTE by enabling GPS only in Settings > Location > Mode.
  6. If required by the apps being tested, make sure that there is an active Internet connection.

Back to top

Setup for certain Samsung devices

For Samsung devices running an Android version below 9.0, perform the following steps to allow access via the remote device view. Some of the devices with this known issue are Note 8 (SM-N950F), Note 9 (SM-N960F), S9 (SM-G960F), and S9 Plus (SM-G965F).

  1. Locate the connector.properties file.

    Server and Connector: <path to your UFTM server installation folder>/server/conf

    Remote Connector: <path to your UFTM connector installation folder>/connector/conf

  2. Open the file and add the device models, separated by commas, to the android.javavnc.model.enable property. For example:

    android.javavnc.model.enable=LG-H990,Nexus 5X,Nexus 4,LG-H961N,Nexus 9,LG-H870,ONEPLUS A5000,LG-D855,ONEPLUS A3000,SM-N950F,SM-N960F,SM-G960F,SM-G965F

  3. Restart the Server/Connector for the changes to take effect.

Note: These steps are not required for Micro Focus hosted devices.

Back to top

Connect devices to UFT Mobile

Devices can be connected to the UFT Mobile server, or to a connector machine. If you are connecting devices to a connector machine, see Install the connector on a Windows machine, Install the connector on a Mac machine, or Install the connector on a Linux machine machine.

Before connecting a device, clean the device of all apps that were installed using a previous version of UFT Mobile.

To connect a device to the UFT Mobile server:

  1. Connect the device to the server machine using a USB cable.

    Note: On some devices, when you connect the device via USB, a security message opens requesting you to allow USB debugging or trust the connected computer. Accept the warning.

    The following are automatically installed on the connected device:

    • Services for the remote viewer
    • The Agent application

    A number of settings are also configured on the device.

  2. Wait until the Agent is running on the device. If the automatic connection to the Agent does not succeed, see Troubleshooting Android devices.

Back to top

Troubleshooting Android devices

For device-specific issues, see Known Issues in the Certified devices section.

Back to top

See also: