UFT Mobile wizard
The UFT Mobile wizard integrates with your testing tool, allowing you to make selections, such as devices and apps, from within your testing tool.
Open the UFT Mobile wizard
You access the wizard from your testing tool to select a device, app, and test options. You can open the wizard once and follow the sequence of steps. Alternatively, you can close the wizard after making one selection, for example a device, and reopen it to select the next item.

UFT |
Click the UFT Mobile icon in UFT's Record and Run Settings dialog box > Mobile tab. Before selecting a device, make sure you define the UFT Mobile settings as described in Set up for mobile testing in the UFT One Help Center. |
TruClient |
Click the Mobile configuration wizard icon |
Sprinter |
Click on the Select App or Select Browser button in the Add Application dialog box. For details, see the Sprinter Help Center. |
ALM |
Before opening the UFT Mobile wizard, you must first enable the integration in ALM. To enable the integration:
To open the wizard from ALM:
For additional details about enabling the extension, see Integrating ALM with UFT Mobile. |
Test native or hybrid mobile applications
This section describes how to use the wizard for testing native or hybrid apps. If you are testing a mobile web app through a browser, see Test web applications.
To set up a test for a native or hybrid mobile application:
- Open the UFT Mobile wizard from your testing tool and select a device. The wizard displays the active workspace name in the top right corner.
Select a device by its capabilities
If you do not need to test a specific device, you can create a rule that finds devices that meet your criteria. For example, if you need to test Android version 4.2 and higher, you create a rule that only requires 4.2 and higher. UFT Mobile will only show the relevant devices. During record or replay, UFT Mobile checks for an available device that matches the criteria, upon which to run the app.
To create a rule, select Choose Capabilities in the left panel. Then specify your criteria.
To automatically fill in your rule with the capabilities of a specific device, click the Auto-fill capabilities button
(located to the right of the More information button
) in the device's row.
You can use a wildcard (*) to specify an OS subversion, when using the "Equals" enumerator, for example 8.*Tip: To find a device by its exact model and manufacturer, wrap the string in double quotes. For example:
- "Apple iPhone 6s plus" only finds the iPhone 6s plus.
- "Apple iPhone 6s" finds iPhone 6s devices.
- iPhone 6s (without quotes) finds all devices with the string iPhone 6s in their model name.
Select a target lab. The built-in option is UFT MobileLab, listing the devices connected to the on-premises server. If you configured your system to allow access to the ADF (Amazon Device Farm) or the UFT Mobile hosted device lab, those options will also be present. When you choose multiple targets, UFT Mobile attempts to find a device on the UFT Mobile machine before accessing devices from the other labs.
If you are utilizing Service Virtualization, you will also be able to show only those devices enabled for SV. For details, see Set up Service Virtualization (on-premises).
Select a specific device
If you want to run your test on a specific device, select Choose Specific Device in the left panel to filter the devices and find the one you need. You can also filter the devices by workspace. To search for your device by its name, use the Device Search
button. For details, see View and manage devices.
-
Next, click the APPS tab. The wizard opens to the APPLICATIONS page.
Select one or more apps, or add a new one using Upload application. The wizard automatically filters the apps based on the operating system of the device that you selected in the previous step. This is noted by a gray indicator in the filter pane. If you change the filter and show apps that do not match the OS of your device, the indicator will be red. You can also filter the apps by workspace. For details, see View, upload, and manage apps.
Note that:
- Certain environments may require you to use the packaged version of an app.
- Full Device Automation functionality such as cross-app recording and recording of system apps, is not supported in packaged apps. For details, see App packaging and signing services.
-
Click the TEST OPTIONS tab. Select the appropriate options for your test. For details about the options, see Test Options below.
- Click SAVE AND CLOSE to save your changes and close the UFT Mobile window.
Click the More information button in a device's row to create a reservation or see device information. For details, see Device management.
Test web applications
This section describes how to use the wizard for testing mobile web applications using the UFTM Browser app, the Chrome emulator, or the Chrome or Safari native mobile browsers. If you are testing a native or hybrid app, see Test native or hybrid mobile applications.
To set up a mobile web test:
-
For Android testing, make sure that Chrome is installed and designated as the default browser.
- Open the UFT Mobile wizard from your testing tool. The wizard displays the active workspace name in the top right corner. Select a device:
Select a device by its capabilities
If you do not need to test a specific device, you can create a rule that finds devices that meet your criteria. For example, if you need to test Android version 4.4 and higher, you create a rule that only requires 4.4 and higher. UFT Mobile will only show the devices that match the criteria. During record or replay, UFT Mobile checks for an available device that matches the criteria, upon which to run the browser.
To create a rule, select Choose Capabilities in the left panel. Then specify your criteria.
To automatically fill in your rule with the capabilities of a specific device, click the Auto-fill capabilities button
(located to the right of the More information button
) in the device's row.
You can use a wildcard (*) to specify an OS subversion, when using the "Equals" enumerator, for example 8.*Tip: To find a device by its exact model and manufacturer, wrap the string in double quotes. For example:
- "Apple iPhone 6s plus" only finds the iPhone 6s plus.
- "Apple iPhone 6s" finds iPhone 6s devices.
- iPhone 6s (without quotes) finds all devices with the string iPhone 6s in their model name.
Select a specific device
If you want to run your test on a specific device, select Choose Specific Device in the left panel to filter the devices and find the one you need. You can also search for your device by its name by clicking the Device Search
button. For details, see View and manage devices.
-
Click the BROWSER tab. Select a browser through which to run Web pages in your test.
-
Click the TEST OPTIONS tab. Select the appropriate options for your test. For details, see Test Options below.
Tip: For UFT, you can also set the test options directly from the Web tab in the Record and Run Settings dialog box.
- Click SAVE AND CLOSE to save your changes and close the UFT Mobile window.
Click the More information button in a device's row to create a reservation or see device information. For details, see Device management.
Test Options
In the Test Options page of the wizard, you can configure the following settings:
Launch on start
In this section (not relevant when testing web applications), you indicate what app the device should open when your test begins.
Home Screen | No actual app, just the device's Home screen. |
UFT Mobile app | One of the apps that you selected in the previous step through the Apps tab. |
System app | Apps that are standard for the operating systems, such as Browser, Settings, SMS, Phone, Camera, Mail, or Calendar. |
Installed apps
This section indicates what to do with apps that were installed on the device during the test, specified in the Apps tab.
Install |
Installs all selected apps at the beginning of each record and replay session. If you know that the apps are installed on the device, you do not need to enable this option (required for AWS Device Farm devices). |
Restart | Restarts the apps at the beginning of the record or replay session. |
Uninstall | Deletes the apps after the record or replay session. |
Device Metrics
Metrics assist in detecting and analyzing issues with the application under test. Indicate which device-related metrics to save during the test run. Only selected metrics will be included in the device control panel window, and in the testing tool’s reports:
CPU | CPU usage during the test run. |
Memory | The amount of memory used during the test run. |
Free Memory | The amount of free memory on the device, during the test run. |
Log | Creates a log of the run information. |
WiFi State* | Enables both WiFi state (connected or disconnected) and signal strength (scale of 1-5). |
Disk space* | Includes space in use, and total space available. |
Thermal state* |
Supported only on iOS version 11 and above.Thermal states are classified as Nominal, Fair, Serious, or Critical. For more details on the four thermal states, see the Apple Developer documentation. |
* Available only when using UFT One 15.0.2 and later.
Network Virtualization
In this section you indicate whether or not to use NV (Network Virtualization) during the test.
Note: This feature is license dependent and will only be displayed if covered by your license.
NV integration must also be enabled by the administrator for this option to be available. For details, see Network Virtualization integration (on-premises).
See also: