Set up basic mobile testing

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

For full mobile testing functionality, set up OpenText Functional Testing to integrate with Digital Lab. See Set up advanced mobile testing.

Overview

To test applications on a mobile device, you must perform a number of tasks.

Task Details
Setup for mobile testing

Set up basic mobile testing (the current topic) or Set up advanced mobile testing

Record a mobile test Record Mobile tests
Edit a mobile test Edit Mobile tests
Run a mobile test Run Mobile tests

Back to top

Basic mobile testing on local devices

You can test applications on a local mobile device that is physically connected to your OpenText Functional Testing 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, which is called Digital Lab Lite for Local Devices.

These programs are powered by Digital Lab and support mobile testing similarly. Working with Digital Lab 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 OpenText Functional Testing 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 OpenText Functional Testing in a remote access window.

Back to top

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 OpenText Functional Testing computer. On the OpenText Functional Testing machine, install the Digital Lab Lite for Local Devices to act as a local device connector.

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 on which the operating system is installed).

Download the Digital Lab Lite for Local Devices

Download the program from the AppDelivery Marketplace:

Make sure you download a version that is compatible with your OpenText Functional Testing version. To check version compatibility, see the Digital Lab Support Matrix.

Note: The Digital Lab Lite for Local Devices versions that are compatible with OpenText Functional Testing are the same as the specified Digital Lab versions.

Install the Digital Lab Lite for Local Devices

Install the Digital Lab Lite for Local Devices you downloaded. This program acts as a local device connector.

During the installation: 

  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 OpenText Functional Testing 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 OpenText Functional Testing to connect to your local devices, the Digital Lab Lite for Local Devices 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 > Digital Lab Lite for Local Devices.

    Alternatively, you can access the Digital Lab Lite 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 OpenText Functional Testing computer, and prepare your applications for testing.

Connect your devices

Prepare your devices for mobile testing and connect them to the OpenText Functional Testing computer using a 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 OpenText Functional Testing, is powered by Digital Lab. Therefore, it supports the same device types as Digital Lab, with similar requirements.

For details, see the following topics in the Digital Lab Help:

  • Connect devices to Digital Lab

    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 Help tell you to download the agent apps from the Digital Lab Lab console.

    For local device testing, copy the agent app (.ipa) files from this folder instead: <Digital Lab Lite for Local Devices_installdir>\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 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 AppDelivery Marketplace.

    To download the tools, select the Digital Lab 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.

To reinstall apps after an upgrade:

  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 checkbox in the Record and Run Settings to instruct Digital Lab to install the application before running it.

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

Back to top

Start OpenText Functional Testing and load Add-ins

Before working with mobile devices, clear your browser cache on the OpenText Functional Testing 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 app through Digital Lab

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

Back to top

Connect to your mobile device

To connect OpenText Functional Testing to the mobile device that you connected using a USB cable to the computer, follow the instructions in this section: Connect to Digital Lab or local mobile devices.

Back to top

Set up 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