Category Archives: Technical Bulletin

Technical Bulletin: Xcode 9.3

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

The Xamarin team is proceeding as usual to test for compatibility and publish updated versions of Xamarin.iOS and the Visual Studio Tools for Xamarin to align with the new version of Xcode. Keep an eye on this blog for status updates.

For users who are planning to update to Xcode 9.3, note that this new version requires macOS High Sierra 10.13.

Update April 3: The Xamarin 15.6.5 release has now been published with SDK bindings and IDE compatibility for the Xcode 9.3 release.


Xcode 9.3 Support Preview Release History

Preview 2 – March 15, 2018

Preview 1 – February 15, 2018

Preview: Xcode 9.3 beta 4, iOS 11.3, macOS 10.13.4 Support – Preview 2

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

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

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


Products Released

  • Visual Studio  for Mac 7.4.0.1035
  • Download
  • Visual Studio Tools for Xamarin 4.9.0.753
  • Download for Visual Studio 2017
  • Visual Studio Tools for Xamarin 4.9.0.753
  • Download for Visual Studio 2015

Installing on Mac

  1. Ensure you are up-to-date with the current Visual Studio for Mac Stable updater channel versions.
  2. Ensure you have the Xcode 9.3 beta 2 version installed from Apple. You can optionally install this beta version alongside your non-beta Xcode.
  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.6

  1. Ensure that Visual Studio 2017 is up-to-date at version 15.6 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.6 release, so it is not fully compatible with Visual Studio 2017 version 15.7 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.3 beta support previews to the default Xamarin versions bundled in Visual Studio 2017 version 15.6:

  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.

Preview: Xcode 9.3 beta 2, iOS 11.3, macOS 10.13.4 Support – Preview 1

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

Note that this is a standalone download link that is not yet published in the Visual Studio for Mac updater channels. As a result, Visual Studio for Mac will offer an “update” back to the current published updater channel versions when you have this version installed. You will need to disregard that notification if you wish to keep using this Xcode 9.3 support preview. The Xcode 9.3 features will be added to the updater channels in the future, after Apple publishes the first non-preview version of Xcode 9.3 to the App Store.

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


Products Released


Installing on Mac

  1. Ensure you are up-to-date with the current Visual Studio for Mac Stable updater channel versions.
  2. Ensure you have the Xcode 9.3 beta 2 version installed from Apple. You can optionally install this beta version alongside your non-beta Xcode.
  3. Download the Xamarin.iOS and Xamarin.Mac installer .pkg file and run it.

Uninstall steps

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


 

Technical Bulletin: Xcode 9.2

As announced on Apple’s developer news site, Apple released Xcode 9.2 final on December 4.

The Xamarin team is proceeding as usual to test for compatibility and publish updated versions of Xamarin.iOS and the Visual Studio Tools for Xamarin to align with the new version of Xcode. Keep an eye on this blog for status updates.

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

Today we are releasing the following builds as Xcode 9 Web Preview 4. 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

These packages require the current Mono 5.2 Beta version or higher

Preview IDE compatibility packages for Mac and Visual Studio 2015

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

Preview IDE compatibility installation steps for Visual Studio 2017 Preview

  • Xamarin.VS 4.6.0.340 (for Visual Studio 2017 Preview)
  1. Ensure that you have Visual Studio 2017 Preview version 15.3.0 Preview 4 or higher 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 4, iOS 11, macOS 10.13 support – Preview 2

Today we are releasing the following builds as Xcode 9 Web Preview 2. These versions include preview Xamarin SDK bindings and preview IDE compatibility for Apple’s Xcode 9 beta 4 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.1277
  • Download
  • Xamarin.VS 4.6.0.337 (Visual Studio 2015)
  • Download

Preview IDE compatibility installation steps for Visual Studio 2017 Preview

  • Xamarin.VS 4.6.0.328 (for Visual Studio 2017 Preview)
  1. Ensure that you have Visual Studio 2017 Preview version 15.3.0 Preview 4 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 3, iOS 11, macOS 10.13 support – Preview 1

Today we are releasing the following builds as Xcode 9 Web Preview 1. These versions include preview Xamarin SDK bindings and preview IDE compatibility for Apple’s Xcode 9 beta 3 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.

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.1267
  • Download
  • Xamarin.VS 4.6.0.328 (Visual Studio 2015)
  • Download

