Category Archives: Xamarin.iOS

Technical Bulletin: Xcode 8.3 Support for VS 2017

Update: Visual Studio 2017 (26228.12) from March 31 includes Xamarin Xcode 8.3 support

Be sure to update to Visual Studio 2017 15.0.26228.12 or higher via the Tools > Extensions and Updates menu to get Xcode 8.3 compatibility for the Xamarin extensions.


Old alternate manual update steps (from March 28)

With the release of Visual Studio 2017 and the new Visual Studio Installer, there were some changes to how the Xamarin extensions for Visual Studio get installed and updated. In VS 2017, Xamarin updates will now generally be published as an integrated part of the Visual Studio Product Updates in the Extensions and Updates menu. However, the Visual Studio Product Update from earlier today (26228.10) does not yet include Xamarin’s Xcode 8.3 support. Xcode 8.3 support will instead be included in a Visual Studio Product Update for the final versions of Xamarin 15.1, which are coming soon.

In the interim, we are providing downloadable versions of the Xamarin.VisualStudio and Xamarin.iOS extensions for VS 2017 that support Xcode 8.3.  In order to use these versions, please download them from the respective links below, and follow these instructions:

  1. If by chance either file downloads with a “.zip” extension in your browser, rename it back to “.vsix” (for example after enabling the  View > File name extensions checkbox in Windows Explorer).
  2. Shut down all instances of VS 2017 currently running.  We suggest you also close any instances of VS 2015 or 2013 as well.
  3. Double click the Xamarin.VisualStudio VSIX file.
  4. A pop up window with a number of checkbox options will appear. Select only the Visual Studio 2017 checkboxes. Be sure to un-check any checkboxes present for Visual Studio 2015 and lower. Then click the install button.
  5. Once installation of the Xamarin.VS VSIX file has fully completed, repeat steps 2 & 3 for the Xamarin.Apple.Sdk VSIX file.
  6. Once installation of both Xamarin.VS and Xamarin.iOS are complete, restart VS 2017, and confirm the new Xamarin and Xamarin.iOS extensions are installed by checking the versions listed in Help > About Microsoft Visual Studio.

If you see a behavior that looks suspicious in these versions, and if it isn’t clear whether one of the known issues in the release notes matches the problem, please file a quick bug report to let the team know.

If you notice an error in this blog post or have trouble downloading one of the installer packages, please let us know in the corresponding forum thread.


Products Released


Uninstalling this Update from Visual Studio 2017

In the event that these versions need to be uninstalled, the Visual Studio Installer can be used to accomplish this. Read the uninstalling Xamarin guide for more information.

Note that uninstalling these manually installed VSIX files through this process will fully remove the Xamarin.VisualStudio extension from VS 2017. You will need to re-install the Xamarin component through the Visual Studio Installer to restore the previous Xamarin 4.3.0.784 version in VS 2017.

Stable Release: Cycle 9 SR0 with Xcode 8.3 Support

We are releasing an update to our current stable builds of Xamarin Studio, Xamarin for Visual Studio, and Xamarin.iOS. These new builds offer Xcode 8.3 support, for the Xamarin.iOS SDK and the Xamarin iOS Designer. In addition, we have addressed an intermittent NullReferenceException crash that could occur when canceling NSUrlSessionHandler HttpClient.SendAsync() requests via CancellationTokenSource.Cancel() in iOS projects (53794).

For Visual Studio 2017 users, be sure to update to Visual Studio 2017 15.0.26228.12 or higher to get the new versions of the Xamarin extensions.

If you see a behavior that looks suspicious in these versions, and if it isn’t clear whether one of the known issues in the release notes matches the problem, please file a quick bug report to let the team know.

If you notice an error in this blog post or have trouble downloading one of the installer packages, please let us know in the corresponding forum thread.


Known Issues

For a list of known issues, please refer to the Release Notes for the appropriate product.


Products Released


Upgrading and Downgrading

You can install this new version by checking for updates on the Stable updater channel.

For Visual Studio 2017 users, be sure to complete the manual update steps on the corresponding blog post.

You can downgrade back to the previous Cycle 9 Service Release Stable versions by manually reinstalling each old package. See the KB article on downgrading. If you would prefer an email with any older installer links you need, feel free to write to contact@xamarin.com to request the older versions.

  • For Mac you’ll need: Xamarin Studio and Xamarin.iOS.
  • For Windows you’ll need: Xamarin.VisualStudio (from either the Xamarin.Android or Xamarin.iOS drop-down menu).

