Category Archives: Xamarin for Visual Studio

Stable Release: 15.3.5 with Xcode 9 Support

We are releasing an update for our current major release called 15.3 into the Stable channel. This update adds SDK bindings and IDE compatibility for Apple’s Xcode 9 release.

This release is now available as part of Visual Studio 2017 version 15.3.5 and in the Stable updater channels for Visual Studio 2017 for Mac (version 7.1.5.2) and Xamarin for Visual Studio 2015.

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

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.

Bug reports are also welcome. If you see any suspicious behavior that you wish to report, please file a quick bug.


Products Released

  • Xamarin.VisualStudio 4.7.9.45
  • Release Notes
  • Note: This release can be considered part of the Xamarin.VisualStudio 4.6 release series. It only adds IDE compatibility for Xcode 9. It does not yet include the other features from version 4.7.

Intentional Changes

  • [Xamarin.iOS] – “This version of Xamarin.iOS requires the iOS 11.0 SDK (shipped with Xcode 9). Either upgrade Xcode to get the required header files or set the managed linker behaviour to Link Framework SDKs Only (to try to avoid the new APIs).” This message will appear when building using Xcode 8.3 or older with Xamarin.iOS 11. The issue arises because Xamarin.iOS 11 is built to include the Xcode 9 symbols. The Xamarin managed linker can remove these unused symbols to allow building successfully against older versions of Xcode.
    • Fix: Update to Xcode 9, or enable the Xamarin linker by choosing a setting other than Don’t link under Project properties > iOS Build > Linker behavior.

Installing


Previous Versions

Using the latest versions is recommended. The previous versions of the Xamarin and Mono packages from the Xamarin 15.3.4 release are listed below for reference.

Preview: Xcode 9 GM, iOS 11 Support – Preview 9

Today we are releasing the following builds as Xcode 9 Web Preview 9. These versions include preview Xamarin SDK bindings and preview IDE compatibility for Apple’s Xcode 9 GM seed.

Note that these are standalone download links that are not yet published in the Xamarin updater channels. As a result, Visual Studio for Mac will offer “updates” back to the current published updater channel versions when you have these versions installed. You will need to disregard those notifications if you wish to keep using these Xcode 9 support previews. The Xcode 9 features will be added to the Xamarin updater channels in the future, after Apple publishes the first non-preview version of Xcode 9 to the App Store.

Any bug reports about these preview Xamarin bindings are much appreciated!


Products Released

Preview IDE compatibility packages for Mac and Visual Studio 2017

  • Visual Studio for Mac 7.1.3.41
  • Download
  • Visual Studio Tools for Xamarin 4.7.9.37
  • Download (34 KB) for Visual Studio 2017
  • Download for Visual Studio 2015
  • iOS Simulator on Windows 1.1.0.121
  • Download

Note: Updated IDE compatibility packages for Visual Studio on Windows are also in-progress. This post will be updated when they are available. The previous IDE compatibility packages for Windows do not yet include adjustments for the Xcode 9 GM seed.

Update for September 14: The Xcode 9 GM seed IDE compatibility package for Visual Studio 2017 is now available above. This post will be updated again when the IDE compatibility package for Visual Studio 2015 is available.

Update for September 15: The IDE compatibility package for Visual Studio 2015 is now available.


Installing on Mac

  1. Ensure you are up-to-date with the current Xamarin Stable channel versions.
  2. Ensure you have the Xcode 9 GM version installed from Apple. You can optionally install this GM version alongside Xcode 8.
  3. Download the Xamarin.iOS installer .pkg file and run it.
  4. Download the Visual Studio for Mac .dmg file, open it, and copy the .app bundle to a desired install location. For example, you can optionally add this preview version alongside the Stable version of Visual Studio for Mac by copying the .app bundle to a temporary location, renaming it, and then copying it to your Applications directory.

Uninstall steps

Navigate to Visual Studio > Check for Updates, and install the current Xamarin.iOS and Visual Studio for Mac versions from the Stable updater channel.


Installing IDE compatibility for Visual Studio 2017 version 15.3.4

  1. Ensure that Visual Studio 2017 is up-to-date at version 15.3.4 and has the Mobile development with .NET workload installed.
  2. Download the combined IDE compatibility .vsix file. If your web browser saves the file with a .zip extension, rename it back to .vsix after download.
  3. Double-click the .vsix file to launch the VSIX Installer.
  4. Be sure to select only your non-preview instance of Visual Studio 2017 when prompted. (This .vsix package is based on the Xamarin 15.3.4 release, so it is not fully compatible with Visual Studio 2017 version 15.4 Preview.)
  5. Click Install, and wait for the VSIX Installer to download and install the components.