Preview IDE compatibility installation steps for Visual Studio 2017 Preview

  • Xamarin.VS 4.6.0.328 (for Visual Studio 2017 Preview)
  1. Ensure that you have Visual Studio 2017 Preview version 15.3.0 Preview 4 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.

Common issues in the Xamarin 15.2.2 release being tracked by the Xamarin team

In case it might be useful for reference, here is an update on the previous list of commonly seen issues from the Xamarin 15.2 release. Many of those issues are now resolved in the Xamarin 15.2.2 release.  This updated list gives the latest statuses and workarounds for a few remaining issues from the Xamarin 15.2 release and the Xamarin 15.2.2 release, with a focus on bug reports that have several subscribed users.

  • Bug 56787 [Xamarin.VisualStudio, Xamarin.iOS, Xamarin.Android] “Could not load file or assembly ‘Mono.Posix, Version=2.0.0.0, …'” in some cases when attempting to start debugging with breakpoints set. This happens because the Mono.Posix.dll file is missing from the Xamarin.VisualStudio installer.
    • Temporary workaround:
      1. Download the missing Mono.Posix file and unzip the archive.
      2. Right-click the Mono.Posix.dll file in Explorer and select Properties.
      3. Check the Digital Signatures tab to ensure the file shows a valid Xamarin Inc. signature.
      4. At the bottom of the General tab, if an Unblock checkbox appears, enable it and select OK. (This checkbox appears depending on how the file was downloaded.)
      5. For Visual Studio 2017, copy the Mono.Posix.dll file into the “Xamarin.VisualStudio” extension directory. For example, for a default installation of the Enterprise edition, copy the file into:
        C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\Extensions\Xamarin.VisualStudio
      6. For Visual Studio 2015, copy the file into the “Xamarin\Xamarin” extension directory:
        C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE\Extensions\Xamarin\Xamarin\
      7. Quit and restart Visual Studio.
    • If these steps to do not resolve the issue in your environment, please see the bug report for information about enabling “Fusion logging” (assembly binding logging) and submitting a new bug report for further investigation.
  • Bug 56893 and Bug 56808 [Xamarin.VisualStudio, Xamarin.iOS] Breakpoints are non-functional  and exception call stacks show user code as “External Code” in certain scenarios when debugging on iOS devices and simulators with the linker enabled.
    • Possible temporary workaround: Change the DebugType to portable to more closely match the build behavior of Visual Studio for Mac.
      1. Open each project .csproj file in a text editor. For example, right-click each project in the Solution Explorer and select Unload Project, and then right-click it again and select Edit.
      2. Under the PropertyGroup for the “Debug|AnyCPU” configuration, set:
        <DebugType>portable</DebugType>
      3. Save the changes and reload the projects.
      4. Clean the solution and manually delete the “bin” and “obj” folders to remove any left-over .mdb debugger symbol files.
      5. If any of the projects use async partial methods, install the Microsoft.Net.Compilers  pre-release version 2.3.0-beta1 NuGet package (or higher) into all of the projects (to fix Roslyn issue 17934).
  • Bug 56246 [Mono, Xamarin.Android, Xamarin.iOS, Xamarin.Mac] Tracking bug for upstream Roslyn issue 17934: “error MSB6006: “csc.exe” exited with code 1″ due to KeyNotFoundException when compiling projects that include async partial methods.
    • Possible temporary workaround: Install the Microsoft.Net.Compilers  pre-release version 2.3.0-beta1 NuGet package (or higher) into all of the projects to get the pre-release Roslyn C# compiler that includes the fix.
    • Alternate temporary workaround: Switch back to mcs and xbuild.
      1. Add the following PropertyGroup element to the bottom of the .csproj file for your app project just before the closing </Project> tag:
        <PropertyGroup Condition=" '$(OS)' == 'Unix' ">
            <CscToolExe>mcs.exe</CscToolExe>
        </PropertyGroup>
      2. Disable Visual Studio > Preferences > Build > Build with MSBuild instead of xbuild. (This setting is also available in Xamarin Studio 6.3. It is disabled by default in Xamarin Studio, but some users might have enabled it by hand in the past.)
      3. Close and reopen the solution to ensure the new setting is used.
      4. Clean and rebuild the project.
    • developercommunity 63718 [Xamarin.VisualStudio] In certain environments, Visual Studio crashes often due to an unhandled exception in a Zeroconf method called by Xamarin.VisualStudio.ZeroConf.MacDiscoveryService.