Running mobile tests as an AFT Suite on BitBar Cloud

After you create an AFT Suite for mobile tests, you can run the AFT Suite on devices connected to BitBar Cloud 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 mobile tests on the BitBar cloud.
  • Set up your account to access the BitBar Cloud. You must have valid credentials such as the host name or the URL of the BitBar Cloud instance, and an API key to authenticate the connection.
  • Uploaded the .ipa or .app file of the iOS application or the .apk file of the Android application that you want to test in the BitBar Cloud. For information, refer to Live Testing in the BitBar documentation.
  • Installed the Android and iOS applications that you want to test on the device.

Procedure

  1. Open the UI Test perspective in Test 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. Perform the following steps in the UI Test Playback pane:
    1. Click the Mobile Device Cloud tab.
    2. Select the BitBar host checkbox to enable the options on the BitBar Device Cloud Environment panel.
    3. 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 or an enter an appropriate name for the project with which you can identify the test run on the BitBar Cloud dashboard.

      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.

    4. Click Apply and Close.
      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.
  4. Select the project that contains the AFT Suite, in the Test Navigator pane.
    The AFT Suite that you created for the mobile tests is located in the Accelerated Functional Tests folder.
  5. Expand the contents of the Accelerated Functional Tests folder to view the AFT XML that is displayed with the name you provided.
  6. 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 repeat 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.
  7. Click OK.

Results

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

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

What to do next

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