Configure tests for iOS devices and simulators

You can run the Mobile Engine 3.0TestCases using locally or remotely connected iOS devices and simulators. This chapter provides an overview of the test configuration parameters (TCPs) you can use to configure your tests on iOS devices and simulators.

For information on configuring the tests of iOS applications in online clouds, see chapter "Configure tests for iOS in online clouds".

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 iOS device or simulator 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 iOS devices and simulators

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

Test configuration parameter	Description
AppiumServer	For test automation on iOS devices or devices connected to a Mac, enter the address on which the Appium server is running. The Appium server address consists of the IP address of your Mac, the default Appium port 4723 and the standard path for the Appium server /wd/hub. Example: http://192.168.43.142:4723/wd/hub You can verify if the Appium server address works correctly by opening it in a browser.
DeviceName	For iOS devices, enter the UDID of the connected iOS device. To find the UDID, connect your device to your Mac, go to iTunes, and click on the phone icon in the top menu. The UDID is shown in the pane on the right-hand side. If you have only one device connected to your Mac, or if you have multiple devices connected, but do not care on which one the test automation is triggered, you can replace UDID with Auto. Alternatively, you can leave this parameter blank. For iOS simulators, enter the full name of the simulated device as shown in the simulator.
OSVersion	If you want to use simulators for specific iOS versions, enter the respective iOS version number as a value. The iOS version must be supported by the Mobile Engine 3.0 and it must be available on the Appium server. If you don't specify this test configuration parameter, Tricentis Tosca uses the default version iOS 11.4.

Test configuration parameter

Description

AppiumServer

For test automation on iOS devices or devices connected to a Mac, enter the address on which the Appium server is running.

The Appium server address consists of the IP address of your Mac, the default Appium port 4723 and the standard path for the Appium server /wd/hub.

Example: http://192.168.43.142:4723/wd/hub

You can verify if the Appium server address works correctly by opening it in a browser.

DeviceName

For iOS devices, enter the UDID of the connected iOS device.

To find the UDID, connect your device to your Mac, go to iTunes, and click on the phone icon in the top menu. The UDID is shown in the pane on the right-hand side.

If you have only one device connected to your Mac, or if you have multiple devices connected, but do not care on which one the test automation is triggered, you can replace UDID with Auto. Alternatively, you can leave this parameter blank.

For iOS simulators, enter the full name of the simulated device as shown in the simulator.

OSVersion

If you want to use simulators for specific iOS versions, enter the respective iOS version number as a value.

The iOS version must be supported by the Mobile Engine 3.0 and it must be available on the Appium server.

If you don't specify this test configuration parameter, Tricentis Tosca uses the default version iOS 11.4.

Example - Configure the TestCases of a native application on an iOS device

In the example below, you run the TestCase Shopping in a native application on an iOS device.

TCPs for a native application on iOS

Example - Configure the TestCases on an iOS simulator

In the example below, you run the TestCase Shopping in Safari on an iOS simulator.

TCPs for a mobile web application on an iOS simulator