Page tree

With SeeTest Automation you can fully control the iOS application being tested as well as the device's springboard. Controlling the device's springboard enables actions such as: Changing the device settings, Interaction with a non-instrumented application (like SMS, Contacts, Dialer…), Launch and kill application life-cycle.

Note:   If your only requirement is to test your application (without controlling the device's springboard), you can follow the simple one step connectivity process described as Option B below.

To connect an iOS device so that you can both test applications as well as control the device's springboard:

Step 1: Prerequisites

  1. Install iTunes onto your computer (while SeeTest Automation is closed so the USB drivers can update)
  2. Connect the device via USB to your computer.

Step 2: In SeeTest Automation go to Device Manager and click the Add Device icon and select iOS Device.

 Step 3: In the dialog box now displayed, activate the Enable 'Full Control' mode check box.


Step 4: Having selected the check box above, the following announcement will appear. Click Device Enablement.

Step 5: At this stage, you will be redirected to a third-party website ( where the following browser window opens and displays the form seen below. Fill in the details and click Enable Device. Then follow the instructions will be displayed.

Step 6: After completing the instructions, you should receive a DEF file (Device Enablement File) by email from the third-party website.

Step 7: In the "Tools" menu, select iOS Sign Configuration:


Step 8: In this dialog, you will be able to view all the configured provision profiles you have and the devices they hold in them:

Step 9: Clicking on the "Import" button will open the following window and now follow the steps on iOS sign configuration page:

Step 10:  In Device Manager, select the device which you initially connected at the start of this procedure and click the Edit Device icon.

Step 11: In the Modify iOS Device dialog box now displayed, verify that the:

  • Type of the device is correct
  • Host featured is USB
  • Enable 'Full Control' checkbox is selected
Note:  If a profile is already configured to the device, the checkbox will be enabled by default.

Step 12: Click OK.

The device is now available on the Device List and has the status of Ready.

Step 13: To open the device reflection on your computer's  screen, click the Open Device button.

Open iOS device in Application mode:

This mode enables you to run tests only on one application (without springboard and Safari browser).

Application mode supported only with a local device. 

Step 1: Enabled Switch Control on the device (for iOS 9) - Go to: Setting>>General>>Accessibility>>Switch Control .

Step 2: Install iTunes onto your computer (while SeeTest Automation is closed so the USB drivers can update).

Step 3: Connect SeeTest Automation to your device.

  1. In SeeTest Automation that has been installed on your Windows station), go to the "Device" tab, click the 'Add Device' icon and select 'iOS Device'.

  2. Verify that the device type is correct and that the host was featured is USB.
  3. Make sure the checkbox 'Full Control' is Disabled.

Step 4: Install your application and open it manually on your device, now you can open the device by click on the Open Device button to open the device reflection on the screen.



  1. If an instrumented application is not running in the foreground, the device will be disconnected and you will not be able to control it using mouse and keyboard. You will have to close the window, make sure the instrumented application is opened on the device and then open screen again. 
    Trying to open the device without an instrumented application running will result in the reflection not opening at all.
  2. Make sure to always be within the instrumented application. When running tests on the device, starting point should be when an application is open.
  3. The iOS bridge can provide a full cycle of automation. You can open/Close application  (See iOSBridge page for further information).
  4. In order to run web tests, either the iOS bridge should be in the foreground or the instrumented browser (See Launch (URL) command page for further information).
  5. iOS images caching that was introduced in 8.6 version can be disabled with the following flag in file: enable.ios.images.caching=false.

Warning regarding landscape orientation

In order to work with an iOS device that is in landscape orientation, the device must be orientated to the right, not to the left (see image below). This means that the home button should be on the right side when the device is in landscape orientation.

  • No labels