Technical Bulletin: Xcode 8.3

As announced on Apple’s developer news site, Apple has just released Xcode 8.3 final.

Xamarin is proceeding as usual to test for compatibility and publish an updated version of Xamarin.iOS for any modified or new APIs in Xcode. Keep an eye on this blog for status updates.

UPDATE March 28: Corresponding new versions of Xamarin.iOS, Xamarin for Visual Studio, and Xamarin Studio are now available. See the release announcement for additional details.

Beta Release: 15.1 Beta Preview 2

We are releasing the final Beta preview of our next major release, called 15.1. This release uses a new naming convention “15.1” that more closely resembles the sub-version numbering of Visual Studio 2017. “15.1” in this new scheme matches up with what Xamarin would have called “Cycle 10” under the old scheme.

This release is now available in the Xamarin updater channels and as part of the March 27 update for Visual Studio Preview. Note that the Xamarin version number in Visual Studio 2015 is slightly ahead of the version number in Visual Studio Preview in order to provide early availability of a few additional fixes. Xamarin coordination with the upstream schedule has been evolving across the VS 2017 releases, and plans are underway to synchronize more tightly as soon as possible. Watch for additional news on that topic as the 15.1 release moves into the Stable channel in the upcoming weeks.

Among other changes, these versions include a new experimental Concurrent Garbage Collector option for both Xamarin.Android and Xamarin.iOS.

As this is a Beta build, there are some known issues and the possibility of new issues being found during testing. Of course, additional bug reports are still welcome for these preview versions. If you see any suspicious behavior that you wish to report, please file a quick bug.

If you notice an error in this blog post or have trouble downloading one of the installer packages, please let us know in the corresponding forum thread.

Please check out the product release notes to see all the fixes and known issues for this release.


Products Released


Installing the Beta and switching back to Stable

You can install this new Beta version or switch back to the current Stable version by changing updater channels.


Upcoming Release Dates

Alpha 1 – March 1st 2017

Alpha 2 – March 7th 2017

Beta 1 – March 16th 2017

Beta 2- This Release!

Beta Release: 15.1 Beta Preview 1

We are releasing the first Beta preview of our next major release, called 15.1. This release uses a new naming convention “15.1” that more closely resembles the sub-version numbering of Visual Studio 2017. “15.1” in this new scheme matches up with what Xamarin would have called “Cycle 10” under the old scheme.

Note that this preview release is not yet available in Visual Studio 2017. It will be integrated into the Visual Studio Installer at a future date that follows the upstream VS 2017 release schedule. Xamarin coordination with the upstream schedule has been evolving across the VS 2017 releases, and plans are underway to synchronize more tightly as soon as possible. Watch for additional news on that topic over the next week.

As this is a Beta build, there are some known issues and the possibility of new issues being found during testing. Of course, additional bug reports are still welcome for these preview versions. If you see any suspicious behavior that you wish to report, please file a quick bug.

If you notice an error in this blog post or have trouble downloading one of the installer packages, please let us know in the corresponding forum thread.

Please check out the product release notes to see all the fixes and known issues for this release.


Products Released


Installing the Beta and switching back to Stable

You can install this new Beta version or switch back to the current Stable version by changing updater channels.


Upcoming Release Dates

Alpha 1 – March 1st 2017

Alpha 2 – March 7th 2017

Beta 1 – This Release!

Service Release: Cycle 9

We are publishing a service release for Cycle 9 to our Beta and Stable channels.

Please check out the product release notes to see all the fixes and known issues for this release.

Note that this release is not yet available in Visual Studio 2017. For Visual Studio 2017 users, the next available Xamarin update in the Visual Studio Installer will combine the fixes from this service release with the features from the current 15.1 Alpha Preview. Watch for more news on that update within the week.

If you see a behavior that looks suspicious in these versions, and if it isn’t clear whether one of the known issues in the release notes matches the problem, please file a quick bug report to let the team know.

If you notice an error in this blog post or have trouble downloading one of the installer packages, please let us know in the corresponding forum thread.


Known Issues

For a list of known issues, please refer to the Release Notes for the appropriate product.


Products Released


Upgrading and Downgrading

You can install this new version by checking for updates in the Stable updater channel.

You can downgrade back to the previous Cycle 9 Stable versions by manually reinstalling each old package. See the KB article on downgrading. If you would prefer an email with any older installer links you need, feel free to write to contact@xamarin.com to request the older versions.

  • For Mac you’ll need: Xamarin Studio, Xamarin.iOS, Xamarin.Android, Mono, and optionally the Xamarin Profiler.
  • For Windows you’ll need: Xamarin.VisualStudio (from either the Xamarin.Android or Xamarin.iOS drop-down menu), optionally Xamarin Studio, and optionally the Xamarin Profiler.

