Working with emulators
Emulators let you install and replay tests on emulated devices. UFT Mobile lets you test your devices using some of the popular emulators.
The supported emulators are Genymotion and Android SDK.
If you are using UFT, you can also record and run Web tests using the Chrome emulator. For details, see Define settings for testing Web applications using the Chrome emulator.
This section describes how to set up AVD (Android Virtual Device) emulators on a Windows server or connector machine.
To create and launch an AVD emulator:
- Make sure your machine meets the requirements for Android Studio. For details, see Requirements and recommendations.
- Download Android Studio from the Android Studio download page.
- Run the setup, and include the Android Virtual Device (AVD) component. This component allows you to create a profile of a virtual device that can then be run on the Windows host and connected to the UFT Mobile server via a device connector.
- In the Android Studio welcome screen, select Configure > AVD Manager to open the AVD Manager.
In the AVD manager, create a virtual device or choose a predefined device.
To run an emulator that uses an AVD, double-click it or click Launch.
- When the device is running, make sure to enable USB Debugging. Trust the host when prompted to do so. These guidelines are similar to those required for physical devices.
- Once the emulated device starts, it should appear in the mobile lab as an available test device. If it does not, stop the device by closing its window. Restart the connector. After the connector has started, restart the device emulation. Make sure that the filter is not hiding emulated devices.
The support for an emulator on Linux is via the command line.
- Download the Android SDK Manager for Linux from the Android Studio site. Scroll down to the Command line tools only section, and download the archive file, sdk-tools-linux.xxx.zip.
- Extract the contents of the zip file.
- Under the tools/bin folder, locate the sdkmanager tool.
sdkmanager --update [options]to update all installed packages. We also recommend to run
sdkmanager --"platform-tools" "platforms;android-28"to install the latest platform tools, including adb. For details, see the command line documentation.
Under the tools/bin folder, locate the avdmanager tool. The AVD manager allows you to create a profile of a virtual device that can then be run on the Linux host and be accessed via the device connector. Run the line command to create a new profile for the device you want to emulate, for example,
avdmanager create avd -n test -k "system-images;android-25;google_apis;x86". For details, see the command line documentation.
The device should now appear in the list of existing virtual devices. For details, see View and manage devices.
Create a test with an emulator
To prepare a test through an emulator:
- Install your emulator. Prepare your environment as described by your emulator's documentation.
When using Genymotion, configure the adb using the same settings as you used when installing the connector. In Genymotion, select Settings > ADB tab > Use custom Android SDK tools.
- If you have an ANDROID_HOME environment variable, use the same adb path as you used when setting up the connector for Use custom Android SDK tools in Genymotion.
- If you do not have an ANDROID_HOME environmental variable, the connector will use the embedded adb tools. Set the Use custom Android SDK tools to <UFT Mobile Connector>\connector\android-sdk-windows.
- Start the emulator. Choose the device to emulate.
Select an emulated device within your testing tool
(UFT, Sprinter, or TruClient)in the Device selection area.
Perform actions on the app on the emulated device.
The default installation of the connector does not include the SDK emulator tools. If you would like to install the emulator on your Connector machine, perform the following steps:
- Download the Android SDK Tools package from the Android SDK website. We recommend SDK version 25.2.2.
- Extract the contents of the zip file to a folder named tools. Copy the newly created tools folder to the android-sdk-windows/ android-sdk-linux subfolder of the connector's installation folder.
- Open the tools folder and double-click android.bat or the Linux shell command.
If you are accessing the SDK manager through a proxy server, enter the proxy information:
- Select Tools > Options to open the Settings dialog box.
- Enter the HTTP Proxy Server and Proxy Port values.
- Click Close.
In the Android SDK Manager window, choose the emulator images to install under the Tools node. Note that each Android version has its own image.
Tip: Use Intel x86 base images for better performance on machines that support Intel HAXM (Hardware Accelerated Execution Manager).
- Expand the Extras node and select Intel x86 Emulator Accelerator (HAXM installer).
- Click Install <x> Packages.
- Continue with opening the AVD to select devices, as described in Setting up an Android Emulator - Windows.
When you integrate with on-premises Genymotion emulator, UFT Mobile shows the devices in the lab.
The following are the prerequisites for integration with Genymotion Desktop emulated devices:
- A valid Genymotion desktop license
- A Genymotion desktop installation on a Windows machine with UFT Mobile server
- An environment that supports the Genymotion gmsaas tool.
To set up the Genymotion desktop integration:
- Make sure you have installed the Genymotion client on the UFT Mobile server. Only a Genymotion Windows client is supported. Sign in with your Genymotion credentials and register your license. For details, see the Help menu on the Genymotion site.
Configure Genymotion to use the UFT Mobile ADB folder:
- In the Genymotion client settings, click the ADB tab and select Use custom Android SDK tools.
- Click Browse and locate the android-sdk-windows folder. The default folder is C:\Program Files\UFT Mobile Server\server\android-sdk-windows.
- Make sure that the dialog box indicates Android SDK tools found successfully.
- In Genymotion Desktop, start one or more virtual devices.
- Open the Device Lab tab to view the Genymotion virtual devices. (This may take several minutes.) For details, see Working with Genymotion Cloud emulators.
The UFT Mobile Genymotion cloud integration allows you to access emulated Android devices on the Genymotion cloud.
When you integrate with Genymotion cloud, UFT Mobile shows two virtual emulator devices, representing two common Genymotion templates.
Note that this integation is currently supported only with a Windows connector. You can use the connector embedded in the UFT Mobile server, or a standalone connector.
Tip: You can add other Genymotion templates using the REST API.
The following are the prerequisites for integration with Genymotion Cloud emulated devices:
- A Genymotion Cloud trial or paid license
- Make sure that there is no gmadbtunneld running on the connector through which UFT Mobile will communicate with Genymotion Cloud.
Note: This integration is only available with a UFT Mobile Professional, Trial, Enterprise, or Ultimate license. For more details, see UFT Mobile editions.
To set up the Genymotion cloud integration:
Open the Genymotion Integration page in the Administration Settings.
- Provide the Genymotion Cloud username and password.
- Select the connector through which UFT Mobile will communicate with Genymotion Cloud, and provide proxy details if required.
Tip: If you configured a proxy in the Genymotion integration Administration settings, make sure that the system proxy settings are configured on the matched Windows connector machine. For more details about using a proxy server, see the Genymotion gmsaas documentation.
Provide the Genymotion gmsaas install path on the connector or accept the default:
- Windows when using the connector on the server machine: <uftm installation>\server\gmHome\gmsaas, by default C:\Program Files\UFT Mobile Server\server\gmHome\gmsaas.
- Windows when using a standalone connector (not on the server machine): <uftm installation>\connector\gmHome\gmsaas, by default C:\Program Files\UFT Mobile Connector\connector\gmHome\gmsaas.
- Click Verify and Save. If you disable the integration or change the account settings, the virtual devices associated with the previous account will no longer be available.
Open the Device Lab tab to view the Genymotion virtual devices. For details, see Working with Genymotion Cloud emulators. To remove the emulated devices, disable the integration in the Administration Settings.
Slow network issues
If you are having difficulties connecting to the devices due to network issues, you can increase the timeout value.
- Open the connector.properties file in the <UFTM_Installation_folder>\< server|connector>\conf folder.
- Search for common.config.appInstallTimeoutSecond. If it is missing, add it.
- Increase its value. The default is 60 seconds.
- When using the Android SDK emulator, it is recommended to use HAXM instead of the ARM configuration. Make sure the Intel x86 Emulator Accelerator (HAXM installer) is installed in the Android SDK Manager. Then, run the setup located in <android-sdk folder>\Extras\Intel\Hardware_Accelerated_Execution_Manager\intelhaxm-android.exe.
- The Restart button in UFT Mobile is disabled for Android SDK emulator devices.
Certain apps cannot be installed on the SDK emulator with an ARM configuration. As a workaround:
In most instances, it is recommended to work with Android SDK with HAXM.
In the following instances use the ARM configuration:
For recording, close the remote device window and record on the device.
For replay, record on Genymotion or Android SDK x86 with HAXM, and replay in silent mode in UFT.
Start the emulator in headless mode.
Reduce the resolution of the device.
Emulator support is provided for Android 4.1 and higher, and an API level of 19 or higher. For more information, see Device emulators.
The following guidelines apply:
- When using an emulator for devices with Android 6.0 and higher, SMS and Call simulations are not supported.
- In RHEL (Red Hat Enterprise Linux) 6.5 environments, you cannot work with the remote screen viewer on emulators, since this version of RHEL does not support GPU acceleration. (GPU acceleration is available on Windows machines, or Linux machines with RHEL 7 and higher.)
- Emulation is not supported for apps that have full control of the adb, such as Wandoujia.
Windows: If you experience issues and the GenyMotion Cloud virtual device is not connecting, perform the following steps on the selected connector:
- Configure the UFT Mobile service to run as the same user used in the Genymotion setup. For details, see Run the services as a different user.
- If you changed the user for the UFT Mobile service, copy the contents of the C:\Windows\SysWOW64\config\systemprofile\AppData\Local to the selected user's AppData folder, for example