View, upload, and manage apps

The APPS menu provides visibility and control of applications in the mobile lab.

You can upload a new app, see information about apps that have already been uploaded, and delete apps.

Note: Full multi-workspace functionality described here is only available with a Trial, Enterprise, or Ultimate license. If you install an Express or Pro license, or if you move from a Trial license to an Express or Pro license, you will have limited functionality. You will be able to manage the access of users to available devices by creating workspaces, and by moving devices and users to these workspaces, similar to the device group functionality provided in earlier versions of UFT Mobile. However, you will only be able to upload apps as shared assets.

View app details

When you upload an app with Auto packaging enabled, the packaging status is indicated on the app card, and also in the last column of the List view: Packaging…, Packaging complete, or Packaging failed. While packaging is in progress, you can hover on the packaging status and click the Refresh icon to see the most up-to-date packaging status.

Tip: Use the filter panel to limit what items are displayed, so that you can focus on the information that is important to you. You can filter by OS or workspace, or use the Search in the right pane to specify an app name or app package ID. Only matching items are displayed.

You can also view the apps in a List view. Click List and Card view in the upper right corner to toggle between the views.

To see the details in the List view, select an app and click More. In Card view, the apps are displayed with the following summary details:

  • Name of the app
    The app name may contain I18N characters.
  • Operating system
    Android or iOS. When the app requires a minimum OS version, this is indicated next to the OS icon.
  • SV enabled
    Whether this app is packaged for Service Virtualization. For details, see Set up Service Virtualization (SV) .
  • Upload number, version and build number
    By default, the latest upload for the workspace that you are viewing is selected. You may have several uploads of an app that you want to test. For example, if you introduce changes to your app, you may want to test the differences between the various uploads of the application. You can choose to use the latest upload, or a specific upload of an app.
  • Compatible device types
    Indicates what type of devices are compatible with the app - Phone, Tablet, or both.
  • Workspace name
    The workspace to which the app is uploaded.
    Note that System apps are not assigned to a specific workspace.

  • Auto packaging
    A toggle switch indicating that all apps uploaded in the future should be packaged automatically. For more details on packaging, see App packaging and signing services.

Apps that were uploaded in an earlier version of UFT Mobile and could not be repackaged during the upgrade, will be blurred and shown with a red icon in the top left corner. For information on manually repackaging an app, see Package an iOS app manually or Package an Android app manually.

Back to top

Agent apps

Admin users can view and manage the Agent apps from the Apps tab. These apps are not visible to users.

The Agent apps are standard iOS applications that needs to be installed on each device that you want to use with UFT Mobile. These provide a communication channel between the device and UFT Mobile.

The Agent apps must be re-signed with a development certificate of an Apple Developer Account, and a development provisioning profile belonging to the same account. These provide the identity of the developer, and the list of devices on which distribution of the app is allowed. For more details, see Re-sign the Agent apps.

Admin users can see the status of these apps by clicking the icon on an Agent app card. They can also automatically sign an Agent app from the app card (if the packaging service has been set up) by clicking the icon, or download the app for manual signing.

To sign the Agent apps with a different provisioning profile, for example if new devices were added to the provisioning profile, click . The Agent apps will be signed with the selected provisioning profile. Note that the automatic packaging service must be set up to use this option. If automatic packaging is not configured, you can download the apps, manually sign them with the new provisioning profile, and then re-upload them to UFT Mobile.

To distribute the signed Agent apps to connectors, navigate to DEVICE LAB > CONNECTORS, select the required connectors in the grid, and click Distribute Agents . After the updated Agent apps have been distributed to connectors, select the relevant connectors from the grid and click Reconnect Devices.

For more information , see View and manage connectors (Admin only). Note that even if an earlier upload of an Agent app is selected in the app card, the latest upload is always used for distribution to connectors.

Back to top

System apps

Several built-in apps are provided with your installation:

UFTM Browser

The UFTM Browser apps for iOS and Android can be used to test mobile web applications.

The UFTM Browser apps can't be deleted or updated. For more details, see UFTM Browser Apps.

Advantage Shopping

The Advantage Shopping app is available for devices with iOS 8.2 and higher and Android devices versions 4.4 and higher.

This app is a sample online store for home electronics. It has a standard online shop interface, with common features such as search and a shopping cart.

Back to top

Options toolbar

Card view

Hover on an app to show the following options in a floating toolbar:

  • Delete. Deletes all uploads of the app in this workspace.
  • More information . Opens the Details page of the app as shown below:

 

