VISUAL STUDIO   Windows Mac

Xamarin.Forms Requirements

PDF for offline use

Let us know how you feel about this

Translation Quality


0/250

last updated: 2017-05

Platform and development system requirements for Xamarin.Forms.

Refer to the Installation article for an overview of installation and setup practices that apply across platforms.

Target Platforms

Xamarin.Forms applications can be written for the following operating systems:

  • iOS 8 or higher
  • Android 4.0.3 (API 15) or higher (more details)
  • Windows 10 Universal Windows Platform (more details)
  • Windows 8.1 / Windows Phone 8.1 WinRT (more details)
  • Windows Phone 8 Silverlight (DEPRECATED)

It is assumed that developers have familiarity with Portable Class Libraries and Shared Projects.

Android

You should have the latest Android SDK Tools and Android API platform installed. You can update to the latest versions using the Android SDK Manager.

Additionally, the target/compile version for Android projects must be set to Use latest installed platform. However the minimum version can be set to API 15 so you can continue to support devices that use Android 4.0.3 and newer. These values are set in the Project Options:

Build > General

Build > Android Application

Project Options > Application > Application Properties

Universal Windows Platform

Windows 10 UWP projects are not added when a solution is created on macOS. For instructions on how to add these projects to an existing solution, see Adding a Universal Windows Platform (UWP) App.

Windows 8.1 / Windows Phone 8.1 WinRT

Windows 8.1 / Windows Phone 8.1 WinRT projects are not added when a solution is created on macOS. For instructions on how to add these projects to an existing solution, see Adding a Windows Phone App and Adding a Windows App.

Development System Requirements

Xamarin.Forms apps can be developed on macOS and Windows. However, Windows and Visual Studio are required to produce Windows versions of the app.

Mac System Requirements

You can use Visual Studio for Mac to develop Xamarin.Forms apps on OS X El Capitan (10.11) or newer. To develop iOS apps, we reccomended having at least the iOS 10 SDK and Xcode 8 installed.

ℹ️

Windows apps cannot be developed on macOS.

Windows System Requirements

Xamarin.Forms apps for iOS and Android can be built on any Windows installation that supports Xamarin development. This requires Visual Studio 2013 Update 2 or newer running on Windows 7 or higher. A networked Mac is required for iOS development.

There are additional requirements for the following types of Windows apps:

Universal Windows Platform (UWP)

Developing Xamarin.Forms apps for UWP requires:

UWP projects are included in Xamarin.Forms solutions created in Visual Studio 2015 and Visual Studio 2017. You can also add a Universal Windows Platform (UWP) App to an existing Xamarin.Forms solution.

Windows 8.1 and Windows Phone 8.1 WinRT

Developing Xamarin.Forms apps for Windows 8.1 and Windows Phone 8.1 WinRT requires:

  • Windows 8.1

  • Visual Studio 2013 Update 2 or newer

Xamarin Workbook

If it's not already installed, install the Xamarin Workbooks app first. The workbook file should download automatically, but if it doesn't, just click to start the workbook download manually.