Configuring the mobile test client for Android

To use an Android mobile device for recording or running tests, you must configure the mobile test client to connect to the test workbench.

Before you begin

The mobile test client must be installed and running on the Android device. For details about downloading and installing the mobile test client for Android, see Installing the Android client manually.

The mobile device must be able to establish a connection to the computer where the test workbench is running. You can use a wifi connection, a cellular data connection, or in v8.7 and later, a USB connection. For more details about establishing a USB connection, see Installing and configuring the Android client with the USB Controller

Note: If you already have the workbench URL and the QR code up on your screen from when you installed the mobile test client, you can skip the first two steps and proceed to Step 3.


To add a mobile device to the test workbench:

  1. In the Test Navigator view, right-click the Mobile Devices node and select Available Mobile Devices or click the Display available mobile devices Display available mobile devices icon. The Mobile Devices editor opens.
  2. In the editor, click the add device to list icon to add a device to the list. A window displays a list of workbench URLs and a QR code that contains the selected URL from the list.
    Note: If the device fails to connect using the first URL in the list, try an alternate URL.
  3. On the mobile device or on an emulator, start the mobile client.
  4. Complete one of the following steps:
    1. If the mobile device is equipped with a rear camera, tap the QR code button and scan the QR code that is displayed on the test workbench. This is the same QR code from when you installed the mobile test client. This step is not applicable to the emulator.
    2. Tap Configure Workbench > Address and type the URL manually. This step is triggered automatically if no rear camera is detected.
    On the first client start, you do not need to tap the QR code button, or type the workbench address. These actions are executed automatically.


The name and properties of the device are displayed in the test workbench, in the Mobile Devices editor.