Troubleshooting Xamarin for Visual Studio

PDF for offline use:

Let us know how you feel about this.


0/250
Thanks for the feedback!

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 call stack of Visual Studio's Main Thread?

When the GUI locks up (hangs, freezes) in Visual Studio, one important diagnostic step is to check the call stack of the Main Thread (the GUI thread). To collect this call stack from a hung instance of VS, 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.