Uninstall steps

If you wish to switch back from the Xcode 9 support previews to the default Xamarin versions bundled in Visual Studio 2017 version 15.3.4:

  1. Navigate to Tools > Extensions and Updates >  Installed.
  2. Locate the Visual Studio Tools for Xamarin (Alpha) item.
  3. Click the Uninstall button.
  4. Close Visual Studio 2017 to allow the VSIX Installer to launch and complete the uninstall process.

Installing IDE compatibility for Visual Studio 2015

Download and run the Xamarin.VisualStudio .msi installer package.

Uninstall steps

Navigate to Tools > Options > Xamarin > Other > Check Now, and install the current Xamarin version from the Stable updater channel.


Known Issues

There are at least a couple of known changes between the previous Xcode 9 beta and the Xcode 9 GM seed that are not yet resolved in this preview:

  • [Visual Studio for Mac, Xamarin.iOS] – iOS simulators do not start as expected after the user launches an app on one simulator and then switches to deploy to a different simulator.
    • Possible temporary workaround:  Close and reopen the solution or quit and reopen Visual Studio for Mac.
  • [Visual Studio for Mac, Xamarin.iOS] – “Invalid Image Asset” and “Missing Image Asset” when attempting to submit tvOS apps to App Store.
    • Possible temporary workaround: Manually edit the asset catalog in a text editor to add the entries for the new required image assets.

Xamarin.Mac previews for macOS 10.13 beta 9

Since macOS 10.13 itself is still in beta rather than GM at this time, if you would like to try the preview macOS 10.13 APIs in Xamarin.Mac, please see:

Stable Release: 15.3.4 Servicing Release

We are releasing a service release for our current major release called 15.3 into the Stable channel.

This release is now available as part of Visual Studio 2017 version 15.3 and in the Stable updater channels for Visual Studio 2017 for Mac and Xamarin for Visual Studio 2015.

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

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.

Bug reports are also welcome. If you see any suspicious behavior that you wish to report, please file a quick bug.


Products Released


Included Fixes

This release focuses on a few issues from the Xamarin 15.3 release:

  • 58226 (non-public) [Xamarin iOS Designer] – “MonoTouch.Design.Client.DesignerRemoteException: System.NotSupportedException: Could not parse xml” when attempting to open a storyboard or .xib file, for example after editing the file with Xcode.
  • Developer Community 89863 [Visual Studio for Mac, Xamarin.iOS] – Crash when attempting to access Preferences > Apple Developer Accounts when Xamarin.Mac is not installed.
  • 58829 [Xamarin.Android, Xamarin.iOS] – Application Output window flooded with “[Mono] worker parking, [Mono] worker unparking” messages when debugging with Android Emulator.
  • 58778 [Xamarin.iOS, Xamarin Profiler] – Xamarin.iOS profiling is unsuccessful when Strip native debugging symbols is enabled.

Other Common Issues from the Xamarin 15.3 Release

In case it might also be useful for reference, here are some other in-progress commonly seen issues being tracked by the Xamarin team from the Xamarin 15.3 release. This list is not exhaustive: It does not include every issue user-submitted issue reported since the time of the Xamarin 15.3 release.

  • 59036 [Xamarin.Android] – ClassNotFoundException when building and running app with Multi-Dex enabled due to missing newline characters in generated multidex.keep file.
    • Possible temporary workaround: Copy the generated multidex.keep file from the obj directory into the top level of the Android app project, add a newline character after each “.class” string, set the build action of the file to MultiDexMainDexList, and rebuild the app.

Installing


Previous Versions

Using the latest versions is recommended. The previous versions of the Xamarin and Mono packages from the Xamarin 15.3 release are listed below for reference.

Beta Release: 15.4 Beta 1

We are releasing the third preview of our next major release, called 15.4. This release includes our next preview of Visual Studio for Mac.

Note that in this release of Visual Studio for Mac, the Azure Functions and Xamarin IoT preview features are disabled. These preview features are now available separately via the extension gallery. See the steps under Preview Capabilities on the corresponding Visual Studio blog post for details on how to enable those features.

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

You can switch back to the non-preview versions at any time by launching your side-by-side non-preview installation of Visual Studio 2017 and switching to the Stable updater channel in Visual Studio for Mac and Visual Studio 2015 Tools for Xamarin.


15.4 Release Dates

Preview 1 – Aug 2nd 2017

Preview 2 – Aug 28th 2017

Preview 3 – This Release!

