Running compound tests on iOS devices on BrowserStack Cloud

You can run compound tests for mobile tests on the BrowserStack Cloud so that you can choose devices from a wide range of iOS devices that are available for testing.

Before you begin

You must have completed the following tasks:

Recorded mobile tests. See Recording mobile tests for iOS applications.
Created a compound test that contains mobile tests, see Creating a compound test.
Set up your account to access the BrowserStack Cloud. You must have valid credentials such as the user name, either the host name or the URL of the BrowserStack cloud instance, and an API key to authenticate the connection. This key is available under ACCESS KEY in the BrowserStack dashboard.
Uploaded the .ipa or .app file of the iOS application to the BrowserStack server for testing. For more information, refer to Live Testing in the BrowserStack documentation.
Installed the iOS application that you want to test on the iOS device.

Procedure

Open the UI Test perspective in HCL OneTest™ UI, if it is not already open.
Select the compound test that contains the mobile tests from the Test Navigator pane.
The test window is displayed.
Click Window > Preferences > Test > Test Execution > UI Test Playback.

The UI Test Playback pane is displayed.

Perform the following steps in the UI Test Playback pane:

Click the Mobile Device Cloud tab.
Select the BrowserStack host checkbox to enable the options on the BrowserStack Device Cloud Environment panel.

Perform the actions as listed in the following table:


Option	Action
Required
BrowserStack host	Enter the URL of the BrowserStack cloud instance.
User Name	Enter the user name of your BrowserStack account.
API key	Enter the API key of your BrowserStack Cloud account to authenticate the connection.
Optional
Project	Enter an appropriate name for the project with which you can identify the test run on the BrowserStack Cloud dashboard.

Click Apply and Close.

Note: When the connection with the BrowserStack Cloud instance is successful, the mobile devices that are on the BrowserStack Cloud are displayed in the Run using drop-down list.

Click the Run Compound Test icon.
The Run Configuration dialog is displayed.
Perform any of the following actions:
- To run each mobile test that is in the compound test on a specific device, go to step 6.
- To simultaneously run all the tests that are in the compound test on the same set of devices, go to step 7.
Clear the Run on several devices and browsers in parallel option, if selected, and then perform the following actions:
1. Click the Run using option for each test, to view the mobile devices or emulators that are connected to the BrowserStack Cloud.
2. Select a device from the list.
3. Repeat steps 6.a and 6.b, for each of the tests in the Compound test.
4. Click Next.
  
  The Advanced Playback Options dialog is displayed.
  Note: For mobile tests, you can skip this step.
5. Click Next.
  
  The Performance Measurement dialog is displayed.
  
  Note: For mobile tests, you can skip this step.
6. Click Finish.
Select the Run on several devices and browsers in parallel option, if not selected.
All the mobile devices and emulators that are connected to the BrowserStack Cloud are displayed.
You must perform the following steps:
1. Select the devices on which you want to run the test.
2. Click Next.
  
  The Advanced Playback Options dialog is displayed.
  
  Note: There is no action to be performed by you for mobile tests.
3. Click Next.
  
  The Performance Measurement dialog is displayed.
  
  Note: There is no action to be performed by you for mobile tests.
4. Click Finish.

Results

You have run the compound test on multiple iOS devices that are avialble on the BrowserStack Cloud.

What to do next

You can view the unified report for the mobile tests and choose to export the unified report. See Unified reports.