Skip to main content

Installing Signed Apps on iOS Devices

After you have signed your app for development use, you can install it on the iOS device for testing with iOS Gateway. If you need information on signing your app, see Signing Apps for Use with iOS Gateway.

There are four ways to install an app on the device:

  • In iOS Gateway
  • Through the Devices window in Xcode
  • With the InstallApp command in a script
  • Via the Eggplant Functional Control menu

Installing Through iOS Gateway

You can install your signed .ipa files directly on the device through iOS Gateway. Follow the steps below to use this method:

  1. In iOS Gateway, go to Apps > Install Application.
  2. In the file browser that opens, select a signed .ipa file that you want to install on your device. This file can be for eggOnLauncher, eggOnAgent, or your own code-signed app.
  3. Click Open.

When installation is complete, you should see the app appear on one of the home screen pages of the device. If the app is signed with a development provisioning profile, the app also appears on the sidebar in iOS Gateway under the device.

Installing Through the Devices Window in Xcode

To install your app on the device through Xcode, follow these steps:

  1. Open the Devices window in Xcode by navigating to the Window > Devices.
  2. Drag the signed app to the Installed Apps section of the Devices window, or click the plus sign and select the file from the file browser.
  3. Click Open.

The app might not immediately appear in the sidebar of iOS Gateway. If Xcode shows the app as being installed but you're not seeing it in the iOS Gateway list, click the refresh button at the top right of the iOS Gateway sidebar.

Use the InstallApp Command

The InstallApp command lets you install a signed .ipa file onto your device from a script. For information about using this command, see InstallApp Command.

Install with the Eggplant Functional Control Menu

In Eggplant Functional, go to Control > Install App.

Control menu highlighting install and uninstall

On the Install dialog box, enter the App Path, Provision Profile Path, and Certificate Name. The Provision Profile Path and Certificate Name are required to code sign the app for development use (also called developer sign).

Install app dialog box

Click Install.

Uninstall an App via iOS Gateway

To uninstall an app through iOS Gateway, go to Apps > Uninstall Application. You also can right-click the app in question in the app list in iOS Gateway, then select Uninstall Application.


Any apps you uninstall manually on the device still appear in the list of apps in the iOS Gateway sidebar until you click the refresh button at the top of the list, or until you restart iOS Gateway.

Uninstall with the Eggplant Functional Control Menu

Go to Control > Uninstall App.

Uninstall app dialog box

In the drop-down list, select the app you want to uninstall, then click Uninstall.


The available apps list might not reflect apps that have been recently installed or uninstalled. Use the Control > Refresh App List option to have Eggplant Functional retrieve an updated list from the device.