Readme
HPE Mobile Center
Software Version: 2.00
Publication date: 3 June 2016
Software release: 3 June 2016
Mobile Center 2.00 can be installed as a full installation where there is no previous installation of Mobile Center, or as an upgrade on top of an existing installation of Mobile Center 1.52 or Mobile Center 1.52 Patch 1.
This Readme contains up-to-date information on Mobile Center 2.00 limitations.
Read more about the new features in Mobile Center 2.00, and how to use them, in the Mobile Center Help. For system requirements, supported devices and HPE tools that integrate with Mobile Center 2.00, see My Product Matrix.
This section contains limitations in the following areas:
Mobile Center general limitations
AWS server and Amazon Device Farm
Mobile Center server does not support non-English OS servers.
In Windows 8.1, if you are using Internet Explorer version 11.0.23 as a non-admin user:
These limitations result from Internet Explorer not allowing localStorage access. These limitations do not apply if you launch the browser as an administrator.
The maximum file size that you can upload is 200 MB.
Device Group Management
For administrators managing device groups and users through the Administration tab:
General
When connecting to Mobile Center over a proxy, it must allow WebSockets traffic in order to record in UFT.
Recording of the Left and Right arrow keys within apps is not supported. The recorded Up and Down arrow keys are translated into a scroll during replay. In addition, when working with the HP Mobile Web browser, none of the arrows are recorded.
Android:
iOS:
Replay will fail for a test using the HPE Mobile Web app if you manually opened it on the device before the test. Close the Mobile Web app before running your test.
Packaged apps
Non-packaged apps
Android:
Date pickers may return additional information in the value string, causing the step to fail on replay. Workaround: Manually modify the strings to remove the additional information. For example, a value may be recorded as "Afternoon, 3 of 4". The suffix ", 3 of 4" that was added to the actual value "Afternoon" should be removed from the value string.
iOS:
When viewing the Mobile Center console located on an AWS machine, you may experience a delay in the refreshing of the data.
When trying to execute a new test after leaving UFT open for an extended period of time, the system attempts indefinitely to allocate a device. Workaround: Close the test and reopen it.
When a UFT test on an iOS device fails to run, the screenshot from the previous run is displayed.
The following functionality is not supported:
The screen capture included in the run results for each step run on a device’s native browser is not correct.
The following test object methods are not supported:
The following limitations apply when using testing tools with Mobile Center and Windows Phone.
Spying from UFT may fail due to timeout. To prevent this, increase the Spy timeout in the Windows registry key on the UFT machine HKCU\Software\Mercury Interactive\QuickTest Professional\MicTest\Packages\MobilePackage\Settings\SpyMsgTimeout
.
Workaround: The default timeout in UFT 12.53 is 6 seconds. Increase it to 30 - 60 seconds and restart UFT.
Android
iOS
When the autoDismissAlerts or AutoAcceptAlerts capability is set to true, the system dialogs dismiss/accept policy is not enforced when the alert is displayed immediately after launching the app.
The following are additional limitations when using Unified Functional Testing (UFT) with Mobile Center.
Running UFT tests with Mobile Center
Device locking during test runs
When you run a test or component on a mobile device, the device remains locked by Mobile Center until the test or component is closed. This is true even if the test or component is no longer running.
Unexpected issues may occur when you are running a test with a MobileWebView test object on multiple devices.
If so, remove the accessibilityid description property from the test object and run the test again.
Device filtering in test runs: Testing multiple devices
If you have multiple steps in your test that use the same device filtering criteria defined by description properties, and also have multiple devices connected to Mobile Center that match the filtering criteria, all relevant steps use the same device used by the first step in your test.
To use a different device in a specific step, modify the filter for that step.
Device filtering in test runs: Modifying your filter
If your device filter is defined by description properties, and you modify those properties before running the test a second time, the device remains locked from the first run, and the second test run will fail.
Unlock the device in Mobile Center before running the test a second time.
Device filtering in test runs: Multiple steps with different device filters
If your test has separate steps with different device filters for each step, where the device filters do not conflict (the same device matches each filter), and:
To use the same device, modify the filter so that the properties match in all relevant steps.
For example, if you have a single device connected that matches the filters in both of the following steps, the test will fail on the second step.
Device("osversion:=8.4","ostype:=iOS").App("name:=HP Mobile Web","identifier:=com.hp.HPMobileWebBrowserINJ").MobileEdit("nativeclass:=UITextField","mcindex:=0","ispassword:=False","class:=Input","accessibilityid:=url").Set "AAA"
Device("ostype:=iOS").App("name:=HP Mobile Web","identifier:=com.hp.HPMobileWebBrowserINJ").MobileEdit("nativeclass:=UITextField","mcindex:=0","ispassword:=False","class:=Input","accessibilityid:=url").Set "BBB"
Modify the steps as follows to run the test:
Device("ostype:=iOS").App("name:=HP Mobile Web","identifier:=com.hp.HPMobileWebBrowserINJ").MobileEdit("nativeclass:=UITextField","mcindex:=0","ispassword:=False","class:=Input","accessibilityid:=url").Set "AAA"
Device("ostype:=iOS").App("name:=HP Mobile Web","identifier:=com.hp.HPMobileWebBrowserINJ").MobileEdit("nativeclass:=UITextField","mcindex:=0","ispassword:=False","class:=Input","accessibilityid:=url").Set "BBB"
Disabled remote access window during a test run
When the remote access window is disabled, the Browser.Page.WebObject.CaptureBitmap method is not supported.
In such cases, use Browser.CaptureBitmap instead.
Device information is not included in the HTML run results for Browser steps run on specific devices.
Backwards compatibility during a test run
If your tests were recorded in a 1.5x version of Mobile Center using the Mobile Web app, and include steps that use the Device test object, do the following before replaying your tests:
Automatically starting apps during a test run
If your test steps have your apps restarting, some subsequent steps may fail.
For example, in the following steps, the application is started in step 3, and then automatically restarted in step 4.
#1 Device("Device").App("UICatalog_NI_2").MobileList("tableMAinFirst").Select 0,0
#2 Device("Device").Home
#3 Device("Device").App("Home").MobileButton("UiTestingAppNI").Tap
#4 Device("Device").App("UiTestingAppNI").MobileToggle("al_switch").Set "off"
In this example, you can do one of the following:
Remove step 3
Add the following step before step 4, to prevent your app from restarting:
Device("Device").App("UiTestingAppNI").Launch DoNotInstall,DoNotRestart
Spying and highlighting with Mobile Center
UFT may not highlight a test object in the object repository in the following scenarios:
Scenario | Workaround |
---|---|
This is the first editing session after installing UFT. | Define the relevant device and application in the Mobile tab of the Record and Run Settings dialog box. Then start and stop a recording session. |
This is the first editing session after restoring factory defaults in the Options dialog box. | Define the relevant device and application in the Mobile tab of the Record and Run Settings dialog box. Then start and stop a recording session. |
The Mobile tab of the Record and Run Settings dialog box is empty, and no device or application is selected. | Define the relevant device and application in the Mobile tab of the Record and Run Settings dialog box. Then start and stop a recording session. |
The remote access window displays a different device than the one defined in the Mobile tab of the Record and Run Settings dialog box. |
Do one of the following:
|
UFT text recognition and Mobile Center
Text recognition in UFT for devices does not support the Tesseract OCR text recognition engine.
UFT regular expressions and Mobile Center
Regular expressions are not supported for the class property in ChildObject methods when testing native apps.
Business Process Testing and Mobile Center
The MobileView object is not recorded.
Instead, you can create it manually in the object repository and do the following:
Device.SetOrientation method | Orientation is not supported when testing non-packaged apps on iOS devices. |
Mobile Stepper test objects |
The Mobile Stepper test object is not supported for non-packaged apps on iOS devices. On Android devices, these objects are recognized as MobileButton or MobileLabel objects. |
MobileList.Delete method |
The MobileList.Delete method is not supported for non-packaged apps. Instead, swipe left on the list item and tap the Delete button to perform this step. |
MobileDropdown.Select method | Replay is not supported for the MobileDropdown.Select method on non-packaged apps. |
ChildObjects method |
Only the following ChildObjects method properties are supported when testing non-packaged devices on iOS devices:
|
Required object description filter | When testing non-packaged apps using the ChildObjects method, you must add a filter to the object description before the ChildObjects step. For example, see Object description filter - example. |
Descriptive programming | Descriptive programming is not supported for non-packaged apps. |
Object description filter - example
Set oDesc = Description.Create()
oDesc("class").Value = "Button"
Set Buttons = Device("Device").App("UICatalog_2").ChildObjects(oDesc)
NumberOfButtons = Labels.Count()
For i = 0 To NumberOfButtons - 1
Buttons(i).Tap
Next
Testing SAP Fiori apps with Mobile Center
If your test was created for a desktop version of a Fiori application, you may need to modify the test to ensure it runs correctly on the mobile version.
Additionally, different resolutions on different devices may cause differences in an object's properties and behavior. You may need to manually edit the test script to support multiple devices.
Tip: Add an Exist statement to ensure that an object is completely loaded on a page in a Fiori mobile application before running steps on that object.
Specific SAP objects and methods
SAPUIRadioGroup |
The SAPUIRadioGroup test object is not supported for Fiori applications. |
SAPUITextEdit / SAPUIButton |
Sometimes, when using SAPUITextEdit and SAPUIButton objects, the test steps are recorded in the incorrect order. If this happens, change the order of the steps manually. |
SAPUITextEdit |
The SAPUITextEdit test object html tag identification property now uses the parent DIV element (instead of the INPUT element). You must update any:
|
SAPUIDialog.Close |
The SAPUIDialog.Close button works only when a dialog contains a X close button. |
Standard checkpoints and output values in SAP Fiori apps
When inserting standard checkpoints and output values to an already recorded test, and running standard checkpoint and output value steps on Fiori mobile applications, the test object must be fully visible in the Mobile Center remote access window.
This is relevant when editing the test, and not when recording it.
Fiori 1.6x client freezes
Using the HP Mobile Web browser app with UFT
Using the Chrome emulator with UFT
Multiple tabs |
Multiple tabs are not supported, as well as the Browser.OpenNewTab and Browser.CloseAllTabs methods. Unsupported methods may cause unexpected behavior when run in the emulator. |
Object Spy |
The Object Spy and Highlight in Application (from the Object Spy) are not supported for the emulator. Test objects added while recording using the emulator cannot later be highlighted from the object repository. |
Checkpoints and output values |
Checkpoints and output values cannot be added during recording and must be added manually when editing test steps. |
Maintenance mode |
Maintenance mode is not supported. |
Test objects |
The WebFile object is not supported. |
The following functionality is not supported for testing on native browsers:
Iteration testing in emulators.
Testing Fiori clients
Testing on Linux servers
UFT Spy and Highlight
The following test object methods:
Running tests on native browsers
If a desktop browser is opened on your UFT machine while running a test on a native browser on a real device, the test will fail.
Close the desktop browser before running your test.
Native browsers, including Chrome on Android and Safari on iOS, do not relate to test object description properties.
Therefore, data driving on native browsers relates to data defined in the Data table or test parameters only, and will not search for test objects with matching test object property values.
If you stop a test run in a native browser, and the WebDriverhost is still running, manually kill the WebDriverhost process, or add the following code to the beginning of the next step in the test:
SystemUtil.CloseProcessByName ("WebDriverHost.exe")
Checkpoints when testing native browsers
Text area checkpoints and bitmap checkpoints are not supported for Safari on iOS devices.
Windows Server 2012 R2 and native browsers
Native browsers are not supported when running UFT on Windows Server 2012 R2.
The following features are not supported when testing hybrid applications:
Mobile optimization.
The following are supported only for web pages that are optimized for mobile:
Certain hybrid apps may issue an error "This test was created using an earlier version of UFT and therefore requires a different Javascript engine". This can happen if the app is launched by another app. Workaround: Stop the recording, restart the app, but do not reinstall. Begin recording again. Alternatively you can use this Javascript code:
Device("<Device>").App("<appname>").Launch DoNotInstall,Restart
Note: Some features not supported for mobile in general are supported when working with hybrid applications. For details, see Unsupported features, test objects, and methods.
Additional limitations:
Keyword View |
In the Keyword View, you may not be able to use the Insert run-time object option in the Select Test Object dialog box to insert a Workaround: Enter the |
Text checkpoint and output value steps |
When recording and running text checkpoint and output value steps, the test object must be fully visible in the remote access window. |
Object identification properties |
Do not add or remove object identification properties, as customization is not supported. |
WebList steps |
Sometimes, when recording a WebList test object step, steps are added for both MobileDropDown and WebList test objects. This may cause the MobileDropDown step to fail. To avoid this, delete the extra MobileDropDown step. |
Recording date and time |
Sometimes, when recording the date and time on MobileWeb test objects, native application steps are added in addition to hybrid application steps. This may cause the step to fail during a run session. Workaround: Delete the extra native application steps. |
Run results |
CSS elements may be displayed erroneously in the Captured Data pane of the Run Results Viewer (not relevant for HTML report). |
Working with ALM and Mobile Center
Asset Comparison tool |
The Asset Comparison tool does not compare changes in the Record and Run Settings for Mobile tests. |
Test object icons |
Test object icons for Mobile objects are not displayed in the Test Plan module or for object repositories saved in ALM. |
Apache configuration example:
###forward basic authentication### ProxyRequests on AllowCONNECT 8108 8080 80 7002 443 8443
Commas as decimal points |
Your localized operating system may use commas as decimal points. This is not supported by UFT, and you may need to manually fix recorded steps to use periods as decimal points instead. It is recommended to always use the period character as a decimal point, regardless of the locale of your operating system. |
Simulating events |
Simulating events, such as an incoming phone call or SMS, is not supported. |
Suggested characters |
Steps that include Japanese/Chinese characters that were added from the suggested characters line above the keyboard may not run correctly. |
Tests created in earlier versions of UFT
Tests created prior to UFT 12.51
For tests that were created on hybrid applications prior to UFT 12.51, only the text, isEnabled, and isFocused properties are supported for checkpoints and output values.
Additionally, you must do the following to enable your test or component to run properly:
Select the Test was created prior to UFT 12.51... check box before running the test.
For tests |
Select the File > Test Settings > Mobile Hybrid tab. Select the Test was created prior to UFT 12.51 and contains steps on a hybrid mobile app check box. |
For components |
Open the application area, and in the sidebar, select Additional Settings > Mobile Hybrid. In the Mobile pane, select the Test was created prior to UFT 12.51 and contains steps on a hybrid mobile app check box. |
Make sure that UFT re-installs or restarts the app before running steps on the app.
You can:
App.Launch
method.
For details, see the Mobile section of the Object Model Reference in the UFT Help Center.
Tests created in UFT 12.02 Patch 1 or earlier
When working with an object repository in a test created in UFT 12.02 Patch 1 or earlier, the following commands are not supported:
Instead, update the test object descriptions from the application (select the test object and click Update from Application).
Caution: If you are working with MobileLabel test objects that are part of a MobileList test object, updating the description from the application can cause your test to behave unexpectedly.
To update the description of a MobileLabel test object from the application, replace it with a MobileList test object.
In the relevant test steps, replace the steps containing MobileLabel.MakeVisible and MobileLabel.Tap with a single step containing MobileList.Select <index>.
For example, replace:
Device("Device").App("UICatalog").MobileLabel("ListViewActivity").MakeVisible
Device("Device").App("UICatalog").MobileLabel("ListViewActivity").Tap
with:
Device("Device").App("UICatalog").MobileList("list").Select 5
Unsupported features, test objects, and methods
The UFT Mobile Add-in supports only recording and running steps on mobile applications.
The following UFT abilities are not supported, or are only partially supported, when working with mobile objects:
The following core features are not supported by LeanFT:
• Testing Amazon device farm devices
• Testing native browsers
Windows phone is supported for LeanFT at tech support level only.
The following are additional limitations when using TruClient with Mobile Center:
Legal Notices
The only warranties for Hewlett Packard Enterprise Development LP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HPE shall not be liable for technical or editorial errors or omissions contained herein.
The information contained herein is subject to change without notice.
Confidential computer software. Valid license from HPE required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.
© Copyright 2016Hewlett Packard Enterprise Development LP
Adobe® is a trademark of Adobe Systems Incorporated.
Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation.
UNIX® is a registered trademark of The Open Group.
Red Hat® is a registered trademark of Red Hat, Inc. in the United States and other countries.
Apple and the Apple logo are trademarks of Apple Computer, Inc., registered in the U.S. and other countries.
iPad® is a trademark of Apple Inc.
iPhone® is a trademark of Apple Inc.
Google™ © 2012 Google Inc. All rights reserved. Google and the Google Logo are registered trademarks of Google Inc.