Troubleshooting Xamarin for Visual Studio

PDF for offline use

Let us know how you feel about this

Translation Quality


last updated: 2016-12

Why doesn't Visual Studio include my referenced library project in my build?

Visual Studio uses the Configuration Manager to determine which projects in a solution are automatically included in a given build or deployment configuration. Some templates that are generated with a referenced library project will already have the referenced library included in the configuration; but otherwise it will need to be set manually.

Deploy checkboxes disabled in Configuration Manager

Since Xamarin 3.5, the Deploy checkboxes are intentionally disabled in the Visual Studio Configuration Manager for Xamarin.iOS projects. Instead, Xamarin.iOS projects are now deployed automatically whenever you press the Start toolbar button or pick the Debug > Start Debugging menu item. You will still need to set the desired Xamarin.iOS app project as the StartUp Project before before running either of those commands.

How do I collect the current call stacks of the Visual Studio process?

When the GUI locks up (hangs, freezes) in Visual Studio, an important piece of diagnostic information to collect is the set of call stacks from all the threads of the Visual Studio process. To save this information for a hung instance of Visual Studio, you can use a second instance of Visual Studio.

How do I perform a thorough uninstall for Xamarin for Visual Studio?

This guide details how to perform full manual install and reinstall of Xamarin for Visual Studio.

Missing Visual Studio extensions after installation

This guide provides troubleshooting steps for several possible scenarios where the Xamarin extension is not accessible from within Visual Studio.

Xamarin Workbook

If it's not already installed, install the Xamarin Workbooks app first. The workbook file should download automatically, but if it doesn't, just click to start the workbook download manually.