Start the Mobile Scan and connect

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

  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 device section, you can filter and select which mobile device, emulator, or simulator you want to scan.

    The Mobile Scan automatically displays the following types of devices:

    • Locally connected Android devices. Their tiles are marked with a USB connection icon.

    • Android emulators.

    If you have added a cloud connection, select the check box Load cloud devices to retrieve all available cloud devices. For detailed information, see chapter "Load and filter devices in Perfecto and Sauce Labs".

  3. Optionally, add other devices, emulators, or simulators. For information on how to do so, see chapter "Add a mobile device, emulator, or simulator".

  4. In the Select application section, select which mobile application you want to scan.

    The Mobile Scan automatically displays all applications on the selected device. Their tiles are marked with an Installed app icon. To see the full name of an application, hover over the application name. For more information on displaying applications automatically, see chapter "Automatically display mobile applications". If you select an installed application and connect to the device, this application is automatically added to mobile configurations.

    You can filter the applications by name. To do so, use the Search Apps... search box.

    You can manually add other applications. For information on how to do so, see chapter "Add a mobile application".

The Mobile Scan window with automatically displayed devices and applications

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

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

  3. Optionally, click Advanced configuration to apply Desired Capabilities to the scan.

  4. Click Connect.

  5. 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 Web.

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

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

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.

Automatically display mobile applications

When you click on a device in the Mobile Scan, the mobile applications installed on it are displayed automatically. To use this function, you must fulfill the following prerequisites:

  • Your device and your computer with Tricentis Tosca must be in the same local network.

  • Your mobile device must be unlocked.

  • If your application doesn't have a launchable Activity, you must add this application in the Mobile Scan.

  • If you install a new application manually when the Mobile Scan is already open, you must restart the Mobile Scan to display the new application automatically.

Enable or disable the control visibility check

By default, Mobile Engine 3.0 checks controls visibility for local test automation and it skips the visibility check for test automation in the supported clouds.

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 the clouds that are not supported.

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.