Installing the Android client with the Android Debug Bridge (adb)

On some mobile devices, it might not be possible to install the Android mobile test client by downloading the installer. This topic describes an alternative installation method that uses a USB connection and the adb tool that is provided with the Android SDK.

Before you begin

  • For Android 6 devices that are connected to the computer running HCL OneTest™ UI with a USB cable, open Device Settings > Developer Options on the device and deselect Verify apps over USB. Otherwise, a conformation dialog opens each time the mobile test client or an application under test (AUT) is installed.

Procedure

To install the mobile test client with adb.

  1. Enable USB debugging on the mobile device:
    • On Android 3.2 and earlier versions, tap Settings > Applications > Development and select USB Debugging.
    • On Android 4.0 and 4.1, tap Settings > Developer options and select USB Debugging.
    • On Android 4.2 and later, tap Settings > About phone and tap Build number seven times. Then, return to the previous screen, tap Developer options and select USB Debugging.
  2. Connect the Android device with a USB cable to the computer that is running the HCL OneTest UI. Some mobile devices might require a specific USB driver. If necessary, download and install the driver at http://developer.android.com/tools/extras/oem-usb.html or the web site of the device vendor.
  3. In the test workbench, find the Workbench URL by clicking the Display Workbench URL icon Display Workbench URL as shown below:

    Display Workbench URL

    Copy the Workbench URL to the clipboard.

  4. Open a web browser and paste the Workbench URL in the browser navigation bar.
  5. In the HCL OneTest UI - Mobile Welcome Page, click Proceed with Android instructions.
  6. In the section for using adb to install the mobile test client, click Show the steps.
  7. Click to download the mobile test client application package (apk).
  8. Copy the downloaded com.ibm.rational.test.mobile.android.client.ui-release.apk to a temporary folder, such as C:\tmp.
  9. Open a command prompt window and point to the directory where you installed the Android SDK, for example C:\Users\Administrator\AppData\Local\Android\android-sdk\platform-tools.
  10. To install the mobile test client, type the first command below if you do not already have a version of the mobile test client installed on the device. Type the second command (with the -r option) to upgrade the mobile test client from an earlier version.

    adb install temporary folder/com.ibm.rational.test.mobile.android.client.ui-release.apk

    adb install -r temporary folder/com.ibm.rational.test.mobile.android.client.ui-release.apk

What to do next

After installing the mobile test client, configure and connect the device to the test workbench. See Configuring the mobile test client for Android.

Feedback