Edit Mobile tests

This topic describes optional editing steps you can perform in the Editor or the Keyword view to modify your Mobile test.

In this topic:

Add simulated events and gestures

Manually add steps to your tests that simulate events and gestures that occur on real mobile devices, such as incoming calls, or a Swipe gesture.

For example:

Simulated incoming SMS

Device("Device").IncomingSMS "1800859645","Hello There",5,False       

Simulated incoming phone call

Device("Device").IncomingCall "180080808080",5,False     

Simulated GPS location change

Device("Device").GPSRelocate 37.500000,-120.300000,5,False        

Back to top

Add steps to open the remote access window

Keep your remote access window closed during a test to maintain performance, and use Device.OpenViewer and Device.CloseViewer steps to open and close it only as needed.

To control the remote access window during the run:

1. In the UFT One Options dialog, clear the Show application during test run option.

   For details, see Connect to Digital Lab or local mobile devices.

2. In your test, define the steps where UFT One must "see" the object in order to run.

   Before each of these steps, add a Device.OpenViewer step to open the remote access window.

   After each of these steps, add a Device.CloseViewer step to continue the run session silently.

3. Ensure that the app to open is defined in one of the following:

   • The Record and Run Settings dialog box; or

   • A preceding step. For example:

     Device("MyDevice").App("MyApp").Launch
     Device("MyDevice").OpenViewer

For more details, see the Mobile section of the UFT One Object Model Reference for GUI Testing

Back to top

Add steps to open different devices

Run each step in your test on different devices by creating unique Device test objects and then modifying your test steps accordingly.

To run steps on different devices:

Create unique Device test objects

Repeat the following steps for each device you want to include in your test.

1. Define your Record and Run Settings and record your test.

2. In the Object Repository window (Resources > Object Repository), rename the Device test object with a descriptive name, such as Device_1 or Device_2.

   Your test is automatically updated with the new Device test object name.

3. In the object repository, define the id description property and value for your Device test object.

   In the Test Object Details pane, select the Device object, and click to open the Add Properties dialog box.

   Define the id property value as the Digital Lab device ID.

   Tip: Enable more flexibility by linking the id description property value to an Environment variable or Data Table parameter.

Edit your test steps for each device

In your test, ensure that each step is configured to use the correct device and app. For example:

Device("Device_1").App("MyApp").Launch DefaultInstallBehavior, DefaultRestartBehavior
Device("Device_1").App("MyApp").MobileList("tableManFirst").Select 5,0
Device("Device_1").App("MyApp").MobileDropDown("RegularPicker").Select "Arman",0
...
...
Device("Device_2").App("AnotherApp").Launch DefaultInstallBehavior, DefaultRestartBehavior
...

Back to top

Add steps to open additional apps

If your test needs to open multiple apps in a single run session, add steps to open each app separately and bring it to the foreground.

Open multiple apps using one of the following methods:

Device("Device").Home
Device("Device").App("Launcher").MobileView("App2").Tap

Back to top

BPT: Add steps to open a browser

In addition to specifying the device and browser in your tests application areas, we recommend adding a step to open the browser on your device in any relevant components in your business process test.

Add a WebUtil.LaunchBrowser step to open the browser, and specify the relevant arguments as needed.

For example, the following step opens the Chrome browser on a Mobile device located in an AWS device farm:

WebUtil.LaunchBrowser "MOBILE_CHROME", "lT-1", "cube", "ANDROID", "5.1", "AWS"

For more details, see the LaunchBrowser Method topic in the UFT One Object Model Reference for GUI Testing.

Back to top

Avoid consecutive Browser.Navigate steps

Avoid adding a Browser.Navigate as the first step in your test, especially if the Record and Run Settings are set to open a specific browser page when starting the test.

For example, if the URL in the Record and Run Settings is set to www.bing.com, do not have the following as the first line in your script:

Browser.navigate "www.google.com"

Instead, modify the URL to www.google.com, and remove the first step in your script.

Additionally, if you have two consecutive Browser.Navigate steps, such as:

Browser.navigate "www.google.com"
Browser.navigate "www.baidu.com"

add a Wait statement between the two steps, or simply remove the first Navigate step.

Back to top

Runtime property values and mobile testing

UFT One does not have a runtime object that can be bound to the mobile test object. Therefore, any UFT action that takes values from the bounded runtime object will not have values.

For example:

Values of runtime properties are taken from the Digital Lab application details.

Back to top

Simulate authentication

Add steps to your test manually to simulate a fingerprint authentication, or facial recognition on iOS devices.

Authentication simulation is supported for test replay only.

When recording your test, do one of the following to authenticate:

• If you have access to the physical device, manually perform the fingerprint or facial recognition authentication. This authentication will not be recorded.
• If the device is not accessible, perform an alternative authentication.

Then, before playing your test, manually add a SimulateAuthentication step at the point in the test where fingerprint authentication occurs.

Use the following syntax:

For details, see SimulateAuthentication in the UFT One Object Model Reference and the Digital Lab Help.

Sample authentication simulation

The following steps show a failed authentication due to a lockout.

Back to top

Edit mobile tests using standard UFT One features

Use standard UFT One features to edit your mobile tests, such as conditional and loop statements, descriptive programming, and the Object Spy.

For more details, see:

• The Mobile section of the UFT One Object Model Reference for GUI Testing
• Use the Object Spy
• Conditional and loop statements
• Add test objects to an object repository
• Checkpoints in GUI Testing
• Output values in GUI testing

Descriptive programming

For example, manually edit object names to use descriptive programming instead of the object's name.

For more details, see Programming Tests.

Synchronize your test and verify your app response

Manually add any of the following types of steps to help your test run smoothly and verify that your app responds correctly.

Sample edited test

Dim ConfirmationExists, DirectFlight, FlightPrice 
Device("Device").App("com.flight.mobile").MobileButton("Reserve").Tap
' check confirmation
ConfirmationExists = Device("Device").App("com.flight.mobile").MobileObject("Confirm").Exist(10)
If ConfirmationExists Then
    ' verify that the flight is direct
    DirectFlight = Device("Device").App("com.flight.mobile").MobileCheckbox("Direct").GetROProperty("isChecked")
    If DirectFlight Then
        ' verify price
        FlightPrice = Device("Device").App("com.flight.mobile").MobileCheckbox("Direct").MobileLabel("Price").GetROProperty("text")
        If FlightPrice = Param_ExpectedPrice Then
            Reporter.ReportEvent micPass, "Reserve Flight", "Direct flight reserved. Price: " & FlightPrice
        Else
            Reporter.ReportEvent micFail, "Reserve Flight", "Unexpected price: " & FlightPrice
        End If
    Else
        Reporter.ReportEvent micFail, "Reserve Flight", "Flight not direct!"
    End If
Else
    Reporter.ReportEvent micFail, "Reserve Flight", "Flight not confirmed"
End If

Back to top

See also:

• Record Mobile tests
• Enhance your Android tests with uiAutomatorViewer
• Cross-platform testing
• Open a remote access window and application manually
• Work with Insight or Text test objects