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.

In this topic:

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.

Back to top

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:

1. 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.
   1. 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).

   2. 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.

Click the More information button in a device's row to create a reservation or see device information. For details, see Device management.

2. 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.

3. Click the TEST OPTIONS tab. Select the appropriate options for your test. For details about the options, see Test Options below.

4. Click SAVE AND CLOSE to save your changes and close the UFT Mobile window.

Back to top

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:

1. For Android testing, make sure that Chrome is installed and designated as the default browser.
   

2. Open the UFT Mobile wizard from your testing tool. The wizard displays the active workspace name in the top right corner. Select a device:
   1. 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.
   2. 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 More information button in a device's row to create a reservation or see device information. For details, see Device management.

3. Click the BROWSER tab. Select a browser through which to run Web pages in your test.
   

4. 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.

5. Click SAVE AND CLOSE to save your changes and close the UFT Mobile window.

Back to top

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 to use NV (Network Virtualization) during the test.

NV integration must also be enabled by the administrator for this option to be available. For details, see Network Virtualization integration (on-premises).

Back to top

See also:

• Define Mobile Record and Run Settings
• View and manage devices
• Device management
• View, upload, and manage apps
• Get started with performance testing