Running mobile tests on Android devices on BitBar Cloud

You can run mobile tests on an Android device that is connected to the BitBar Cloud.

Before you begin

You must have completed the following tasks:
  • Recorded mobile tests. See Recording mobile tests for Android applications.
  • 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 .apk file of the Android application that you want to test on an Android device in the BitBar Cloud. For information, refer to Live Testing in the BitBar documentation.
  • Installed the Android application that you want to test on the Android device.

About this task

When you run mobile tests, you can enable Rational® Functional Tester to collect metrics for certain parameters of the resources used by the mobile applications or devices. You can select the Resource Monitoring option and set the time intervals for the collection of the metrics during the test run.

Procedure

  1. Open the UI Test perspective in Rational® Functional Tester, if it is not already open.
  2. Select the mobile test from the Test Navigator pane.

    The test window is displayed.

  3. Click Window > Preferences > Test > Test Execution > UI Test Playback.

    The UI Test Playback pane is displayed.

  4. 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.

      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.
  5. Click the Run Test play back a Web UI test icon.
    The Run Configuration dialog box is displayed.
    Note: If you are using a compound test that contains mobile tests, you can specify the mobile device to play back the test for each mobile test.
  6. Select the mobile device to play back the test from the Run using list and click Next.
    The Advanced Playback Options dialog box is displayed.
    Note: There is no action to be performed by you for mobile tests.
  7. Click Next.

    The Performance Measurement dialog box is displayed.

  8. Perform the following steps if you want Rational® Functional Tester to collect the Resource Monitoring metrics during the test run:
    1. Select the Resource Monitoring option.
    2. Set the interval to collect the metrics by entering a number in the Polling interval field.
      Note: The minimum value that you can enter in the Polling interval field is 1000 milliseconds.
  9. Click Finish.

Results

The test runs on the Android device that is connected to the BitBar Cloud. The test result is displayed as a unified report in Rational® Functional Tester.

What to do next

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

If you opted to collect the Resource Monitoring metrics, you can view the metrics displayed graphically in the UI Test Statistical report. You can analyze the Resource Monitoring metrics to manage the resources of the device or the mobile application under test. See UI Test Statistical report.