Xamarin - Documentation

iOS

change platform

  1. Xamarin
  2. iOS
  3. Getting Started
  4. Installation

Installation

Installing and Configuring MonoTouch

Brief

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

Related Articles:

Introduction to MonoTouch

Hello, iPhone

Related Apple Documentation:

Creating Development Provisioning Profiles

Provisioning Using Organizer

Provisioning Using Portal

Overview

The MonoTouch 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 MonoTouch platform, and to get our development environment setup and configured for deployment.

Required Components

MonoTouch is supported on Mac OS 10.6 (“Snow Leopard”) and Mac OS 10.7 (“Lion”)

MonoTouch requires the iOS 5 SDK bundled with Xcode 4. If you are a registered Apple iOS Developer you can download Xcode 4 from the iOS Developer Center (login required). Alternatively, users can download Xcode 4 from the Mac App Store:

xcode_appstore.png

Downloading the MonoTouch Installer

Your first step is to download the MonoTouch installer, which can be found at http://xamarin.com/trial:

download_evaluation.png

If you’ve purchased copy of MonoTouch and need to download the full version, please use the download instructions provided in the email you received with your purchase. Alternatively, the full version of the MonoTouch installer package is available on the Xamarin store products page. Once logged in, click Show Recent Releases and select an installation package to download:

recent_releases.png

Running the MonoTouch Installer

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

monotouch_installer_taken_from_word.png

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:

required_components.png

The MonoTouch installer should automatically inherit from the system network proxy settings for the active network interface. To manually configure the proxy open Application > System Preferences.app 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:

set_webproxy.png

Step 2 - Installing the Components

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

download_components.png

During this part of the installation, you may be prompted to elevate the permissions necessary for individual components that are needed to complete installation, for example:

elevate_permissions.png

Step 4 - Activating the Installation

If you’ve purchased a copy of MonoTouch, you will need to activate it before proceeding. If you do not have network access from your computer, you can perform an offline activation and then restart the installation process. If you do have a network connection complete installation using the activation form below:

Installation_activation_form.png

Fill in the appropriate activation information and activation code provided via email.Then click the Activate button to complete activation:

activation_complete.png

Step 5 - Completing the Installation

 

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

installation_complete.png

Summary

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!