Start the Mobile Scan and connect

To start the Mobile Scan and connect to a mobile device, emulator, or simulator, follow these steps:

  1. Right-click a Module folder and select Scan > Mobile from the context menu.

    Alternatively, open the Mobile Scan via the dynamic menu Modules. To do so, click the  Scan icon and select Mobile from the drop-down menu.

  2. In the Select connection section, add a new connection or select the connection you want to use, such as Local (TMA), Remote (TMA), Cloud (Appium), TDC, or Virtual Mobile Grid (early access feature).

    To filter the connections by name, use the Search Connections... search box.

    Alternatively, you can use the keyboard shortcuts to navigate and select options in the Mobile Scan window.

  3. In the Select device section, add a mobile device, emulator, or simulator or select the one you want to scan.

    Based on the connection type, the Mobile Scan automatically displays the following connected devices:

    • Locally connected Android or iOS devices, or emulators for Local (TMA).

    • Android or iOS devices, emulators, or simulators for Remote (TMA).

    • Cloud Android or iOS devices for TDC.

    To filter the devices, use these options.

  4. In the Select application section, add a mobile application or select the mobile application you want to scan.

    If you've selected the connection type Local (TMA) or Remote (TMA), the Mobile Scan automatically displays the applications you've installed on the selected device.

    To filter the applications by name, use the Search Apps... search box.

  5. Optionally, deselect the Run Live View check box to disable the preview of the application.

  6. Optionally, select the Reset application check box to perform the following actions:

    • Reset all user settings and permissions in the application.

    • Restart the application if it has already been open.

  7. Optionally, select Set capabilities to apply Desired Capabilities to the scan.

  8. Select Connect.

  9. In the next window, select Mobile Scan.

  10. Optionally, to improve performance, you can limit the scan to only visible elements within the current viewport. To enable this performance boost, select the I only want to scan visible elements to boost performance checkbox. Note that this applies only to websites and web content in hybrid applications.

  11. The Mobile Scan opens the application or website on the mobile device, emulator, or simulator.

    If you enabled Live View, the Live View pop-up window appears.

    If the Mobile Scan detects a hybrid application, you must decide which context you want to scan:

    • To scan the native context, select the radio button Native.

    • To scan the web context, select the radio button Web and choose the webview you want to scan from the combo box below it.

  12. To select controls in your mobile application, click Scan.

Keyboard shortcuts

Use keyboard shortcuts to find your way around an active Mobile Scan window more quickly and easily.

To view the list of keyboard shortcuts in Mobile Scan, select the Keyboard shortcuts icon in the top right corner of the window.

Action

Shortcut

Close active window

Esc

Navigate between controls

Tab

Navigate within a control

Arrow keys

Edit selected item

F2

Delete selected item

Del

Filter for devices, emulators, or simulators

To search for and filter devices, use one of the following options:

  • Filter devices by name. To do so, use the Search Devices... search box.

  • Filter devices by platform, operating system, or type. To do so, filter with the dropdown menus Platform, OS Version, or Type.

Delete devices or applications

If you have manually added a device or an application, you can delete it later in the Mobile Scan.

To do so, hover over the respective tile and click the Delete icon.

The Mobile Engine 3.0 also removes the device or application from mobile configurations.

Edit devices or applications

If you have manually added a device or an application, you can edit it later in the Mobile Scan.

To do so, hover over the respective tile and click the Edit icon.

The Mobile Engine 3.0 also edits the device or application in mobile configurations.

Enable or disable the control visibility check

By default, the visibility check for test automation is enabled in the Mobile Engine 3.0. You can enable or disable the visibility check depending on your mobile application and performance requirements.

Tricentis recommends disabling the visibility check if you run your tests in a cloud.

To enable or disable the visibility check only for test execution, create the TCP SkipVisibilityCheck and set its value to True or False depending on whether you want to skip the visibility check or not.

To enable or disable the visibility check for both the Mobile Scan and test execution, follow the steps below:

  1. Go to C:\ProgramData\TRICENTIS\TOSCA Testsuite\7.0.0\Settings\XML and open the file Settings.xml.

  2. Under <Category name="Mobile30">, add the following line of code before the closing tag:

    <Setting name="Automation.Mobile30.SkipVisibilityCheck" legacyPath="Automation.Mobile30.SkipVisibilityCheck">False</Setting>

  3. Set the value of this setting to True or False depending on whether you want to skip the visibility check or not.

  4. Restart Tricentis Tosca.