Set up UFT One for basic mobile testing

This topic describes how to set up UFT One and your mobile devices for basic mobile testing, on one device at a time.

For full mobile testing functionality, set up UFT One to integrate with Digital Lab (UFT Mobile). See Set up UFT One for advanced mobile testing.

Basic mobile testing on local devices

You can test applications on a local mobile device that is physically connected to your UFT One computer.

Tip: Testing on iOS devices requires more set-up intervention than testing on Android devices. Pay attention to the preparation steps described in the sections below.

To test applications on local mobile devices, you must install a program that acts as a local device connector:

UFT One versions 2023 or later Digital Lab Lite for Local Devices
UFT One versions 2022 and earlier UFT Mobile Add-in for Local Device

These programs are powered by Digital Lab (UFT Mobile) and support mobile testing similarly. Working with Digital Lab (UFT Mobile) supports a wide variety of mobile testing features. Mobile testing on local devices supports only some of these features.

Mobile testing on local devices provides the following functionality:

  • Spy on and learn mobile and web application objects, on one device at a time and one application at a time.

  • Create, record and run tests on mobile and web applications, one device at a time and one application at a time.

  • Authentication methods, such as fingerprint and Face ID simulation are supported on packaged applications.

The following functionality is not supported when testing on local mobile devices connected physically to your UFT One computer:

  • Simulation methods, such as QR code and barcode simulation, and photo and video simulation.
  • Network virtualization.
  • Service virtualization.
  • Parallel testing.

Note: The same functionality is supported / not supported when opening a mobile application from UFT One in a remote access window.

Install the Digital Lab Lite for Local Devices

For basic mobile testing, on one device at a time, you can connect mobile devices directly to the UFT One computer. On the UFT One machine, install the program that acts as a local device connector:

UFT One versions 2023 or later Digital Lab Lite for Local Devices
UFT One versions 2022 and earlier UFT Mobile Add-in for Local Device
System requirements

The installation requirements are as follows:

64-bit Windows machine

Free RAM: 1 GB minimum (2 GB recommended)

Hard disk space: 10 GB

  • General installation: 2 GB minimum (5 GB recommended)

    • Installation Directory: 2 GB

      Note: You may require more space depending on the number of apps or app uploads you perform. For example, if the app size is 20 MB, and you have uploaded the same app 100 times, the required size is 2 GB.

    • Temp directory (\Temp): 5 GB

An additional 1 GB of free disk space is required on the system disk (the disk upon which the operating system is installed).

Download the Digital Lab Lite for Local Devices

Download the program from the Micro Focus AppDelivery Marketplace:

UFT One versions 2023 or later Download Digital Lab Lite for Local Devices
UFT One versions 2022 and earlier Download UFT Mobile Add-in for Local Device

Make sure you download a version that is compatible with your UFT One version. To check version compatibility, see the Digital Lab (UFT Mobile) Support Matrix.

Note: The versions or Digital Lab Lite for Local Devices (or UFT Mobile Add-in for Local Device) that are compatible with UFT One are the same as the specified Digital Lab (UFT Mobile) versions.

Install the Digital Lab Lite for Local Devices

Install the Digital Lab Lite for Local Devices or UFT Mobile Add-in for Local Device that you downloaded. This program acts as a local device connector.

During the installation, do the following: 

  1. Service port and Internal port. Modify the port numbers if the default numbers (8080, 8081) are needed by other applications. Make sure the internal port is not accessible externally.

    Remember the Service port number for subsequent use in UFT One configuration.

    Note: To modify port numbers after installation, uninstall and reinstall the program again.

  2. Android SDK. The installation includes an Android SDK, used to communicate with Android devices. You can specify that you want to use a different Android SDK installation.

  3. Run the service. For UFT One to connect to your local devices, the Digital Lab Lite for Local Devices or UFT Mobile Add-in for Local Device service must be running.

    Select the Turn on the service option in the installation wizard to run the service after installation.

    To start, stop, or restart this service after installation, use the options available under Start Menu > Programs > Digital Lab Lite for Local Devices or UFT Mobile Add-in for Local Device.

    Alternatively, you can access the Digital Lab Lite or UFT Mobile Add-in service directly in the Task Manager's Services tab.

