Running Web UI tests on BitBar Cloud

You can run Web UI tests on mobile devices that are connected to the BitBar cloud device. After the test run is completed, you can view the test reports in IBM® DevOps Test UI (Test UI).

You must have completed the following tasks:

  • Set up your account to access the BitBar cloud. You must have been issued valid credentials such as the URL of the BitBar cloud instance and an API key to authenticate the connection. This key is available under My Account > My Integrations > API Access in BitBar cloud.
  • Created one or more Web UI tests.

BitBar is a cloud testing platform which you can connect from Test UI or from a remote agent computer. BitBar supports both iOS and Android applications. You must configure the BitBar Device Cloud Environment before you can run the tests.

  1. Start Test UI
  2. Select UI Test perspective.
  3. Go to Windows > Preferences > Test > Test Execution > UI Test Playback.
  4. Select the Mobile Device Cloud tab.
  5. Select the BitBar host checkbox to enable the BitBar Device Cloud Environment
  6. Perform the actions listed in the following table:
    Option Action
    BitBar host Enter the URL 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: When the connection with the BitBar cloud instance is successful, 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. The default value is runTest.
  7. Click Apply and Close.
  8. Open the Web UI test for playback from the Test Navigator pane.

    The Test is displayed.

  9. Click the Run Test icon.

    The Run Configuration dialog is displayed.

  10. Select the device on the BitBar cloud for the test playback from the Run Using drop-down list.
  11. Click Next.
    The Advanced playback options page is displayed.
  12. Click Finish.

    The test playback is started on the selected device.

You successfully ran the Web UI test on the selected device that is on the BitBar cloud.

After the run, the test results are displayed as a unified report in Test UI.

You can view the following details from the unified report:
  • The details and screen capture that are associated with each test step. To view these details, you can click each test step in the Details pane.
  • Android device or iOS device on which the test was played back. To view the device, you can click the icon.
  • Test information such as AUT, host computer, and duration of the test. To view such information, you can click the icon.
  • All the screen captures in a slide show format. To view the screen captures, you can click the icon.