Skip to main content

iOS Devices

The Eggplant Gateway for iOS runs on Windows, Linux and macOS machines and supports testing on real, physical iOS devices over Wi-Fi and USB.

Getting started

Before you can use the Eggplant Gateway for iOS, you'll need to:

  1. Have access to an iOS Provisioning Profile which allows you to sign iOS applications and run iOS applications signed with your developer certificate on your devices.
  2. Have a copy of the relevant Developer Disk images on your local machine
    • On a Mac machine, make sure the latest version of Xcode is installed.
    • When Xcode is installed you can use the default /Applications/ folder as developerDiskLocation.
    • On Windows or linux you need to copy the appropriate develoeper disks from a MacOS pc with Xcode installed.
      • Navigate to the /Applications/ folder on a MacOS pc.
      • Create a zip archive that contains the contents of this folder.
      • Copy this zip archive to your Windows or linux PC and unzip it.
  3. Install iTunes (on Windows) or usbmuxd (on Linux)

Enabling automation on your iOS device

  1. Establish trust between your PC and your device.
    • Connect your iOS device to your PC using an USB cable.
    • The pop-up Trust this Device will appear on your iOS device, click Trust. It can take up to one minute for your iOS device and your machine to initiate the pairing process.
  2. Enable developer mode on your device (iOS 16 and later).
    • In the Settings app on your iOS device, scroll down and tap Developer Mode.
    • Turn on the Developer Mode toggle at the top.
    • A prompt will appear at the bottom asking you to reboot your iOS device for enabling the feature. Tap Restart to proceed. Your iOS device will now reboot.
    • Once the device is restarted and unlocked, a prompt should appear on the screen asking you whether you wish to turn on Developer Mode on your device. Tap Turn On. When you do that, iOS will enable Developer Mode on your iOS device and you should be able to connect .

Creating a connection

To create an Eggplant Gateway for iOS connection, run the following command:

epgw add ios
--name <name> (REQUIRED)
--udid <udid>
--provisioningProfile <path> (REQUIRED)
--developerCertificate <path> (REQUIRED)
--developerCertificatePassword <password> (REQUIRED)
--developerDiskLocation <path> (REQUIRED)

For example, epgw add ios --name ios --provisioningProfile "C:\" --developerCertificate "C:\"
--developerCertificatePassword "****" --developerDiskLocation "C:\"

The available options are:

nameThe connection name
udidThe UDID of the device on which to run the Xcode UI Test. You can omit this parameter if exactly one iOS device is connected to your computer.
provisioningProfileThe path to the provisioning profile to use when installing WebDriverAgent.
developerCertificateThe path to the developer certificate to use to resign WebDriverAgent.
developerCertificatePasswordThe password to use to retrieve the private key of the developer certificate.
developerDiskLocationThe path to the directory which stores the Developer Disks images.
helpShow help and usage information

Connecting to Eggplant Functional

Follow these steps to start an emulator through Eggplant Functional:

  1. Run epgw vnc <name>, where name is the name of your Gateway connection. For example, epgw vnc ios.
    • The Eggplant Gateway will start:
      • A VNC server at port 5900
      • A WebDriver server at port 5000
  2. Start Eggplant Functional and manually add your device to the connection list.