Preview: Xcode 9 Beta 6, iOS 11, MacOS 10.13 Support – Preview 8

Today we are releasing the following builds as Xcode 9 Web Preview 8. These versions include preview Xamarin SDK bindings and preview IDE compatibility for Apple’s Xcode 9 beta 6 release.

Note that these are standalone download links that are not published in the Xamarin updater channels. As a result, Visual Studio for Mac and Visual Studio 2015 on Windows will offer “updates” back to the current published updater channel versions when you have these versions installed. You will need to disregard those notifications if you wish to keep using these Xcode 9 support previews. The Xcode 9 features will be added to the Xamarin updater channels in the future, after Apple publishes the first non-preview version of Xcode 9 to the App Store.

Any bug reports about these preview Xamarin bindings are much appreciated!


Products Released

Preview IDE compatibility packages for Mac and Visual Studio 2015

  • Visual Studio for Mac 7.1.0.1287
  • Download
  • Visual Studio Tools for Xamarin 4.7.9.3 (Visual Studio 2015)
  • Download
  • iOS Simulator on Windows 1.1.0.121
  • Download

Preview IDE compatibility installation steps for Visual Studio 2017 Preview

  • Visual Studio Tools for Xamarin 4.7.9.3 (for Visual Studio 2017 Preview)
  1. Ensure that you have Visual Studio 2017 Preview installed with the Mobile development with .NET workload. (Note that Visual Studio 2017 Preview installs as an additional version alongside your existing Visual Studio 2017 non-preview version.)
  2. Go to Tools > Extensions and Updates…
  3. Open the Online > Visual Studio Marketplace tab.
  4. Search for Xamarin Updater and press Download
    • Created by: Xamarin
  5. Restart Visual Studio (as instructed).
  6. Go to Tools > Options > Extensions and Updates.
  7. Click the Add button next to the Additional Extension Galleries list.
  8. Under the Name field enter Xamarin Xcode 9 Preview (or another name that you prefer).
  9. Under the URL field type in xvs://xcode9-preview/
  10. Click OK to save the changes.
  11. Navigate to Tools > Extensions and Updates > Updates > Xamarin Xcode 9 Preview and press Update for each item to download all the available updates.
  12. Once all of the downloads are complete, close Visual Studio.  The VSIX Installer program will launch automatically to install the components.
  13. Start Visual Studio again.

Uninstall steps for Visual Studio 2017 Preview

If you wish to switch back from the Xcode 9 support previews to the default Xamarin versions bundled in Visual Studio 2017 Preview, use the Visual Studio Installer to un-install, and then re-install, the Mobile development with .NET (Xamarin) workload.

Preview: Xcode 9 Beta 6, iOS 11, MacOS 10.13 Support – Preview 7

Today we are releasing the following builds as Xcode 9 Web Preview 7. These versions include preview Xamarin SDK bindings and preview IDE compatibility for Apple’s Xcode 9 beta 6 release.

Note that these are standalone download links that are not published in the Xamarin updater channels. As a result, Visual Studio for Mac and Visual Studio 2015 on Windows will offer “updates” back to the current published updater channel versions when you have these versions installed. You will need to disregard those notifications if you wish to keep using these Xcode 9 support previews. The Xcode 9 features will be added to the Xamarin updater channels in the future, after Apple publishes the first non-preview version of Xcode 9 to the App Store.

Any bug reports about these preview Xamarin bindings are much appreciated!


Products Released

Preview IDE compatibility packages for Mac and Visual Studio 2015

  • Visual Studio for Mac 7.1.0.1285
  • Download
  • Xamarin.VS 4.7.9.0 (Visual Studio 2015)
  • Download
  • iOS Simulator on Windows 1.1.0.121
  • Download

Preview IDE compatibility installation steps for Visual Studio 2017 Preview

  • Xamarin.VS 4.7.9.0 (for Visual Studio 2017 Preview)
  1. Ensure that you have Visual Studio 2017 Preview installed with the Mobile development with .NET workload. (Note that Visual Studio 2017 Preview installs as an additional version alongside your existing Visual Studio 2017 non-preview version.)
  2. Go to Tools > Extensions and Updates…
  3. Open the Online > Visual Studio Marketplace tab.
  4. Search for Xamarin Updater and press Download
    • Created by: Xamarin
  5. Restart Visual Studio (as instructed).
  6. Go to Tools > Options > Extensions and Updates.
  7. Click the Add button next to the Additional Extension Galleries list.
  8. Under the Name field enter Xamarin Xcode 9 Preview (or another name that you prefer).
  9. Under the URL field type in xvs://xcode9-preview/
  10. Click OK to save the changes.
  11. Navigate to Tools > Extensions and Updates > Updates > Xamarin Xcode 9 Preview and press Update for each item to download all the available updates.
  12. Once all of the downloads are complete, close Visual Studio.  The VSIX Installer program will launch automatically to install the components.
  13. Start Visual Studio again.

