Manage apps

The Apps screen provides visibility and control of applications in the lab. Upload a new app, see information about apps that have already been uploaded, or delete apps.

In this topic:

• View app details
• App options
• Device provisioning information (iOS only)
• Upload an app
• Agent apps
• System apps
• Troubleshooting

View app details

You can view app details in the Applications tab. View apps in either List or Card view by toggling between List and Card in the upper-right corner. Use the filter panel to limit what items are displayed, to focus on the information that is important to you. Filter by OS or workspace, or use the Search to specify an app name. Only matching items are displayed.

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.
Upload number, version and build number	By default, the latest upload for the workspace that you are viewing is selected. You can 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. When testing, you can choose the latest upload, or select a specific upload of an app. Tip: Hover over the version or build number to display a tooltip with the date and time of the latest upload.
Compatible device types (Card view)	Indicates what type of devices are compatible with the app - Phone, Tablet, or both.
Workspace name	The workspace to which the app was uploaded

The cards of apps that were packaged using an earlier version of Digital Lab and could not be repackaged during the upgrade, are 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 with the packager service or Package an Android app manually.

Back to top

App options

In Card view, hover over a card to display the app options. In List view, select an app from the list to enable the toolbar options.

You can perform the following actions on an app:

Card view	List view	Details
		Delete. Deletes all uploads of the app in this workspace
		More information. Opens the Details window of the app for viewing more information about the app.

Details window

When you click More information, the following details are displayed:

	This is the unique identifier for the app. This information is taken directly from the manifest file of the app. Use the copy icon to copy the package ID.
	Android apps only. The name of the Android activity to run when the app is launched. Use the copy icon to copy the launch activity.
	The workspace to which this app was uploaded. For more details, see Lab and workspace management.
	Displays all the app uploads for the workspace. To delete a specific upload, hover over the upload and select the Delete button . If you need to select a specific app upload for testing, you can do this from the Digital Lab wizard, or using App interactions in the Device access window. Note: You see all the uploads for the workspace specified in the workspace name on the app card. Uploads of the app to other workspaces are not displayed. The latest upload is the latest one for the specific workspace that you are viewing.
	Hover over the icon in the Package column to see the app packaging status:  Both a packaged and non-packaged version are 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. After 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.
More details	In certain environments, additional information is displayed: For iOS apps, there is 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. For apps uploaded when Service Virtualization is enabled, there is an indication of the SV Enabled services, such as Bluetooth, NFC, and REST API. For details, see Digital Lab integration in the SV Help Center.

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 you have a Developer certificate, make sure that the unique device ID (UDID) of your device is listed in the provisioning profile.

When an app is signed with a Developer certificate, the option to install the app on an OpenText public device or a WeTest device is not be blocked even if the UDID is not included in the provisioning profile. For AWS public devices, iOS apps should be installed when setting up the device.

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

To check whether your upload can be installed:

1. In the Applications tab , click the More icon on the card of the iOS app you want to test. In List view, select the app and click in the toolbar above the list of apps.

2. In the app Details window, hover over the icon in the Devices column to see the details for a specific upload:

   • The app is signed with an Enterprise certificate and can be installed on all devices.
   • The app is signed with a Development certificate. Click the icon for the list of devices included in the provisioning profile.

Back to top

Upload an app

Both users and admins can upload an app to Digital Lab.

1. Upload an app in one of the following ways:
   

All users	Select the Apps tab. In the Applications window click Upload application .
Admin users	In Administration , select the Management tab. In the left pane, select Lab Management. Select All Apps to view all the apps in your lab. Click Upload in the toolbar.

2. Select the app and a workspace to which to upload the app.
3. Select a packaging or signing option if required.
   
   By default, apps are uploaded without signing and packaging. Packaging is required for simulations and to measure transaction response time in LoadRunner scripts.
   
   The following signing and packaging options are available when uploading an app:
   

Android

Package and re-sign the application: If selected, both a packaged and non-packaged version of the app are uploaded.

iOS

Package the application: If selected, both a packaged and non-packaged version of the app are uploaded. Re-sign the application: If selected, the app is re-signed using the Apple Developer certificate and provisioning profile specified in the admin settings. For details, see iOS signing service. Select this option if you are signing with a Developer certificate and the app is not already signed with a provisioning profile containing the UDIDs of all test devices, or if you are packaging the app. Note: If you are only using devices from cloud labs that support automatic signing with their own certificate (OpenText public devices, ADF devices, and WeTest devices), you do not need to re-sign the app when packaging.

4. Click Upload.
   
   When you upload an app with the Package the application option selected, the packaging status (Packaging…,Packaging complete, or Packaging failed) is indicated on the app card and also in List view. For more details on packaging, see App packaging and signing services.
   
   While packaging is in progress, hover over the packaging status and click the Refresh icon to see the most up-to-date packaging status.
   
   

Note:

• If you are using a Pro or Express license, the app is uploaded to the Shared assets.

• App uploads are blocked if the space allocated for storage is full. File storage space is defined by admin users in the administration settings. For details, see File storage.

• If you open the Digital Lab wizard from an integration tool, such as UFT One, 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.

Back to top

Agent apps

Admin users view and manage the Agent apps from the Agent apps tab in the Apps screen. 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 Digital Lab. They provide a communication channel between the device and Digital Lab. 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.

ValueEdge Digital Lab:

1. Locate the Agent apps in the connector's Agent folder.

2. Upload the apps to ValueEdge Digital Lab.

3. Configure the iOS signing service. For details, see iOS signing service.

4. Sign the apps and distribute to connectors. For details, see sign an Agent app, and distribute the signed Agent apps to connectors.

View details of Agent apps

Admin users can see the status of these apps by clicking More on an Agent app card, or by selecting the app and clicking More information in the toolbar above the list of Agent apps.
UFT Digital Lab and UFT Digital Lab Managed SaaS: The built-in Agent apps, automatically installed as part of the Digital Lab installation, cannot be deleted. However, you can delete other uploads of the Agent apps.

Sign and distribute the Agent apps

Admin users can also sign an Agent app from the app Details window, if the signing service has been configured. For details on the signing service, see iOS signing service.

To sign an Agent app:

1. Click More on the app card, or select the Agent app in List view and click More in the toolbar.

2. In the app Details window, click Sign Agent , or download the app for manual signing. For details on manual signing, see Package an iOS app manually with the packager service or Package an iOS app manually with the iOS Enabler.

To sign the Agent apps with a different provisioning profile, for example if new devices were added to the provisioning profile, do the following:

Service	To change the provisioning profile:
Embedded	Replace the certificate and provisioning profile in Administration settings >  iOS signing service.
Remote	Click and upload the new provisioning profile. The Agent apps are signed with this provisioning profile. The automatic signing service must be set up to use this option. If automatic signing is not configured, download the apps, manually sign them with the new provisioning profile, and then re-upload them to Digital Lab. The uploaded provisioning profile is used for a one-time signing of the Agents. It does not replace the provisioning profile defined in the remote signing service settings. This option is supported only when using the remote signing service.

To distribute the signed Agent apps to connectors:

1. Navigate to Device Lab > Connectors, select the required connectors in the grid, and click Distribute Agents.

2. 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. 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:

Digital Lab Browser	Use this for measuring transaction response time (TRT) when using TruClient. The Digital Lab Browser apps can't be deleted or updated. For more details, see Digital Lab Browser Apps.
Advantage Shopping	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

See also:

• Automatic signing services
• Re-sign the Agent apps
• Lab and workspace management