Running mobile tests on an Android device or emulator connected to a computer that runs Rational® Functional Tester

Disclaimer: This release contains viewing of the Resource Monitoring metrics for recording or playing back mobile tests on IBM® Rational® Functional Tester as a Tech Preview feature. The Tech Preview is intended for you to view the capabilities offered by Rational® Functional Tester, and to provide your feedback to the product team. You are permitted to use the information only for evaluation purposes and not for use in a production environment. IBM® provides the information without obligation of support and "as is" without warranty of any kind.

You can run mobile tests on Android mobile devices or emulators that are connected to a computer that runs Rational® Functional Tester.

Before you begin

You must have completed the following tasks:

Recorded mobile tests. See Recording mobile tests for Android applications.
Installed the Android SDK on the computer that you want to use for testing Android mobile applications.
Set or changed the value of the ANDROID_HOME environment variable on the computer that you want to use for testing Android mobile applications for the following operating systems:
- Windows operating systems, see Setting or changing the ANDROID_HOME path in Windows operating systems.
- Linux operating systems, see Setting or changing the ANDROID_HOME path in Linux operating systems.
- Mac operating systems, see Setting or changing the ANDROID_HOME path in Mac operating systems.
Installed the Android application that you want to test on the Android device or emulator.
Connected and started the Android device or emulator to the computer that you want to use for testing Android mobile applications.
Ensured that the UI Test Agent is running on the computer that runs Rational® Functional Tester.
Tip: You can hover the cursor over the System Tray to verify that the UI Test Agent is running and also view the port it uses.

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

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

The test window is displayed.
Click the Run 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 or emulator to play back the test for each mobile test.
Select the mobile device or emulator 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.
Click Next.

The Performance Measurement dialog box 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 device or emulator. 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.