Importing applications to test in the workbench

To test a mobile application, the application must be imported into the Rational® Test Workbench Eclipse Client and also installed on a mobile device.

Before you begin

If you are testing Android applications, the Android SDK must be installed on the same computer that the test workbench is installed on. You must set the preferences in the mobile application builder path so that they point to the directory where the Android SDK is installed. For more details, see Mobile application builders. To add an application from a mobile device or an emulator, ensure that the device is connected to the test workbench.

About this task

To test an Android application, you can either use the device to upload the application under test (AUT) to the test workbench or import the application into the test workbench using the Mobile Applications editor.

To test an iOS application, import the application into the test workbench. There is no upload process for iOS applications.

Procedure

  1. In the Test Navigator view, right-click on the Mobile incoming applications node and then click Available mobile applications. Or, in the Test workbench perspective’s toolbar, click the Display available mobile applications icon Display available mobile applications. The Mobile applications editor opens.
  2. In the editor, click the Add applications to list icon Add applications to list to add an application to the test workbench.
  3. Complete one of the following tasks in the Add application window:
    1. To add an application from your local computer, in from local storage, click the Android app iconAndroid app or the iOS app icon iOS app to browse for the application.
    2. To add an application from a workspace, click from workspace, click the Android or iOS icons and select the application.
    3. To add an Android application from a mobile device, click from mobile device, click Next and follow the steps in Uploading Android applications from the mobile test client.
    4. To add an application from a web site, click from web site and type the web site URL or click the button to paste a copied URL.
    5. To add a resource that contains an original mobile application package, click From existing managed App resource. Click the .ma file to regenerate a managed application. Note that the window displays only application files that are not imported.
  4. Optional: In Application description, type a brief description of the application that you are adding.
  5. Click Next and select a project.
  6. Click Finish. Based on the size of the application, test workbench might take some time to prepare the application for test. As a result, a .ma file is created, and the application added to the list of available applications, ready for all the test stages.
    Note: If you import a new version of an application in the Mobile application editor, for which test suites had been created from former versions of the app, a dialog box opens and indicates that test suites referencing other versions of the same application have been found. Click Preview, this opens a refactoring wizard that displays changes. You can ignore and click Cancel, or click Finish to start refactoring. Once refactored, the test suites can be used with the new version of the application. If you clicked Cancel, you can perform the refactoring process later, using Import test suite from other version of application in the Available test tab. This button is enabled only if another version of the app is detected in the editor, but is not available for incoming apps, nor for web apps.

What to do next

For Android applications, you can now record a test from the mobile device. In the mobile test client, go to Managed Apps, tap the application that you added in the test workbench, and tap Record.

For iOS applications, you must first install the application on your iOS device before you can start recording a test. For details, see Installing instrumented iOS applications.


Feedback