Running mobile tests as an AFT Suite on BrowserStack Cloud

After you create an AFT Suite for mobile tests, you can run the AFT Suite on multiple devices connected to the BrowserStack 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 BrowserStack Cloud.
  • Set up your account to access the BrowserStack Cloud. You must have valid credentials such as the user name, either the host name or the URL of the BrowserStack cloud instance, and an API key to authenticate the connection. This key is available under ACCESS KEY in the BrowserStack dashboard.
  • Uploaded the .ipa or .app file of the iOS application or the .apk file of the Android application to the BrowserStack server for testing. For information, refer to Live Testing in the BrowserStack 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 BrowserStack host checkbox to enable the options on the BrowserStack Device Cloud Environment panel.
    3. Perform the actions as listed in the following table:
      Option Action
      Required
      BrowserStack host Enter the URL of the BrowserStack cloud instance.
      User Name Enter the user name of your BrowserStack account.
      API key

      Enter the API key of your BrowserStack Cloud account to authenticate the connection.

      Project Select the BrowserStack 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 BrowserStack Cloud dashboard.
    4. Click Apply and Close.
      Note: When the connection with the BrowserStack Cloud instance is successful, the mobile devices that are on the BrowserStack 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.

What to do next

You can view the test result that is displayed as a unified report for mobile tests and choose to export the unified report. See Unified reports.