Uninstall steps for Visual Studio 2017 Preview

If you wish to switch back from the Xcode 9 support previews to the default Xamarin versions bundled in Visual Studio 2017 Preview, use the Visual Studio Installer to un-install, and then re-install, the Mobile development with .NET (Xamarin) workload.

Preview: Xcode 9 Beta 6, iOS 11, MacOS 10.13 Support – Preview 6

Today we are releasing the following builds as Xcode 9 Web Preview 6. These versions include preview Xamarin SDK bindings and preview IDE compatibility for Apple’s Xcode 9 beta 6 release.

Note that these are standalone download links that are not published in the Xamarin updater channels. As a result, Visual Studio for Mac and Visual Studio 2015 on Windows will offer “updates” back to the current published updater channel versions when you have these versions installed. You will need to disregard those notifications if you wish to keep using these Xcode 9 support previews. The Xcode 9 features will be added to the Xamarin updater channels in the future, after Apple publishes the first non-preview version of Xcode 9 to the App Store.

Any bug reports about these preview Xamarin bindings are much appreciated!


Products Released

Preview IDE compatibility packages for Mac and Visual Studio 2015

  • Visual Studio for Mac 7.1.0.1283
  • Download
  • Xamarin.VS 4.6.0.357 (Visual Studio 2015)
  • Download
  • iOS Simulator on Windows 1.1.0.121
  • Download

Preview IDE compatibility installation steps for Visual Studio 2017 Preview

Note that the Xamarin.VS package version number listed below is too low to install automatically into the latest Visual Studio 2017 version 15.4.0 Preview 1, so the Xcode 9 IDE compatibility preview is not available for that Visual Studio version at this time. A future Xamarin Xcode 9 support preview will address this version number issue to re-enable installation.

  • Xamarin.VS 4.6.0.357 (for Visual Studio 2017 Preview)
  1. Ensure that you have Visual Studio 2017 Preview installed with the Mobile development with .NET workload. (Note that Visual Studio 2017 Preview installs as an additional version alongside your existing Visual Studio 2017 non-preview version.)
  2. Go to Tools > Extensions and Updates…
  3. Open the Online > Visual Studio Marketplace tab.
  4. Search for Xamarin Updater and press Download
    • Created by: Xamarin
  5. Restart Visual Studio (as instructed).
  6. Go to Tools > Options > Extensions and Updates.
  7. Click the Add button next to the Additional Extension Galleries list.
  8. Under the Name field enter Xamarin Xcode 9 Preview (or another name that you prefer).
  9. Under the URL field type in xvs://xcode9-preview/
  10. Click OK to save the changes.
  11. Navigate to Tools > Extensions and Updates > Updates > Xamarin Xcode 9 Preview and press Update for each item to download all the available updates.
  12. Once all of the downloads are complete, close Visual Studio.  The VSIX Installer program will launch automatically to install the components.
  13. Start Visual Studio again.

Uninstall steps for Visual Studio 2017 Preview

If you wish to switch back from the Xcode 9 support previews to the default Xamarin versions bundled in Visual Studio 2017 Preview, use the Visual Studio Installer to un-install, and then re-install, the Mobile development with .NET (Xamarin) workload.

Stable Release: 15.3.2 Servicing Release

We are releasing a service release for our current major release called 15.3 into the Beta and Stable channels.

This release is now available as part of Visual Studio 2017 version 15.3 and in the Stable updater channels for Visual Studio 2017 for Mac and Xamarin for Visual Studio 2015.

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

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.

Bug reports are also welcome. If you see any suspicious behavior that you wish to report, please file a quick bug.


Products Released

  • Xamarin.VisualStudio 4.6.0.299
  • The only change in this version is to update the Xamarin.iOS and Xamarin.Android packages.

Included Fixes

This release targets 4 specific bugs that are the most commonly seen issues in the Xamarin 15.3 release:

  • 58789 and 58834 [Xamarin.iOS] – “error MT0000: Unexpected error – Please file a bug report …” and “error MT2102: Error processing the method … Value cannot be null” when attempting to build certain projects with linking enabled.
  • 57919 and 58625  [Xamarin.Android, Xamarin.iOS] – “System.PlatformNotSupportedException: Operation is not supported on this platform” at System.Runtime.InteropServices.Marshal.IsComObject() when trying to use dynamic types.

