Cross Platform
Test Cloud


This tutorial illustrates the installation paths for purchased and evaluation copies of Xamarin.iOS, as well as the steps required to provision an iOS device for development.

Installing and Configuring Xamarin.iOS


The Xamarin unified installer will automatically detect, download, and install any Xamarin components required for completing the installation. This tutorial examines the installation and configuration steps required to install the Xamarin platform, and to get our development environment setup and configured for deployment.

Required Components

To build for iOS, you'll need the latest iOS SDK (currently iOS 8.1), which ships with Xcode 6.1 and requires Mac OSX 10.9.4+ (Mavericks) or 10.10 (Yosemite). You can download the latest Xcode from the iOS Developer Center (login required), or the Mac App Store:

Downloading the Xamarin Installer

Your first step is to download the Xamarin installer, which can be found at

Running the Xamarin Installer

Open the installer *.dmg file, and run the installer by double-clicking it:

Step 1- Identifying the Required Components


The first step required by the installer is to inspect the system to determine which, if any, required components are missing and need to be downloaded and installed:

The Xamarin installer should automatically inherit from the system network proxy settings for the active network interface. To manually configure the proxy open Application > System and select the Network icon. Then select the appropriate network interface and click the Advanced button. Finally, set the configuration values in the Proxies tab:

Step 2 - Installing the Components

After identifying missing components, the Xamarin installer downloads and executes the installers for the platform dependencies, as shown in this dialog:

Be aware that during this part of the installation, you may be prompted to elevate the permissions necessary for individual components that are needed to complete installation.

Step 4 - Completing the Installation

To begin developing a Xamarin.iOS application targeting the iOS simulator, simply click the Launch Xamarin Studio button. Alternatively, to setup a development device for deployment, click Quit and continue on to the next section:

Step 5 - Activation

As you begin developing, you will be asked to activate your installation. You will see a popover that looks like this:

If you've already purchased your Xamarin products, log in with your Xamarin credentials:

Upon successful activation, you can return to Xamarin Studio. XS will notify you that the activation has been completed, and how many machines are left on your subscription:

If you are running Starter Edition, you may see the activation popover with an added note saying that the project you are trying to compile is too large. At this point will need to either purchase a license or begin a trial if you want to build your project:

Use the second option to start a 30-day free trial of Xamarin Business Edition:

You can see how many days of the trial you have left at any point:

If you're ready to purchase, choose the first option to be redirected to the Xamarin store and checkout.


That’s it! Everything should be good to go. Learn about Device Provisioning, or head on over to the Hello, iPhone tutorial to build your first iOS application!