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.
Requirements
- 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. 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 11.12.0.4
- May 10, 2018 - Xamarin.iOS 11.12.0.1
- April 16, 2018 - Xamarin.iOS 11.9.2.29
You can learn more about how we ship our releases in the Visual Studio 2017 Release Rhythm document.
May 30, 2018 - Xamarin.iOS 11.12.0.4
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 11.12.0.1
This version is an out-of-band preview of
d15.7
with support for Xcode 9.4 beta 2.
April 16, 2018 - Xamarin.iOS 11.9.2.29
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
orMT4109
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.
Feedback welcome
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:
- xamarin-macios branch
d15-7
- mono branch
2017-12