Running mobile tests as an AFT Suite on multiple mobile clouds

After you create an AFT Suite for mobile tests, you can run the tests simultaneously on devices connected to multiple mobile clouds to accelerate the test efforts.

Before you begin

You must have completed the following tasks:
  • Created an AFT suite with mobile tests, See Creating an AFT Suite to run the tests on multiple mobile clouds.
  • You must have set up accounts and obtained valid credentials for more than one mobile cloud as mentioned below:
    • BitBar Cloud: The host name or the URL of the BitBar Cloud instance, and an API key to authenticate the connection.
    • pCloudy Cloud: The host name or the URL of the pCloudy Cloud instance, the user name, and an API key to authenticate the connection.
    • Perfecto Cloud: The host name or the URL of the Perfecto Cloud instance, and the security token to authenticate the connection.
  • Uploaded the .ipa file of the iOS application or the .apk file of the Android application that you want to test in the mobile cloud. For more information, refer to the following:
  • Installed the Android or iOS application that you want to test on the device.
    Note: To install the application in a device on the pCloudy Cloud, refer to Installing Android app or Installing iOS app in the pCloudy documentation.
  • Connected and started the Android or iOS device that you want to use for testing the mobile applications.
  • If the test to be run on pCloudy Cloud, verified that the device you want to test is available and in the Released state on the pCloudy cloud.

About this task

To run the AFT Suite on multiple clouds, you must configure the mobile clouds with HCL OneTest UI. You need to configure only those mobile clouds, to which the devices you want to run the tests are connected.

Procedure

  1. Open the UI Test perspective in HCL OneTest UI, if it is not already open.
  2. Click Window > Preferences > Test > Test Execution > UI Test Playback.

    The UI Test Playback pane is displayed.

  3. Click the Mobile Device Cloud tab, and perform the following steps to configure the mobile clouds with HCL OneTest UI:
    You must only enter the details of mobile clouds on which you want to run the AFT Suite.
    • BitBar Cloud
      1. Select the BitBar host checkbox to enable the options on the BitBar Device Cloud Environment panel.
      2. Perform the actions as listed in the following table:

        Option

        Action

        BitBar host

        Enter the host name of the BitBar Cloud instance.

        API Key

        Enter the API key of your BitBar Cloud account to authenticate the connection, and then click the Refresh projects and device groups Image of the refresh icon..
        Note: Clicking the Refresh projects and device groups Image of the refresh icon. enables the Project and Device Group fields.

        Project

        Select the BitBar project from the drop-down list.

        Device Group

        Select the mobile device group that you want to use in the BitBar cloud.

        Test Run

        Enter an appropriate name for the test with which you can identify the test run on the BitBar Cloud dashboard.

      3. Click Apply.
        Note: When the connection with the BitBar Cloud instance is successful, the mobile devices that you have configured on the BitBar Cloud are displayed in the Run using drop-down list.
    • pCloudy Cloud
      1. Select the pCloudy host checkbox to enable the options on the pCloudy Device Cloud Environment panel.
      2. Perform the actions as listed in the following table:

        Option

        Action

        pCloudy host

        Enter the host name of the pCloudy instance.

        User Name

        Enter the user name of your pCloudy account.

        API Key

        Enter the API key of your pCloudy account to authenticate the user name for a successful connection.

      3. Click Apply.
        Note: When the connection with the pCloudy instance is successful, the mobile devices that you have configured on the pCloudy Cloud are displayed in the Run using drop-down list.
    • Perfecto Cloud
      1. Select the Perfecto host checkbox to enable the options on the Perfecto Device Cloud Environment panel.
      2. Perform the actions as listed in the following table:

        Option

        Action

        Perfecto host

        Enter the host name of the Perfecto Cloud instance.

        Security Token

        Enter the Token to authenticate the connection to the Perfecto Cloud instance.

      3. Click Apply.
        Note: When the connection with the Perfecto Cloud instance is successful, the mobile devices that you have configured on the Perfecto Cloud are displayed in the Run using drop-down list.
  4. Click Apply and Close.
  5. Select the project that contains the AFT Suite, in the Test Navigator pane.
    The AFT Suite that you created for the mobile tests is in the Accelerated Functional Tests folder.
  6. Expand the contents of the Accelerated Functional Tests folder to view the AFT XML that is displayed with the name you provided.
  7. Right-click the XML file of the AFT Suite, and then click Run Distributed Tests.
    The Run Accelerated Functional Test dialog is displayed.
    Note: If you are repeating the AFT Suite run because the previous run failed, the Re-run failed tests only from the last playback option is available for selection. When you select this option, the AFT Suite is run on the devices and location on which it previously failed.
  8. Click OK.

Results

The test result is displayed as a unified report in HCL OneTest UI.

You have run the mobile tests that are in an AFT Suite. The tests run on mobile devices that are connected to the multiple mobile clouds from the location you configured.

What to do next

You can view the unified report for the mobile tests and choose to export the unified report. See Unified reports.