System Requirements | What's New | Known Issues | Blogs | Open Source

Installing

Requirements

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

Feedback

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

Release History

This release of Xamarin.iOS will follow shortly after the official release of Xcode 9.2 by Apple.

  • December 4th, 2017 - Xamarin.iOS 11.6.1.2

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

December 4th, 2017 - Xamarin.iOS 11.6.1.2

This version is included in the Visual Studio 2017 version 15.5.1 release.

Integrated Mono Features/Fixes

Xamarin.iOS uses a customized runtime and base class librairies (BCL) from Mono 5.4 (950ea65c3ba).

Additional information can be found in Mono release notes.

What's New in this Release

This release is built upon our open sourced SDK and is based on our upcoming Xamarin.iOS 11.4 release (d15-5).

Support for Xcode 9.2

Our tooling (e.g. simulator and device support) was updated to ensure compatibility with the latest libraries.

Additional information can be found in Xcode release notes.

New API for iOS 11.2, tvOS 11.2 and watchOS 4.2

There were very few changes, split across most frameworks, in the SDKs. Bindings for the following frameworks have been updated for iOS 11.2, tvOS 11.2 and watchOS 4.2:

  • AVFoundation
  • AVKit
  • Contacts
  • CoreAnimation (QuartzCore)
  • CoreBluetooth
  • CoreML
  • HealthKit
  • HomeKit
  • Intents
  • LocalAuthentication
  • MediaPlayer
  • PassKit
  • PDFKit
  • ReplayKit
  • SceneKit
  • StoreKit, adding Introductory Pricing for Auto-Renewable Subscriptions
  • UIKit
  • WatchKit

Additional information can be found in iOS, tvOS and watchOS release notes.

New API for iOS 11, tvOS 11 and watchOS 4

Additional API from Xcode 9 are also included in this release, in particular:

  • CoreImage filters
    • CIAreaMinMaxRed
    • CIAttributedTextImageGenerator
    • CIBarcodeGenerator
    • CIBicubicScaleTransform
    • CIBlendWithBlueMask
    • CIBlendWithRedMask
    • CIBokehBlur
    • CIColorCubesMixedWithMask
    • CIColorCurves
    • CIDepthBlurEffect
    • CIDepthToDisparity
    • CIDisparityToDepth
    • CIEdgePreserveUpsampleFilter
    • CILabDeltaE
    • CIMorphologyGradient
    • CIMorphologyMaximum
    • CIMorphologyMinimum
    • CITextImageGenerator
  • Bindings for Security.framework
  • Bindings for MetalPerformanceShaders.framework

Known Issues

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 requires workarounds, e.g.:

  • The static registrar requires Xcode headers files to build applications, leading to MT0091 or MT4109 errors if API are 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 the Xamarin.iOS 11.4 stable release:

Open Source

Xamarin.iOS is based on the following open-source repositories: * xamarin-macios branch xcode9.2 * mono branch d15-5-2017-06

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.