This is the specific upload of the app selected for testing. If you introduce changes to your app between uploads, you may want to test the differences between the various uploads of the application. By default, the latest upload is always selected for testing.

This is the version & build number of the app. UFT Mobile takes this from the manifest file of the app.

This is the unique identifier for the app. This information is taken directly from the manifest file of the app. You can also filter by this name.
Android apps only: The name of the Android activity to run when the app is launched.
Lists the workspace to which this app belongs. For more details, see Workspace management.

Displays all the app uploads for the workspace, and which upload the tester has selected for testing.

  • To delete a specific upload, select the Delete button in its row.
  • To always use the latest one, select Latest upload.

Note: You will see all the uploads for the workspace specified in the workspace name on the app card. In the example above, only uploads 1 and 4 are associated with this workspace. Uploads 2 and 3 are not displayed because they were not uploaded to this workspace, or they may have been deleted. The latest upload is the latest one for the specific workspace that you are viewing. In the example above, the latest upload is upload number 4.

Hover on the icon to see whether both a packaged and non-packaged version are available, or if only a packaged version is available.

Only a non-packaged version is available. Click this icon to begin packaging the app for the selected upload.

One of the properties (IP address, protocol, or port) of the app packager is missing or incorrect. Admins can modify the packaging service settings in the Administration Settings. Once these properties are fixed, click this icon to begin packaging the app for the selected upload.

For more details, see When to use a packaged app.

Note: In certain installations, there will be additional information:

Beneath the Package ID, the app details will show the workspace to which the app was uploaded.

  • For iOS apps, there will be an option to view the list of devices included in the provisioning profile, indicating the devices on which the app can be installed. For details, see Device provisioning information below.
  • For apps uploaded after Service Virtualization was enabled, there will be an indication of the SV Enabled services, such as Bluetooth, NFC, and REST API. For details, see Set up Service Virtualization (SV) .

List view

In List view, the following actions are available for a selected app:

  • Auto packaging. Automatically package all apps that are uploaded.
  • Delete. Delete all uploads of the app in this workspace.
  • More . Displays the full details of the app.

Back to top

Device provisioning information (iOS only)

Provisioning is the process of preparing an app to launch on devices. As part of this process, a match is required between the provisioning profile embedded in the app and the one installed on the device. If you have an Enterprise certificate, all devices are included. If, however, you have a development certificate, you must make sure that the UDID of your device is listed in the provisioning profile.

For information on how to create a provisioning profile, see Generate a development provisioning profile.

To check whether or not your upload can be installed:

  1. In the App view, click on the More information icon in the app whose upload you want to test.
  2. Select the upload you want to test, and hover on the icon in the App Details screen. The tooltip shows the status of the selected upload:

    • Signed with an enterprise certificate and can be installed on all devices.
    • Signed with a development certificate. Click on the icon for the list of devices included in the provisioning profile.

If the provisioning profile of an iOS app that you select to install on a specific device does not include that device, a warning icon will be displayed, and you will not be able to proceed with your selection. Note that this only applies when selecting a specific device, and not if you select a device by capabilities.

Back to top

Upload an app

You can upload an app in one of the following ways:

  • For all users: Click the APPS tab. In the APPLICATIONS pane click Upload (list view) or Upload application (card view). Select the app.
  • For admins only:

    1. In Administration , click the MANAGEMENT tab.
    2. In the left pane, click Lab Management.
    3. Select ALL APPS to view all the apps in your lab.
    4. Click the Upload button and specify the path to the app and select a workspace.
    5. Click UPLOAD.

 

Note that:

  • If you are using a Pro or Express license, the app is uploaded to the shared assets.
  • If you open the UFT Mobile wizard from an integration tool, such as UFT, the workspace selection drop down is not shown—it uses the workspace configured in the testing tool.
  • The maximum file size that you can upload is 1 GB.
  • For devices running an Android version prior to 5.00, apps with multiple dex files are not supported (for packaged apps).
 

Back to top

Troubleshooting

Why can't I see all my apps?

Check the filter panel to see what options are selected. UFT Mobile displays only the items that fit the filter conditions. To display all items, select all the filter options and clear the search field of any text that you have entered.

Blue text in the filter pane indicates an active filter.

Back to top

See also:

Got it!
Welcome to the help center for UFT Mobile, formerly known as Mobile Center. UFT Mobile is part of the new Micro Focus UFT family of integrated functional testing solutions.