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 OpenText Functional Testing Lab for Local Devices. See Set up advanced mobile testing.

Overview

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

Task	Relevant topic
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

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 Functional Testing Lab Lite.

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

Install Functional Testing Lab Lite

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 Functional Testing Lab Lite 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 Functional Testing Lab Lite

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 OpenText Functional Testing Lab Support Matrix.

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

Install the Functional Testing Lab Lite

Install the Functional Testing Lab Lite you downloaded. This program acts as a local device connector.

During the installation:

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.
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.
Run the service. To connect to your local devices, the Functional Testing Lab Lite 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 > Functional Testing Lab Lite.

Alternatively, you can access the Functional Testing Lab Lite service directly in the Task Manager's Services tab.

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.

Functional Testing Lab Lite, which connects the local devices to OpenText Functional Testing, is powered by OpenText Functional Testing Lab. Therefore, it supports the same device types as OpenText Functional Testing Lab, with similar requirements.

For details, see the following topics in the OpenText Functional Testing Lab Help:

Install the connector on a Windows machine. (See the Prepare devices section)

Connect devices

The Functional Testing Lab Lite 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 OpenText Functional Testing Lab Help tell you to download the agent apps from the OpenText Functional Testing Lab Lab console.

For local device testing, copy the agent app (.ipa) files from this folder instead: <Functional Testing Lab Lite_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 OpenText Functional Testing 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 OpenText Functional Testing Lab page whose version is the same as your Functional Testing Lab Lite. 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 Functional Testing Lab Lite

If you've upgraded Functional Testing Lab Lite, ensure that the app you are testing is compatible with the version you are using.

To reinstall apps after an upgrade:

Remove all apps that were installed on your device using the previous version.
Replace any packaged apps with apps that are packaged using the new version of the packaging tools.
Before running existing tests, select the Install checkbox in the Record and Run Settings so the application is installed before trying to run it.

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

Selecting Add-ins for mobile tests

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 Functional Testing Lab for Mobile and Web Browser app through OpenText Functional Testing Lab

If you want to create new tests, load the add-ins from the Add-in Manager when you start OpenText Functional Testing. For details, see Manage add-ins.

If you are modifying or running existing tests, the necessary add-ins are loaded when you open the tests.

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 a Functional Testing Lab or to mobile devices.

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.