Reference › Test Case Reference › Asset Descriptions › Mobile Assets

Mobile Assets

You can create a mobile asset with various devices using the Mobile Session dialog.

Follow these steps:

1. Open the configuration file where you want to create the asset.
2. In the Asset Browser, click Add at the bottom of the pane.
3. Click Mobile Session.

   The Mobile Session dialog displays.

4. Enter a Name for the asset. This name appears in the Destination field in the step editor. Use a name that is meaningful.
5. Enter a Description that helps you identify the asset.
6. Select a Platform: iOS or Android.
7. In the Application field, enter the full path to your application package file (.apk or .app). Or, click the Folder icon to locate and select the file on your computer.
8. (iOS only) In the Family field, select the iOS device type: iPhone or iPad, iPhone only, or iPad only.
9. Select a Target:
   • Emulator (Android)
   • Simulator (iOS)
   • Attached Device
   • SauceLabs

   Fields then vary depending upon the target you select.

10. Define the following fields:

    For an Emulator (Android only)

    Emulator assets specify the mobile emulator that is used for testing on an Android device.

    AVD

    Click the folder icon to locate the Android AVD that you defined when configuring mobile testing.

    SDK Version

    Select the version of the SDK to use with your test case.

    For a Simulator (iOS only)

    Simulator assets specify the mobile simulator that is used for testing on an iOS device.

    Simulator

    Click the folder icon to locate the simulator on your computer.

    iOS Version

    Select the version of the iOS to use with your test case.

    For an Attached Device

    Attached Device assets specify the mobile device that is used for your test cases. This asset is used for physical iOS and Android mobile devices that are connected to your computer.

    Attached

    Click the folder icon to locate the simulator of your choice on your computer.

    Note: If you connect or disconnect a device, click Refresh in the Attached Device dialog to view the latest devices.

    SDK Version (Android only)

    Select the version of the SDK to use with your test case.

    iOS Version (iOS only)

    Select the version of the iOS to use with your test case.

    For SauceLabs

    SauceLabs is a cloud provider of scalable iOS and Android simulators. SauceLabs assets specify the SauceLabs account information for mobile cloud testing.

    Note: Before you can create a SauceLabs asset, you must have a SauceLabs account with a unique access key.

    User Name

    Defines the user name with which to access SauceLabs.

    Access Key

    Defines the key for accessing SauceLabs.

    SDK Version (Android only)

    Select the version of the SDK to use with your test case.

    iOS Version (iOS only)

    Select the version of the iOS to use with your test case.

11. To define advanced options, click .

    The Scope field is now available. For more information, see Runtime Scope.

12. Once you enter an application in the Application field, specific information about the application displays in the Details window.
13. If your application is built using both native and browser elements, select the Mixed Mode check box.
14. To verify the asset before saving, click .
15. Click OK.

    The new asset appears in the Asset Browser.

    Note: If you defined multiple mobile assets, you must select one before you can record a test case.

Important! Android testing requires the correct version of Android SDK Build-tools. If you encounter an error message regarding zipalign or aapt, see Android SDK Build-tools before you continue.