Configure tests for iOS in online clouds

You can run Mobile Engine 3.0 TestCases using iOS devices and simulators in online clouds. To configure these TestCases, you need to create specific test configuration parameters (TCPs) for each cloud. You can use the following online clouds:

GigaFox (ex. Mobile Labs)
Perfecto
Sauce Labs
Test Object

For information on configuring TestCases for locally or remotely connected iOS devices or simulators, see chapter "Configure tests for iOS devices and simulators".

Generic TCPs

The table below contains the TCPs that are applicable for all iOS devices and simulators.

Test configuration parameters	Description	Optional
Browser	Enter SafariiOS to automate hybrid and mobile web applications on iOS.	■
ExecuteInParallel	Add this test configuration parameter on the ExecutionLists Folder level and set its value to True to run your mobile tests in parallel.	■
LiveView	The Live View enables you to display a preview of the Android device or emulator during test execution. To activate it, set the test configuration parameter LiveView to True.	■
ScreenFlow	If you want Tricentis Tosca to automatically save the screenshots of TestStepValues with ActionMode Input, set this parameter to True. For detailed information, see chapter "Take screenshots of TestStepValues with ActionMode Input".	■
ScreenFlowPath	Specify the path where you want Tricentis Tosca to save the screenshots of TestStepValues. For detailed information, see chapter "Take screenshots of TestStepValues with ActionMode Input".	■
UseXBrowserForMobile	As of Tricentis Tosca 13.2, the test automation of web applications is based on a new and fast mobile HTML engine. However, if you want to use the previous technology, add this test configuration parameter and set its value to True.	■

Specify TCPs for GigaFox (ex. Mobile Labs)

To run the test cases on an iOS device or a simulator in GigaFox, specify the test configuration parameters as described in the table below.

Test configuration parameters	Description
AppiumServer	Enter the address of the GigaFox Appium server which by default is http://deviceconnect.yourcompany.com/Appium. Test automation requires Appium version 1.16.0.
DeviceName	Enter the Device ID, which you can find in your device details view in GigaFox.
MobileLabsAccessKey	Enter the access key of your GigaFox account.
MobileLabsUsername	Enter the user name of your GigaFox account.

Find DeviceName in GigaFox

To find your DeviceName, follow the steps below:

Log in to GigaFox.
Select Manage Your Account in the upper right corner.
Find the API Token section and click View Token. The DeviceName value is your deviceConnect ID in GigaFox, which you can take from your device details view.

iOS Device ID in GigaFox

Example - Configure the TestCases of an iOS mobile web application in GigaFox

In the example below, you configure a Shopping TestCase for GigaFox.

TCPs for iOS GigaFox execution

Specify TCPs for Perfecto

To run the test cases on an Android device or on an emulator in Perfecto, follow the instructions in chapter "Configure tests in Perfecto".

Specify TCPs for Sauce Labs

To run the test cases on an iOS device or a simulator in Sauce Labs, specify the test configuration parameters as described in the table below.

Test configuration parameters	Description
AppiumServer	Enter the address of the Sauce Labs Appium server. For the endpoint located in Europe, use https://ondemand.eu-central-1.saucelabs.com/wd/hub. For the endpoint located in the US, use https://ondemand.us-west-1.saucelabs.com/wd/hub. To avoid high latency, Tricentis recommends that you use the endpoint which is geographically closer to you.
DeviceName	Enter the full name of the device or simulator that is accessible on Sauce Labs.
OSVersion	Enter the version number of the iOS device or simulator. If this test configuration parameter is not specified, Tricentis Tosca uses the default version iOS 11.4.
SauceAccessKey	Enter the access key for your Sauce Labs account. You can find your access key in your Sauce Labs account information in the AccessKey section.
SauceUsername	Enter the user name of your Sauce Labs account.

You can find a list of available Sauce Labs devices and simulators, as well as their names and versions in your Sauce Labs account or on the Sauce Labs Platform Configurator when you select the Appium framework.

Example - Configure the TestCases on an iOS simulator in Sauce Labs

In the example below, you configure a Shopping TestCase for Sauce Labs. For the AppiumServer TCP, you use the endpoint which is geographically located closer to you.

TCPs for iOS Sauce Labs execution

Specify TCPs for TestObject

To run your mobile tests in TestObject, specify the following test configuration parameters:

Test configuration parameters	Description
AppiumServer	Enter the address of the TestObject Appium server.
DeviceName	Enter the Device ID from your TestObject account.
TestObjectApiKey	Enter the API access key for your TestObject account.

Sign in to your SauceLabs account. TestObject is part of SauceLabs.
In the menu bar on the left, click on SAUCE APPS->Legacy RDC

Your TestObject account opens in a new tab.

Find your AppiumServer in TestObject

Sign in to your TestObject account.
Click on the application that you want to test.
Click AUTOMATED TESTING and select Appium.
Click Setup Instructions.

Copy the Appium Server address that matches the location of your device.

Find your DeviceName in TestObject

To find your Device ID, follow the steps below:

Sign in to your TestObject account.
Click on the application that you want to test.
Go to Live Testing.
Open the device that you want to use for your tests.
In the pane on the right, click INFO.
Copy the Device ID from the ID field.

Find your TestObjectApiKey in TestObject

To find your API Key, follow the steps below:

Sign in to your TestObject account.
Click the Account icon and select Account Settings.
Copy the API Key from the User API Key field.

Example - Configure the TestCases in Test Object

In the example below, you configure a Shopping TestCase for TestObject.

TCPs for iOS TestObject execution