Back to top

Prepare your device and applications

The table below describes how to connect your mobile device to the UFT One computer, and prepare your applications for testing.

UFT One versions 2022 and earlier: Digital Lab Lite for Local Devices is known as UFT Mobile Add-in for Local Device.

Connect your devices

Prepare your devices for mobile testing and connect them to the UFT One computer via USB cable. You can connect multiple devices, but you can only test one device at a time.

The Digital Lab Lite for Local Devices, which connects the local devices to UFT One, is powered by Digital Lab (UFT Mobile). Therefore, it supports the same device types as Digital Lab (UFT Mobile), with similar requirements.

For details, see the following topics in the Digital Lab (UFT Mobile) Help:

  • Connect devices to Digital Lab (UFT Mobile)

    The Digital Lab Lite for Local Devices uses agent apps to communicate with iOS devices. When connecting iOS devices, you need to re-sign the agent apps with a Development certificate of an Apple Developer account, and a development provisioning profile belonging to the same account. Use a Mac machine to re-sign the apps.

    Note: 

    The instructions in the Digital Lab (UFT Mobile) Help tell you to download the agent apps from the Digital Lab (UFT Mobile) Lab console.

    For local device testing, copy the agent app (.ipa) files from this folder instead: <Digital Lab Lite for Local Devices installation folder>\server\Agent.

    After signing the agents, replace the original agent app files with the signed ones, maintaining the original file names.

  • Connect devices and verify the connection

  • Troubleshooting and tips

Prepare your apps

If your Android or iOS apps need preparation for testing, such as signing or packaging, you must do these before you start testing.

Follow the instructions in the Digital Lab (UFT Mobile) Help, and keep the following in mind: 

  • To test packaged apps on local devices, you must package them yourself. To do this, use the packaging tools available on the Micro Focus AppDelivery Marketplace.

    To download the tools, select the Digital Lab (UFT Mobile) page whose version is the same as your Digital Lab Lite for Local Devices. Scroll down and locate the packaging tools you need.

  • Note that to package and sign an iOS app, you need the Development certificate of an Apple Developer account, a development provisioning profile belonging to the same account, and a Mac machine.

Handle your apps after upgrading the Digital Lab Lite for Local Devices

If you've upgraded Digital Lab Lite for Local Devices, ensure that the app you are testing is compatible with the current version of Digital Lab Lite for Local Devices.

Do the following:

  1. Remove all apps that were installed on your device using the previous version.

  2. Replace any packaged apps with apps that are packaged using the new version of the packaging tools.

  3. Before running existing tests, select the Install check box in the Record and Run Settings to instruct Digital Lab (UFT Mobile) to install the application before running it.

    For more details, see Define Mobile Record and Run Settings.

Back to top

Start UFT One and load Add-ins

Before working with mobile devices, clear your browser cache on the UFT One computer and load the Mobile Add-in.

Additionally, load the Web Add-in if you are creating tests on any of the following:

  • Hybrid apps

  • Web apps using the Chrome emulator

  • Web apps using the Digital Lab Browser (UFTM Browser) app through Digital Lab (UFT Mobile)

Tip: If you want to create new tests, load the add-ins from the UFT One Add-in Manager. For details, see Manage add-ins. If you are modifying or running existing tests, UFT One will load the necessary add-ins once you open the tests.

Back to top

Connect UFT One to your mobile device

To connect UFT One to the mobile device that you connected via USB cable to the computer, follow the instructions in this section: Connect to Digital Lab or local mobile devices.

Back to top

Set up UFT One to record and run tests on the device

After connecting your device and setting up your applications, you can open the Record and Run settings dialog box. Here you can select the device and application that you want to use for your test.

For details, see Define Mobile Record and Run Settings.

Back to top