Xamarin.iOS 11.12 Release Notes

Getting Started | What's New | Known Issues | Blogs | Feedback | Open Source

This version of Xamarin.iOS corresponds to our xcode9.4 (xcode9.4) milestone and is based on our previous stable d15-7 released, Xamarin.iOS 11.10.x.


  • The latest features and API requires Xcode 9.4 and the bundled iOS, tvOS and watchOS SDKs
  • Apple Xcode 9.4 requires a Mac running OSX 10.13.2 (High Sierra) or newer

What's New in this Release

ClassKit API

ClassKit is the major reason for Xcode 9.4 and iOS 11.4. This preview adds complete bindings for the API provided in the ClassKit framework.

In order to develop ClassKit-enabled applications, you'll need extra resources, e.g. Schoolwork, from Apple. You can request access using this form. More information about testing ClassKit-enabled application can be found in the ClassKit documentation.

Building ClassKit-enabled applications also requires enabling a capability and a special entitlement. Our existing (stable) versions of Visual Studio (Windows and Mac) do not support this yet. See the Known Issues section for details and workaround.

For reference you can also look at our C# port of Apple's IncorporatingClassKitIntoAnEducationalApp sample on github.

Support for Xcode 9.4

The SDK tooling has been updated to

  • Support the new OS from simulators: iOS 11.4 and tvOS 11.4
  • Support launching to devices

As usual for beta software please make sure to read the Xcode, operating system (iOS, tvOS, and watchOS) release notes to learn about known issues and workarounds.

Release History

This version of Xamarin.iOS corresponds to our 15.7 (d15-7) milestone.

  • May 30, 2018 - Xamarin.iOS
  • May 10, 2018 - Xamarin.iOS
  • April 16, 2018 - Xamarin.iOS

You can learn more about how we ship our releases in the Visual Studio 2017 Release Rhythm document.

May 30, 2018 - Xamarin.iOS

This version is an updated of d15.7 with support for the final version of Xcode 9.4.

Issues Fixed

  • 3882 - [mtouch] Properly link with BusinessChat framework

May 10, 2018 - Xamarin.iOS

This version is an out-of-band preview of d15.7 with support for Xcode 9.4 beta 2.

April 16, 2018 - Xamarin.iOS

This version is an out-of-band preview of d15.6 with support for Xcode 9.4 beta 1.

Known Issues

ClassKit Entitlements

ClassKit-enabled applications must be built with a special entitlement. Until the new release of Visual Studio (Windows or Mac) is available you must configure this manually. Complete instructions on how to add this entitlement are available on this GitHub issue.

Using an older Xcode version

Using an older Xcode version (than the one mentioned in the above requirements) is often possible, but some features may not be available. Also, some limitations might require workarounds, e.g.:

  • The static registrar requires Xcode headers files to build applications, leading to MT0091 or MT4109 errors if API is missing. In most cases enabling the managed linker will help (by removing the API).
  • Bitcode builds (for tvOS and watchOS) can fail submission to the App Store unless an Xcode 9.0+ toolchain is used.

API Diff

The following documents contains a complete list of the API changes since our XI 11.10 release:

This is a live document so there's no static list to link to. However, our Jenkins bots produce this information for every commit that is being built. Pick a build based on master and look for the API diff link in the left column.


Your feedback is important to us. If there are any problems with this release, check the Xamarin.iOS Forums and Xamarin Mac/iOS Github Repository for existing issues. If you do not find any matching issue, please feel free to start a new discussion and report an issue.

Open Source

Xamarin.iOS is based on the following open-source repositories: