Running compound tests on Android devices on pCloudy Cloud

You can run compound tests that contain mobile tests on Android mobile devices that are connected to the pCloudy Cloud.

Before you begin

You must have completed the following tasks:

Recorded mobile tests. See Recording mobile tests for Android applications.
Created a compound test that contains mobile tests, see Creating a compound test.
Set up your account to access the pCloudy cloud. You must have valid credentials such as the host name or the URL of the pCloudy cloud instance, the user name, 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 pCloudy cloud. For more information, refer to Upload Android App in the pCloudy documentation.
Installed the Android application on an Android device in the pCloudy cloud. For more information, refer to Installing Android app in the pCloudy documentation.
Verified that the device you want to test is available and in the Released state on the pCloudy cloud.

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.

Important: Collection of Resource Monitoring metrics and displaying of the data graphically is supported only when you run a compound test on a single device.

Procedure

Open the UI Test perspective in Rational® Functional Tester, if it is not already open.
Select the compound test that contains the mobile tests from the Test Navigator pane.
The test window is displayed.
Click Window > Preferences > Test > Test Execution > UI Test Playback.

The UI Test Playback pane is displayed.

Perform the following steps in the UI Test Playback pane:

Click the Mobile Device Cloud tab.
Select the pCloudy host checkbox to enable the options on the pCloudy Device Cloud Environment panel.

Perform the actions as listed in the following table:


Option	Action
pCloudy host	Enter the host name of the pCloudy instance. For example, `device.pcloudy.com`.
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.

Click Apply and Close.

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.

Click the Run Compound Test icon.
The Run Configuration dialog box is displayed.
Perform any of the following actions:
- To run each mobile test that are in the compound test on a specific device, go to step 6.
- To simultaneously run all the tests that are in the compound test on the same set of devices, go to step 7.
Clear the Run on several devices and browsers in parallel option, if selected, and then perform the following actions:
1. Click the Run using option for each test, to view the mobile devices or emulators that are connected to the pCloudy Cloud.
2. Select a device from the list.
3. Repeat steps 6.a and 6.b, for each of the tests in the Compound test.
4. Click Next.
  
  The Advanced Playback Options dialog is displayed.
  Note: There is no action to be performed by you for mobile tests.
5. Go to step 8.
Select the Run on several devices and browsers in parallel option, if not selected.
All the mobile devices and emulators that are connected to the pCloudy Cloud are displayed.
You must perform the following steps:
1. Select the devices on which you want to run the test.
2. Click Next.
  
  The Advanced Playback Options dialog box is displayed.
  
  Note: There is no action to be performed by you for mobile tests.
3. Go to step 8.
Click Next.

The Performance Measurement dialog is displayed.
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.
Click Finish.

Results

The test runs on the selected mobile devices or emulators. 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.