Category Archives: Visual Studio for Mac

Beta Release: 15.3 Preview 2

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

Note that this Beta version is a smaller release compared to the current Alpha preview. In particular, it does not include the Xamarin Live Player, Docker, Azure Functions, or Xamarin IoT preview features announced at Build. Please stay on the Alpha channel if you wish to continue to preview those features.

Update for June 26: This release is now available as part of the June 26th – version 15.3.0 Preview 3 update for Visual Studio 2017 Preview as well as in the Xamarin updater channels.

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

Preview 1 – May 11th, 2017

Preview 2 – This Release

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.

Stable Release: 15.2.2 Servicing Release

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

Update for May 30: This release is now available in the Xamarin updater channels and as part of the May 30th – version 15.2 (26430.12) update for Visual Studio 2017.

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.


Updating from Xamarin Studio to Visual Studio for Mac

Visual Studio for Mac is now generally available as announced at the Microsoft Build conference. It is the recommended environment for Xamarin developers on Mac moving forward. To get started with Visual Studio on Mac, download and run the Visual Studio for Mac installer. It will install Visual Studio for Mac as a new app alongside Xamarin Studio.


Products Released


Installing

You can get this latest version by checking for updates on the Stable updater channel and in Visual Studio 2017 by installing Visual Studio 2017 version 15.2 (26430.12).


Previous Versions

  • For Windows the previous versions and download locations are:

Upcoming Release Dates

Stable – May 10th 2017

Stable 2 – This Release!

 

Common issues from the Xamarin 15.2 release being tracked by the Xamarin team

In case it might be useful for reference, here is an in-progress list of some commonly seen issues being tracked by the Xamarin team for the Xamarin 15.2 release. The list is sorted approximately by the number of users subscribed to each bug report, and in some cases also by additional hand-tallying. The list focuses on issues where the pattern of reports suggests a change in behavior compared to the Xamarin 15.1 release. This list is not exhaustive: It does not include every issue user-submitted issue reported since the time of the Xamarin 15.2 release.

  • Bug 56275 and developercommunity 54945 [Xamarin.VisualStudio] Significant increase in the chances of hitting “Unable to copy file “obj\Debug\App1.dll” to “bin\Debug\App1.dll”. The process cannot access the file ‘bin\Debug\App1.dll’ because it is being used by another process.” and “Exceeded retry count of 10. Failed”. Under investigation.
    • A few possible temporary workarounds are discussed on the bug report.
    • One comment on the report also indicates that installing and using the Visual Studio 2017 Preview version 15.3 might resolve the issue.
  • 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. Integration of the upstream Roslyn fix is in-progress.
    • Partial temporary workaround: Switch back to mcs and xbuild (see additional details below).
  • Bug 56213 [Xamarin.VisualStudio] “Can not resolve reference: C:/Windows/Microsoft.NET/Framework/v4.0.30319/de/mscorlib.resources.dll” when building or breakpoints fail to hit on iOS devices when debugging. Now RESOLVED in the source code, and will be included in an upcoming release.
  • Bug 55087 [Xamarin.Android] “System.NotSupportedException: Stack walks are not supported on this platform – System.Reflection.MethodBase.GetCurrentMethod” when attempting to debug on x86_64 Android emulators. Now RESOLVED in the source code, and will be included in an upcoming release.
    • Partial temporary workaround: Use an x86 Android emulator rather than an x86_64 Android emulator.
  • Bug 56296 [Xamarin.Forms] “MTOUCH: error MT2001: Could not link assemblies.” when attempting to link Xamarin.Forms projects that use XamlC on iOS because XamlC does not update the new default portable .pdb debug symbol files. Now RESOLVED in the source code, and will be included in an upcoming release of Xamarin.Forms.
    • Possible temporary workaround: Disable XamlC.
    • Alternate possible temporary workaround: Switch back to mcs and xbuild (see additional details below).
  • Bug 56240 [Xamarin.Android] Performance degradation when using System.Linq.Expressions in Xamarin.Android 7.3. A candidate change has been added and will be included in an upcoming release of Xamarin.Android.
  • Bug 56238 and developercommunity 49033 [Xamarin.Android] App exits on launch or fails to hit breakpoints when debugging due to change in default build behavior when the Optimize MSBuild property is not explicitly set. Now RESOLVED in the source code, and will be included in an upcoming release.
    • Workaround: Explicitly set the Optimize property to False in the .csproj file. See the answer on the developercommunity item for a few additional details.
  • Compatibility change: [Xamarin Studio] Breakpoints no longer work for certain Xamarin project types and scenarios in Xamarin Studio 6.3 due incomplete support for the new default portable .pdb format generated by Mono 5.0.
    • Recommended solution: Install and use Visual Studio for Mac now that it is generally available and the recommended environment for Xamarin development on Mac.
    • Alternate possible temporary workaround: Switch back to mcs and xbuild (see additional details below).
  • Bug 56192 [Xamarin.VisualStudio] MultiDex is disabled after saving changes to Xamarin.Android project due to incorrect MSBuild property name <AndroidEnableMultipleDex>. Now RESOLVED in the source code, and will be included in an upcoming release.
    • Workaround: In the .csproj file, replace all occurrences of AndroidEnableMultipleDex with the correct property name AndroidEnableMultiDex using a text editor.
  • Bug 56220 [Xamarin.iOS, Xamarin.VisualStudio] “The item “C:….nuget\packages\Autofac\4.5.0\lib\netstandard1.1\Autofac.dll” in item list “ReferenceCopyLocalPaths” does not define a value for metadata “ResolvedFrom””. Under investigation. A few possible temporary workarounds are discussed on the bug report.
    • A possible temporary workaround is mentioned on the bug report.

