<a
href=http://www.t-plan.com>T-Plan Home</a>

19 December 2017

iOS Over Xcode Extension Plugin For T-Plan Robot Enterprise

Contents
1. Overview
2. Plugin installation
3. Usage

1. Overview

The iOS Over Xcode Extension Plugin adds new features to T-Plan Robot Enterprise test scripts relying on the iOS Over Xcode connection for iOS 10+. Namely:

Application management - installation, starting and deactivation of applications on the iOS device
Device controls - orientation switching, special gestures

The plugin is primarily designed for test scripts written in the TPR language. To call the plugin scripts from Java either use the DefaultJavaTestScript.run() method or use the script instance approach described in the Java Test Script Basics document.

Should you have any questions or suggestions contact the T-Plan support. For the list of other plugins provided by T-Plan go here.

2. Plugin installation

The plugin requires T-Plan Robot 4.4 or higher. To install the plugin download it from:

Version 0.1 (pre-release for 4.4Beta): http://www.t-plan.ltd.uk/releases/robot/plugins/iosx_v0.1.zip

Pre-release for Robot 4.4Beta

OPTION 1:

Unzip the archive and copy the iosx.jar file to the plugins/ directory under the Robot installation directory. This will make Robot load the classes on the start up. Make sure to remove any older versions of the plugin.
Start or restart Robot.

OPTION 2:

Unzip the file to a location on your hard drive.
If you plan on using the plugin in the TPR scripts put the following command to the beginning of each test script:

Include "<location>/iosx.jar"

If you plan on using the plugin in Java test scripts put the iosx.jar file onto the Java class path.

To uninstall the plugin simply delete the file.

3. Usage

The plugin contains:

Script Name
Description

com.tplan.iosx.StartApp Install and/or start an application on the iOS device.

com.tplan.iosx.SetOrientation Set the screen orientation to portrait or landscape left.

The plugin scripts are to be called from TPR test scripts using the Run command. The command instances may be easily created using the Command Wizard tool. To edit an existing Run command right click it and select Properties in the context menu.

EXAMPLE:

// Presume that iosx.jar is in the script folder Include "iosx.jar"// Start Safari Run "com.tplan.iosx.StartApp" app="com.apple.mobilesafari" // Perform testing here // ... // Rotate the screen to landscape Run "com.tplan.iosx.SetOrientation"orientation="landscape"

Script Name	Description
`com.tplan.iosx.StartApp`	Install and/or start an application on the iOS device.
`com.tplan.iosx.SetOrientation`	Set the screen orientation to portrait or landscape left.