Other Common Issues from the Xamarin 15.3 Release

In case it might also be useful for reference, here are a few other in-progress progress commonly seen issues being tracked by the Xamarin team from the Xamarin 15.3 release. This list is not exhaustive: It does not include every issue user-submitted issue reported since the time of the Xamarin 15.3 release.

  • 58226 (non-public) [Xamarin iOS Designer] – “MonoTouch.Design.Client.DesignerRemoteException: System.NotSupportedException: Could not parse xml” when attempting to open a storyboard or .xib file, for example after editing the file with Xcode.
    • Temporary workaround: Open the problematic file as text (for example via the context menu for the file in the Solution window), and then remove the device element from the top of the file. It typically looks something like:
      <device id="retina4_0" orientation="portrait">
          <adaptation id="fullscreen"/>
      </device>
  • 58829 [Xamarin.Android, Xamarin.iOS] – Application Output window flooded with “[Mono] worker parking, [Mono] worker unparking” messages when debugging with Android Emulator.
    • Temporary workaround: Set the MONO_LOG_LEVEL environment variable to message or higher.
      • For example, on Xamarin.Android in a command prompt using adb:
        adb shell setprop debug.mono.env "MONO_LOG_LEVEL=message"
      • For Xamarin.iOS, go to Project Properties > iOS Build > Additional Options > Additional mtouch arguments, and add:
        --setenv:MONO_LOG_LEVEL=message

Installing


Previous Versions

Using the latest versions is recommended. The previous versions of the Xamarin and Mono packages from the Xamarin 15.3 release are listed below for reference.

 

Preview: Xcode 9 Beta 5, iOS 11, MacOS 10.13 Support – Preview 5

Today we are releasing the following builds as Xcode 9 Web Preview 5. These versions include preview Xamarin SDK bindings and preview IDE compatibility for Apple’s Xcode 9 beta 5 release.

Note that these are standalone download links that are not published in the Xamarin updater channels. As a result, Visual Studio for Mac and Visual Studio 2015 on Windows will offer “updates” back to the current published updater channel versions when you have these versions installed. You will need to disregard those notifications if you wish to keep using these Xcode 9 support previews. The Xcode 9 features will be added to the Xamarin updater channels in the future, after Apple publishes the first non-preview version of Xcode 9 to the App Store.

Any bug reports about these preview Xamarin bindings are much appreciated!


Products Released

Preview IDE compatibility packages for Mac and Visual Studio 2015

  • Visual Studio for Mac 7.1.0.1278
  • Download
  • Xamarin.VS 4.6.0.355 (Visual Studio 2015)
  • Download

Preview IDE compatibility installation steps for Visual Studio 2017 Preview

Update for August 24: Note that the Xamarin.VS package version number listed below is too low to install automatically into today’s new Visual Studio 2017 version 15.4.0 Preview 1, so the Xcode 9 IDE compatibility preview is not available for that Visual Studio version at this time. A future Xamarin Xcode 9 support preview will address this version number issue to re-enable installation.

  • Xamarin.VS 4.6.0.355 (for Visual Studio 2017 Preview)
  1. Ensure that you have Visual Studio 2017 Preview installed with the Mobile development with .NET workload. (Note that Visual Studio 2017 Preview installs as an additional version alongside your existing Visual Studio 2017 non-preview version.)
  2. Go to Tools > Extensions and Updates…
  3. Open the Online > Visual Studio Marketplace tab.
  4. Search for Xamarin Updater and press Download
    • Created by: Xamarin
  5. Restart Visual Studio (as instructed).
  6. Go to Tools > Options > Extensions and Updates.
  7. Click the Add button next to the Additional Extension Galleries list.
  8. Under the Name field enter Xamarin Xcode 9 Preview (or another name that you prefer).
  9. Under the URL field type in xvs://xcode9-preview/
  10. Click OK to save the changes.
  11. Navigate to Tools > Extensions and Updates > Updates > Xamarin Xcode 9 Preview and press Update for each item to download all the available updates.
  12. Once all of the downloads are complete, close Visual Studio.  The VSIX Installer program will launch automatically to install the components.
  13. Start Visual Studio again.

Uninstall steps for Visual Studio 2017 Preview

If you wish to switch back from the Xcode 9 support previews to the default Xamarin versions bundled in Visual Studio 2017 Preview, use the Visual Studio Installer to un-install, and then re-install, the Mobile development with .NET (Xamarin) workload.