Qualitia Automation Studio (QAS) supports testing of mobile applications on Android and iOS platforms only. You must follow the additional guidelines when executing a test suite or a test case on a mobile application.

This article contains the following topics:

Execution on Android Platform

You can execute a test suite or dry run a test case on a single mobile real device or emulator only.

Minimum System Requirements

Ensure that your computer or the remote computer meets the following requirements

• Appium Server 1.10 or higher.

• Microsoft Windows 8.1,10, 2012 or later.

• Ensure that your computer is connected to an Android real device or an emulator. The Android OS version must be from 4.4 to 10.

Specifying Additional Settings in the Mapped or System Execution Profile

Qualitia recommends creating a custom execution profile for executing on the Android platform and map it with your test suite. If you are dry running a test case, specify the required settings in the System Execution Profile.

To specify additional details in the mapped execution profile:

1. Do one of the following:

   1. To dry run a test case, from the Expand Menu, click Settings > Local Profile.

   2. To execute a test suite using a custom execution profile:

      1. From the Expand Menu, click Execution > Execution Profile.

      2. Do one of the following:

         • Click New to create a custom execution profile.

         • Under the Edit column, click the Edit button for the custom execution profile that you want to use.
           Note: If your suite or test case executes on a web application too, configure the required settings. For more information, refer to Configuring the System Execution Profile Settings.

2. Click Execution Configuration , and set Mobile to Android.

3. Click Mobile > Android.

4. From the Appium Options drop-down, select one of the following modes:

   1. Automatic: To allow QAS to communicate with the Appium server bundled with QAS.

   2. Custom: To allow QAS to communicate with another Appium server.
      Do one of the following:

      • To use the Appium server hosted on your computer, enter http://localhost:4723/wd/hub

      • To use the Appium server hosted on a remote computer, enter http://xyz:4723/wd/hub, where xyz denotes the IP address of the remote computer.

5. (Mandatory) Enter the UDID of the device.

6. Select a mobile browser as Chrome or Browser.

7. If your Android app is hybrid or web, select the Execute on Mobile Web checkbox.

8. (Mandatory) Enter the Device Name of the Android real device or emulator.

9. From the Automation Name drop-down list, select any one of the following automation frameworks:

   • UIAutomator2 (Recommended)

   • Appium

   • Selendroid

   • Espresso

10. If your Android app is hybrid or web, under Desired Capabilities, enter the following information:

    • platformVersion: Enter the platform version of the Android real device or emulator.

    • chromedriverExecutable: Enter the absolute local path to the chrome driver executable (if Chromium embedder provides its own web driver, it should be used instead of the original chrome driver bundled with Appium).

      Example: chromedriverExecutable=/abs/path/to/webdriver

      Alternatively, if you have chosen Appium for execution, from the Appium UI, under the Advanced Settings, enter the chrome driver path.

    • nativeWebScreenshot (Mandatory for hybrid applications): Select this check box, and set its value to True. This option ensures that during the execution when switching from native-context to web-context, the screenshots are displayed for the steps executed on web-context in the Execution Summary Report.

Execution on iOS Platform

You can execute a test suite or dry run a test case on a single iOS real device or simulator only.

Minimum System Requirements

Following are the requirements for test suite or test case execution on the iOS platform:

• Your Windows computer and the Macintosh computer must be on the same network.

• The Macintosh computer must meet the following system requirements:

  • Macintosh OS version 10.13 or higher

  • Appium Server 1.10 or higher

• The iOS real device or simulator must have iOS version 11 or higher.

• The iOS real device must be connected to the Macintosh computer through a USB.

Specifying Additional Settings in the Mapped or System Execution Profile

You must create a custom execution profile for executing on the iOS platform and map it with your test suite. If you are dry running a test case, specify the required settings in the System Execution Profile.

To specify additional details in the mapped execution profile:

1. Do one of the following:

   1. To dry run a test case, from the Expand Menu, click Settings > Local Profile.

   2. To execute a test suite using a custom execution profile:

      1. From the Expand Menu, click Execution > Execution Profile.

      2. Click Execution > Execution Profile.

      3. Do one of the following:

         • Click New to create a custom execution profile.

         • Under the Edit column, click the Edit button for the custom execution profile that you want to use.
           Note: If your suite or test case executes on a web application too, configure the required settings. For more information, refer to Configuring the System Execution Profile Settings.

2. Click Execution Configuration , and set Mobile to iOS.

3. Click the Mobile > iOS.

4. Enter the Appium Server URL in http://xyz:4723/wd/hub format, where xyz denotes the IP address of the Macintosh machine.

5. Set Execution Platform to iOS.

6. If your iOS app is hybrid or web, select the Execute on Mobile Web checkbox.
   Note: QAS currently supports only the Safari browser on iOS platforms.

7. (Mandatory) Enter the mobile device identifier where you want to execute the test cases, in UDID.
   For more information, refer to How to Identify UDID in Frequently Asked Questions (FAQs).

8. (Mandatory) Enter the Device Name of the simulator or iOS real device.

9. Set Automation Name to XCUITest.

10. Enter the Platform Version of the iOS simulator or device.

11. Enter the wait time for the object to display after the associated page opens in Native Object Sync Time, in seconds.

12. If your iOS app is hybrid or web, under Desired Capabilities, enter the following information:

    • Select includeSafariInWebviews and set to True.

    • Select webviewConnectTimeout and set to 9000 (milliseconds).
      Note: If a suite execution fails because web-view is not found, then Qualitia recommends to use these additional capabilities.