Temporarily switching back to mcs and xbuild

The Xamarin 15.2 release includes Mono 5.0, which enables the Roslyn csc C# compiler by default and deprecates the use of xbuild in favor of msbuild. For the Xamarin toolchain, this adds C# 7 support and changes the default debugging symbol format from .mdb files to portable .pdb files. And Visual Studio for Mac uses msbuild by default when building projects.

The change from mcs to csc and xbuild to msbuild is related to several of the issues listed above. One potential workaround in those cases is to switch back to the earlier combination of mcs and xbuild without downgrading Mono or the Xamarin toolchain. As a caution, this is not a tested scenario, so although this approach has been reported to work well so far, it does still have a chance of hitting other secondary errors.

  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.

Alpha Release: 15.3 Preview 1

UPDATE (2017-05-11): We are releasing a Hotfix for Visual Studio for Mac. This new version (7.1.0.583) resolves the issue mentioned here.

We are releasing the first Alpha preview of our next major release, called 15.3. This release includes our next preview of Visual Studio for Mac.

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 – This Release!

 

Stable Release: 15.2

We are releasing the Stable build of our next major release, called 15.2 to the Alpha, Beta, and Stable channels.

This release is now available in the Xamarin updater channels and as part of the May 10th – version 15.2 update for Visual Studio 2017.

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.


Updating from Xamarin Studio to Visual Studio for Mac

As announced at the Microsoft Build conference, Visual Studio for Mac is now generally available. It is the recommended environment for Xamarin developers on Mac moving forward. Visual Studio for Mac has all the features of Xamarin Studio, adds cloud and web development, and contains improvements for cross-platform mobile development.

To get started with Visual Studio on Mac, download and run the Visual Studio for Mac installer. It will leave Xamarin Studio unchanged, update the other Xamarin packages to the current versions, and install the Visual Studio for Mac app. Xamarin Studio can continue to be used alongside Visual Studio for Mac if desired, but please note that debugging symbols in this 15.2 release are not backwards compatible with Xamarin Studio 6.3, so you will need to use Visual Studio for Mac to hit breakpoints and break where expected on unhandled exceptions.


Known Issues

There are some known issues and the possibility of new issues being found. Additional bug reports are still welcome for this stable version. If you see any suspicious behavior that you wish to report, please file a quick bug.

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

Update for May 17: See also the list of commonly reported issues from the Xamarin 15.2 release being tracked by the Xamarin team.

  • [Android SDK Manager]55943 – “The “Aapt” task failed unexpectedly”, “Error creating start-server process”, or other errors after updating Android tools via Xamarin’s Android SDK Manager due to incorrect file permissions that cause “Native error= Access denied” for various executables.
    • Manual workaround: Add the executable flag to the “ApplicationName” indicated in the log file that is missing the executable flag, for example by using chmod in a Terminal.app command prompt.
  • [Android SDK Manager] 55720 – On uninstalling Latest build of SDK Tools, All SDK tools are uninstalled.
    • A candidate fix will be included in an upcoming preview of Visual Studio for Mac.

Products Released


Installing

You can get this latest version by checking for updates on the Stable updater channel and in Visual Studio 2017 by installing Visual Studio 2017 version 15.2.


Previous Versions for Visual Studio 2015 or Mac-only

Previous Versions for Visual Studio 2017

  • For Windows the previous versions and download locations are:

(Note that the previous available version of Visual Studio 2017 is the RTW version 15.0 rather than the 15.1 update to follow the Visual Studio update guidelines.)


