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 10.15 (master)

• Xamarin.iOS 10.99 (xcode9)

• Xamarin.Mac 3.9 (master)

• Xamarin.Mac 3.99 (xcode9)

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-2 : our current stable release branch (XI 10.10 and XM 3.4);

• d15-3 : our pre-release branch (XI 10.12 and XM 3.6);

• xcode9 : our latest bits (XI 10.99 and XM 3.99) with the new APIs introduced with Xcode 9.

• master : our latest bits (XI 10.15 and XM 3.9) that will eventually become the next releases;

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.