Getting Started with iOS Gateway

iOS Gateway is a free utility that acts as a mobile VNC server to connect eggPlant Functional with iOS devices. The iOS Gateway application lets you control any iOS device running iOS 7, iOS8, iOS 9, or iOS 10.

How iOS Gateway Works

The iOS Gateway works as a VNC server (from the IP address of the Mac where it is running). When you connect to that Mac from eggPlant Functional, you can see and control your iOS device.

The Mac where the iOS Gateway is running does not need to be the same machine as where you have eggPlant Functional installed. However, the iOS device must be connected by USB to the Mac where iOS Gateway is installed. The diagram below shows a basic network architecture for using iOS Gateway:

The iOS Gateway machine connects to the device via USB; eggPlant Functional can run on the same machine or a different one.

System Requirements

The table below outlines the requirements for testing versions 9 and later of iOS with TestPlant products. For information about testing iOS 7 and iOS 8, see Using iOS Gateway with iOS 7 and iOS 8. For information testing iOS 5 and iOS 6, see eggOn for iOS.

In general, you need to run iOS Gateway on the latest version of Mac OS to test devices running the latest version of iOS.

iOS Version Connection Method Min. Mac OS Version Min. Xcode Version
iOS 9 iOS Gateway 10.10.4 Xcode 7.0
iOS 9.1 iOS Gateway 10.10.5 Xcode 7.1
iOS 9.2 iOS Gateway 10.10.5

Xcode 7.2

iOS 9.3 iOS Gateway 10.11 Xcode 7.3.1
iOS 10 iOS Gateway 10.11.5 Xcode 8

Note: You must install Xcode, Apple's integrated development environment (IDE), on the machine that's running iOS Gateway. Typically, when a new version of iOS comes out, Apple releases a new version of Xcode as well. You need to update Xcode to the latest version to test the companion version of iOS with the iOS Gateway.

Important: Note that iOS Gateway 4.0 is compatible with Xcode 7. Your Mac must run OS X 10.0 or higher to use iOS Gateway 4.0.

Set Up iOS Gateway

First, download and install iOS Gateway. You must have an Apple Developer ID to use iOS Gateway to test iOS devices.

Automatic Provisioning

  1. Open iOS Gateway. Go to iOSGateway > Preferences and select the Provisioning tab.
  2. Select Automatically create/select provisioning profile. Enter the Apple Developer ID and password associated with your Apple developer certificate. This option is recommended for users new to iOS Gateway.

Manual Provisioning

To set up provisioning manually, you must have both a development signing certificate and a development provisioning profile.

  1. Create the signing certificate and provisioning profile on the Apple Developer portal. Download them both to your Mac.
  2. Manually select a profile from the Team Name list. iOS Gateway will automatically show all profiles saved in the default location. Select the one you want to use. Next, select a Sign Identity from the drop-down list.

    Note: The default profile location is ~/Library/MobileDevice/Provisioning Profiles.

Additional Requirements

You also need to ensure that your testing devices are prepared for development use. You can find this information as well as installation instructions in Setting Up iOS Testing.

Lastly, you need to be set up to sign apps for development use. This is an Apple requirement. Learn more in Signing Apps for Use with iOS Gateway.


This topic was last updated on April 25, 2017, at 09:00:56 AM.