Dev Access

The Dev Access plugin (Android) and app (iOS) provide a user-friendly interface for connecting to and interacting with devices in the UFT Mobile lab, from within your integrated development environment (IDE).

Prerequisites

For iOS, you must have the socat tunneling tool on your machine.

To install it on a Mac machine, run the brew command:

brew install socat

If you do not have brew package manager, retrieve and install it with the following command :

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Note: If you have SIP (System Integrity Protection) enabled, you will not be able to install brew with the curl command. Disable SIP to use the above command.

Install Dev Access

This sections explains how to install Dev Access for Android and iOS devices.

Android

To connect to Android devices, install the plugin from the JetBrains Marketplace.

To overcome known issues caused by the JDK version running your IDE, we recommend running the plugin with the Jetbrains Runtime environment. This enviroment fixes various bugs and known issues with official JDK builds, and provides better stability.

To download Jetbrains Runtime in your IDE (Android Studio/ Intellij):

  1. Select SettingsPlugins and search for the Choose Runtime plugin. Download and install the plugin, and then restart your IDE.
  2. In the Help Menu, click Find Action and search for Choose Runtime.
  3. Search for a Java runtime version name beginning with jbrsdk. Select the runtime, and then download and install it.

iOS

  1. To connect to iOS devices download the app from UFT Mobile as follows:
    • Navigate to the DEVICE LAB > DEVICES page. Hover over the device's card and click the Dev Access , or in list mode, select a device and click Dev Access.
      • Select the Mac operating system and click Download.
  2. Extract the files on your IDE machine.
  3. Open Terminal and grant execution permission to the files by running the following command in the folder to which you extracted the files:
    sudo chmod –R 777 *

Back to top

Configure settings

Before starting, make sure that have an execution token. If not, generate one. For details, see Generate and manage access keys (non-admin users).

  1. Open the plugin/app. For iOS, users with sudo permissions can double click dev-access-ui.command to open the dev access interface.
  2. In the Settings tab, provide the following:
    • URL for the UFT Mobile server and port.
    • Your execution token
    • If connecting via proxy server, specify the details of the proxy machine.
    • ADB execution file path (Android only): This is automatically detected from your IDE. You can browse to select a different ADB version file if needed.
    • Click Log in.

Back to top

Connect to Lab devices

  1. Select the Devices tab.
  2. Enable the connection by clicking the Enable UFT Mobile Dev Access radio button.
  3. Select a UFT Mobile workspace. The list of devices allocated to that workspace and all shared devices are displayed.
    Note that the Android plugin displays Android devices only. The iOS app displays iOS devices only.
  4. Select a device from the list, and click CONNECT DEVICE. Repeat this step to connect to multiple devices. For iOS, you can connect to multiple devices provided that they are connected to the same conector.
  5. When you connect to a Lab device, the remote device view opens and you can interact with the device.
  6. To end a device session, select the device in the list and click DISCONNECT DEVICE.

Note that you cannot access local devices while Dev Access is enabled. To switch back to your local devices, click the disable UFT Mobile Dev Acces radio button.

Back to top

Known issues

Android:

  • When using the Dev access plugin with Android Studio using JDK 11 or above, the remote device viewer shrinks. This issue is caused by JavaFX not respecting the Windows OS scale.
    Workaround: In Settings >Display > Scale and Layout> Change the size of text, app, and other items change the scale to 100%.
  • When using JRE/JDK version 8u211/8u212/8u222, a white screen is displayed on the remote device viewer. This issue is resolved when using JDK 8u231

iOS:

  • Dev access is not supported if there is firewall or proxy between the connector and dev-access client.
  • Dev access is not supported for hosted devices.

  • If you launch Xcode after starting a session on an iOS device, the CPU usage for Dev Access will reach 100%.
  • On macOS Catalina, you may need to click multiple times on the DISCONNECT DEVICE button to stop a session.
  • On macOS Catalina, you may be unable to paste access keys to the GUI tools.
    Workaround: Open the Dev Access CLI tools, copy & paste the token to the CLI tools, and then reopen the GUI tools .

See also: