Adding native and hybrid applications to the test workbench

To test a mobile application, the application must be added to 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 add the application to the test workbench using the Mobile and Web UI Applications editor.

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

Procedure

  1. In the Test Workbench perspective’s toolbar, click the Display available mobile and Web UI applications icon Display available mobile and Web UI applications. The Mobile and Web UI 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 a MobileFirst Platform Foundation application, click MobileFirst Platform Application Center and provide the connection details to connect to the Application Center.
    3. To add an application from a workspace, click from workspace, click the Android or iOS icon and select the application.
    4. 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.
    5. 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.
    6. 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 is added to the list of available applications, ready for all the test stages.
    Note: If you add a new version of an application in the Mobile and Web UI Applications editor, and there are existing test suites from a former version of the app, a dialog box opens, indicating that test suites referencing other versions of the same application have been found. Click Preview to open 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 Tests tab in the Mobile and Web UI Applications editor. This button is enabled only if another version of the app is detected in the editor, but is not available for incoming native, hybrid, or web apps. The behavior of the refactoring wizard can be modified in Window > Preferences > Test > Mobile and Web UI > General Settings > Test suite refactoring when adding an application.

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