Upcoming Release Dates

Alpha 1 – April 6th 2017

Alpha 2 – April 11th 2017

Alpha 3 – April 19th 2017

Beta 1 – April 25th 2017

Beta 2 – May 3rd 2017

Stable – This Release!

Beta Release: 15.2 Preview 2

 

We are releasing the second Beta preview of our next major release, called 15.2. This release includes our next preview of Visual Studio for Mac.

Using the latest Visual Studio for Mac Preview 10 with this release is encouraged, but you can also continue to use Xamarin Studio if you prefer (though new previews of XS are not included in this release). If you are updating from Visual Studio for Mac Preview 5 or earlier, you’ll need to check for updates once to install the new Preview and then once more to get the new Xamarin Platform components. It should be noted that since VS for Mac is still in preview, it is not yet a fully supported product.

These latest Beta versions are now also available in Visual Studio 2017 Preview as part of the May 3 update (26430.01 – Preview).  The Xamarin.VisualStudio extension 4.5.0.439 in this Visual Studio 2017 Preview is one small edit behind the version in VS 2015.

As this is a Beta/Preview 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 – April 6th 2017

Alpha 2 – April 11th 2017

Alpha 3 – April 19th 2017

Beta 1 – April 25th 2017

Beta 2 – This Release!

Beta Release: 15.2 Preview 1

We are releasing the first Beta preview of our next major release, called 15.2. This release includes our next preview of Visual Studio for Mac.

Using the latest Visual Studio for Mac Preview 9 with this release is encouraged, but you can also continue to use Xamarin Studio if you prefer (though new previews of XS are not included in this release). If you are updating from Visual Studio for Mac Preview 5 or earlier, you’ll need to check for updates once to install the new Preview and then once more to get the new Xamarin Platform components. It should be noted that since VS for Mac is still in preview, it is not yet a fully supported product.

These latest Beta versions are now also available in Visual Studio 2017 Preview as part of the April 26 update (26424.02 – Preview).

This Beta release also includes an updated Xamarin Studio 6.3.0.864 build that notifies users that Visual Studio for Mac Preview is now available: “Visual Studio for Mac is Microsoft’s fully-featured IDE for developers on Mac. It has all the features of Xamarin Studio, adds cloud and web development, and contains improvements for cross-platform mobile development. Try the preview and let us know what you think!”

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 – April 6th 2017

Alpha 2 – April 11th 2017

Alpha 3 – April 19th 2017

Beta 1 – This Release!

Alpha Release: 15.2 Alpha Preview 3

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

Using the latest Visual Studio for Mac Preview 8 with this release is encouraged, but you can also continue to use Xamarin Studio if you prefer (though new previews of XS are not included in this release). If you are updating from Visual Studio for Mac Preview 5 or earlier, you’ll need to check for updates once to install the new Preview and then once more to get the new Xamarin Platform components.

New: This Xamarin release is now also available in Visual Studio 2017 Preview as part of the April 20 update (26419.01 – Preview).

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 – April 6th 2017

Alpha 2 – April 11th 2017

Alpha 3 – This Release!

Preview 7: Visual Studio for Mac

We are releasing our seventh preview of Visual Studio for Mac. Visual Studio for Mac is an evolution of Xamarin Studio, and includes all the functionality of Xamarin Studio 6.3.

If you already have VS for Mac installed, this update will appear in the Alpha updater channel within the IDE. If you do not yet have a VS for Mac Preview, you can download this newer one here. Future updates will then be available to you through the VS for Mac “Check for Updates” menu option.

Please note that the VS for Mac IDE has its own set of updater channels, separate from Xamarin Studio and Xamarin.VS. As of Preview 6 and for all future Preview releases of VS for Mac, only an Alpha channel will appear. That channel provides the latest preview updates as they become available. When VS for Mac moves out of preview status, the available updater channels will be adjusted accordingly. It should be noted that since VS for Mac is still in preview, it is not yet a fully supported product.

Visual Studio for Mac can be installed side-by-side with Xamarin Studio.


 

Known Issues

54993 – “The root assembly … conflicts with another assembly” build error will appear for Xamarin.iOS projects in Xamarin.VisualStudio 4.4.0 on Windows due to the incompatible Xamarin.iOS 10.10.0 Alpha version that is installed on the Mac by the latest Visual Studio for Mac Preview.

  • Visual Studio 2015 and 2013 users can optionally update to the Alpha updater channel to get the compatible Xamarin.VisualStudio 4.5.0 Alpha version. For VS 2017 users and users who do not wish to use the Alpha versions on Windows, please refer to the bug report for a few other options for how to resolve this issue.

Products Released