Older Mono package versions are not currently listed on https://store.xamarin.com/account/my/subscription/downloads. The Mono package for the previous Stable version (from Cycle 9) is available here:


Upcoming Release Dates

Stable – Feb 22nd 2017

SR0 – This Release!

Alpha Release: 15.1 Alpha Preview 2

We are releasing the second Alpha preview of our next major release, called 15.1. As this is an Alpha build, there are some known issues and the possibility of new issues being found during testing.

Of course, additional bug reports are still welcome for these preview versions. If you see any suspicious behavior that you wish to report, please file a quick bug.

If you notice an error in this blog post or have trouble downloading one of the installer packages, please let us know in the corresponding forum thread.

Please check out the product release notes to see all the fixes and known issues for this release.


Products Released


Installing the Alpha and switching back to Stable

You can install this new Alpha version or switch back to the current Stable version by changing updater channels.


Upcoming Release Dates

Alpha 1 – 03/02/2017

Alpha 2 – This Release!

Alpha Release: 15.1 Alpha Preview 1

We are releasing the first Alpha preview of our next major release, called 15.1. As this is an Alpha build, there are some known issues and the possibility of new issues being found during testing.

Of course, additional bug reports are still welcome for these preview versions. If you see any suspicious behavior that you wish to report, please file a quick bug.

If you notice an error in this blog post or have trouble downloading one of the installer packages, please let us know in the corresponding forum thread.

Please check out the product release notes to see all the fixes and known issues for this release.


Products Released


Installing the Alpha and switching back to Stable

You can install this new Alpha version or switch back to the current Stable version by changing updater channels.


Upcoming Release Dates

Alpha – This Release!

Stable Release: Cycle 9

We are releasing our next major release, called Cycle 9, to our Stable channels.

Please check out the product release notes to see all the fixes and known issues for this release.

Please note that if you wish to use Xamarin.VS with VS 2012, you should not install this build, as it will overwrite that version on your machine.

If you see a behavior that looks suspicious in these versions, and if it isn’t clear whether one of the known issues in the release notes matches the problem, please file a quick bug report to let the team know.

If you notice an error in this blog post or have trouble downloading one of the installer packages, please let us know in the corresponding forum thread.


Known Issues

For a list of known issues, please refer to the Release Notes for the appropriate product.


Products Released


Upgrading and Downgrading

You can install this new version by checking for updates on the Stable updater channel.

You can downgrade back to the previous Cycle 8 Stable versions (from before February 22, 2017) by manually reinstalling each old package. See the “Get the latest stable version of Cycle 8” section on your account page: https://store.xamarin.com/account/my/subscription/downloads#cycle8. (If you do not yet have a Xamarin login, you can create one.) If you have any trouble downloading the previous versions from that link, would like to install an even earlier set of versions, or simply would prefer an email with all the installer links you need, feel free to email contact@xamarin.com.


Upcoming Release Dates

RC 1 – 01/10/2017

RC  2 – 01/18/2017

RC 3 – 01/24/2017

RC 4 – 01/31/2017

RC 5 – 02/07/2017

RC 6 – 02/14/2017

Stable – This Release!

Release Candidate: Cycle 9 RC Refresh

We are refreshing our RC builds in the Beta channel for our next major release, called Cycle 9.

As this is an RC build, there are some known issues and the possibility of new issues being found during testing. Please check out the product release notes to see all the fixes and known issues for this release.

Please note that if you wish to use Xamarin.VS with VS 2012, you should not install this RC build, as it will overwrite that version on your machine.

If you see a behavior that looks suspicious in these versions, and if it isn’t clear whether one of the known issues in the release notes matches the problem, please file a quick bug report to let the team know.

If you notice an error in this blog post or have trouble downloading one of the installer packages, please let us know in the corresponding forum thread.


Known Issues

For a list of known issues, please refer to the Release Notes for the appropriate product.


Products Released


Installing the RC and switching back to Stable

You can install this new RC version or switch back to the current Stable version by changing updater channels.


Upcoming Release Dates

RC 1 – 01/10/2017

RC  2 – 01/18/2017

RC 3 – 01/24/2017

RC 4 – 01/31/2017

RC 5 – 02/07/2017

RC 6 – This Release!

Stable – Soon!