Integrating with Sauce Labs Real Device

This support article provides information on Provar’s integration with Sauce Labs Real Devices for mobile testing.

Note: As Sauce Labs previous support for TestObjects will end on 1st September 2021; Provar users must connect to Sauce Labs Real Devices to continue testing their mobile applications. For more information, please see Sauce Labs Real Device Testing.

Sauce Labs provides comprehensive mobile app testing using real devices, emulators and simulators for Android and iOS. In addition, teams can automate native, hybrid and mobile web apps for complete coverage.

Configuring Sauce Labs Real Devices in Provar

Before configuring a Sauce Labs Real Device Mobile App in Provar, you should already have a Sauce Labs account with the appropriate resource available to test a mobile app. Please refer to Sauce Labs’ documentation for more information on completing this set-up.

Adding a Browser Provider

To configure a Sauce Labs Real Device Mobile App in Provar; first, add a new Browser Provider.

On the Test Settings section, click the Browser Providers tab. Click Add New (‘+’) icon.

Above: View of Browser Providers tab.

An Add new Browser Provider screen is displayed. In the Browser Provider section:

In the Name field, enter a browser provider name.
In the Type field, select Sauce Labs Real Devices from the drop-down.

Above: Adding a new Browser Provider.

In the Connection Properties section:

In the Username field, enter the Sauce Labs username to authenticate the user’s test account.
In the Access Key field, enter the Sauce Labs access key to authenticate the user’s test account.
In the Data Center field, select the specific Sauce Labs data center in which the desired device is located.

Adding a device

In the Devices section, click Add New (‘+’) icon to add a device. The Add Sauce Labs Real Device screen is displayed.

Note: The device list is retrieved from the selected Sauce Labs data center.

Above: Device list is retrieved from Sauce Labs.

In the Details section:

In the Device Type field, select the type of device from the drop-down e.g. Phone.
In the Platform Name field, select the platform from the drop-down e.g. iOS.

Note: Provar provides support for both iOS and Android. Selecting any one of these as a Platform Name will alter the options in the subsequent field drop-downs.

In the Platform Version field, select the appropriate platform version from the drop-down.
In the Manufacturer field, select the manufacturer from the drop-down.
In the Device Type field, select the device from the drop-down.

In the Desired Capabilities section, click Add New (‘+’) icon to add a desired capability to the selected device. An Add new Desired Capability screen is displayed.

Above: Adding a new capability.

In the Name field, enter the desired capability name.
In the Environment field, select the Provar Test Environment where the desired capability must be applied.
In the Value field, enter the value of the desired capability.

Click OK to add the desired capability to the configured device. Once the device has been configured, add a Sauce Labs Real Device as shown below.

Above: View of adding a Sauce Labs Real device.

Click OK to add a device and return to the Browser Provider details screen.

To check that the account credentials are correct and you can connect to the account with the credentials provided, click Test Connection to confirm the connection is established successfully.

To complete adding the new Browser Provider, click OK and the newly added Browser Provider connection is displayed in the Browser Providers tab.

Adding a Mobile App

To use the Sauce Labs Real Device connection, we now add a new Mobile App in Provar and configure it to use the new connection.

On the Test Settings tab, click the Mobile Apps tab. Click Add New (‘+’) icon.

An Add new Mobile App screen is displayed.

Above: Adding a new Mobile App.

In the Details section:

In the App Name field, enter the mobile app name.

The earlier created Browser Provider name and type are displayed as a section within the screen:

In the App Type field, select the app type from the drop-down.
- Native – enter or select the values for the additional fields required for this selection:
  - By Name – If you know the app name, you can select this option.
    - In the App Name field, enter the app name.
  - Available Apps – display a list of available apps from the Sauce Labs connection.
    - In the App field, select the app from the dropdown list.
- Browser – the test case will run on the native browser for the selected device (Chrome or Safari).

Configure a test case

Within a Salesforce Connection test step, in the UI Testing section, select the mobile app created in the previous steps in the Salesforce Application field.

Above: View of configuring a test case.

Running tests on Sauce Labs

To execute a test case using the Sauce Labs Real Device browser provider, select the new browser provider configuration which we just created from the browser configuration dropdown on the toolbar.

Above: View of Sauce Labs Browser Provider.

When the test case is ready to run, use Run mode or Debug mode to execute it.

Above: View of Run and Debug modes.

On the Test Runner tab, you can see the test case progress.

To view the test result in Sauce Labs, login to your account to access the Sauce Labs dashboard, click Automated > Test Results, from the left-hand side menu.