Sebastien Pouliot edited this page Apr 3, 2018 · 56 revisions

The xamarin-macios wiki is where we keep our documents (release notes, Xcode diff, etc) about Xamarin.iOS & Xamarin.Mac.


You already reached our wiki! So you might already know that Xamarin's SDK are open sourced and that you can contribute to them. Some useful resources to help you are:

Those resources are exclusively available to help you contributing to the Xamarin.iOS/Mac SDKs.

Release Notes

Here we keep the initial drafts for release notes based on our main work (on master) or in special branches, e.g. xcode8 tracked the API and tooling changes to support iOS 10, tvOS 10, watchOS 3 and macOS 10.12.

Found a typo ? an undocumented new feature ? or a missing bug fix reference ? just create a PR and we'll merge it after review.

Release notes for published versions (alpha / beta or stable channels) can be found on our web site:

Continuous Builds

You can now download Xamarin.iOS and Xamarin.Mac packages directly from our build bots. They are provided as-is and no QA or other validations were done on those builds (e.g. builds that failed internal tests are also published)

  • d15-6 : our current stable releases branch for macOS (XM 4.2);

  • xcode9.3 : our current stable releases branch for iOS (XI 11.9) with the new APIs introduced with Xcode 9.3;

  • xcode9.4 : our latest bits (based on XI 11.9) with the new APIs introduced with Xcode 9.4

  • d15-7 : our preview releases branch for iOS (XI 11.10) and macOS (XM 4.4);

  • master : our latest bits (XI 11.11 and XM 4.5) that will eventually become the next releases (15.8);

You can learn more about our milestones (15.x) and how we ship our releases in the Visual Studio 2017 Release Rhythm document.

Downloading a specific build

If you go to our commits page you should be able to see a green checkmark (✔) or a red cross mark (✘) at the right side of the committer's handle. If you click the green checkmark (✔) you should see a details link which will provide download links for both Xamarin.iOS and Xamarin.Mac packages for that specific commit.

Pro tip: If for some reason the Continuous Builds (above) links are out of date, you can use the branch switcher found inside the commits page to select the desired release milestone and download from the latest commit with a green checkmark (✔).


This document regroups different advice that are useful when writing bindings and explain our release process and tools.

When a new version of Xcode comes out, we run a diff tool to see the changes. The results then becomes wiki pages and these are the documents we use to add or update our bindings. As changes can be pretty massive, we need to split the work between Xamarin iOS/macOS team members and our lovely contributors.

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.