Home

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

Contributing

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:

• our mailing list: you can subscribe or read the archives;
• our gitter channel

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.

• Xamarin.iOS 11.9 (d15-7)

• Xamarin.iOS 11.11 (master)

• Xamarin.Mac 4.3 (d15-7)

• Xamarin.Mac 4.5 (master)

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:

• Xamarin.iOS Release Notes
• Xamarin.Mac Release Notes

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 iOS (XI 11.8) and macOS (XM 4.2);

• xcode9.3 : our latest bits (based on XI 11.8) with the new APIs introduced with Xcode 9.3;

• 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 (✔).

Bindings

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.