Uninstalling Xamarin

Uninstalling Xamarin products from a computer

PDF for offline use
Sample Code:

Let us know how you feel about this

Translation Quality


0/250

last updated: 2017-04

⚠️

This article explains how to uninstall Xamarin Studio or other Xamarin products from a Mac or Windows computer. For information on uninstalling Visual Studio for Mac, refer to the Uninstall guide on docs.microsoft.com

Overview

There are a number of Xamarin products that enable cross-platform application development, including stand-alone apps like Xamarin Studio, and extensions to other apps like the Xamarin support in Visual Studio.

This guide will explain how to remove the Xamarin functionality on macOS, or from Visual Studio on Windows:

  1. Uninstalling Xamarin Studio
    1. Uninstalling Mono
    2. Uninstalling Xamarin.Android
    3. Uninstalling Xamarin.iOS
    4. Uninstalling Xamarin.Mac
    5. Uninstalling Inspector and Workbooks
  2. Uninstalling Xamarin from Windows
    1. Uninstalling Xamarin from Visual Studio 2015 and earlier
    2. Uninstalling Xamarin from Visual Studio 2017
  3. Uninstalling Visual Studio for Mac

If it is necessary to re-install Xamarin using the Universal Installer, it is always recommended that the computer is rebooted first.

Uninstalling Xamarin on Mac

This guide can be used to uninstall each product individually by navigating to the relevant section. The entire Xamarin toolset can be uninstalled by following this guide the whole way through.

For help with using the Uninstall script, jump to the Using the Uninstall Script at the bottom of this guide.

Uninstall Xamarin Studio

The first step in uninstalling Xamarin Studio from a Mac is to locate Xamarin Studio.app in the /Applications directory and drag it to the Trash Can. Alternatively, right-click and select Move to Trash as illustrated below:

Deleting this app bundle will remove Xamarin Studio, however, there are other files relating to Xamarin still on a file system.

To remove all traces of Xamarin Studio, the following commands should be run in Terminal:

sudo rm -rf "/Applications/Xamarin Studio.app"
rm -rf ~/Library/Caches/XamarinStudio-*
rm -rf ~/Library/Preferences/XamarinStudio-*
rm -rf ~/Library/Logs/XamarinStudio-*
rm -rf ~/Library/XamarinStudio-*

Uninstall Mono SDK (MDK)

Mono is an open source implementation of Microsoft’s .NET Framework and is used by all Xamarin Products—Xamarin.iOS, Xamarin.Android and Xamarin.Mac to allow development of these platforms in C#.

⚠️

Note: There are other applications outside of Xamarin which also use Mono, such as Unity. Be sure that there are no other dependencies on Mono before uninstalling it.

To remove the Mono Framework from a machine, run the following commands in Terminal:

sudo rm -rf /Library/Frameworks/Mono.framework
sudo pkgutil --forget com.xamarin.mono-MDK.pkg

Uninstall Xamarin.Android

There are a number of items required for the installation and use of Xamarin.Android, such as the Android SDK and Java SDK. More information about these required components is available in the Manual Installation guide.

Use the following commands to remove Xamarin.Android:

sudo rm -rf /Developer/MonoDroid
rm -rf ~/Library/MonoAndroid
sudo pkgutil --forget com.xamarin.android.pkg
sudo rm -rf /Library/Frameworks/Xamarin.Android.framework

Uninstall Android SDK and Java SDK

The Android SDK is required for development of Android applications. To completely remove all parts of the Android SDK, locate the file at ~/Library/Developer/Xamarin/ and move it to Trash, as illustrated below:

The Java SDK (JDK) does not need to be uninstalled, as it is already pre packaged as part of Mac OS X.

Uninstall Xamarin.iOS

Xamarin.iOS allows iOS application development using C# or F# with Xamarin Studio on a Mac. The Xamarin Build Host was also installed automatically with earlier versions of Xamarin.iOS to allow for iOS development in Visual Studio. To uninstall both from a machine, follow the steps below:

Use the following commands in Terminal to remove all Xamarin.iOS files from a file system:

rm -rf ~/Library/MonoTouch
sudo rm -rf /Library/Frameworks/Xamarin.iOS.framework
sudo rm -rf /Developer/MonoTouch
sudo pkgutil --forget com.xamarin.monotouch.pkg
sudo pkgutil --forget com.xamarin.xamarin-ios-build-host.pkg

Uninstall the Mac Build Host

Note: This may already have been removed if you have already updated to to Xamarin 4 Run the following command in Terminal to remove the Build Host application:

sudo rm -rf "/Applications/Xamarin.iOS Build Host.app"

The Build Host process or launchd job may still be running or listening on certain ports. You can check its status by running launchctl list | grep com.xamarin.mtvs.buildserver in Terminal.

sudo launchctl unload /Library/LaunchAgents/com.xamarin.mtvs.buildserver.plist
sudo rm -f /Library/LaunchAgents/com.xamarin.mtvs.buildserver.plist

Uninstall Xamarin.Mac

Once Xamarin Studio has been successfully uninstalled, Xamarin.Mac can be removed from your machine using the following two commands to eradicate the product and license from your Mac respectively:

sudo rm -rf /Library/Frameworks/Xamarin.Mac.framework
rm -rf ~/Library/Xamarin.Mac

Uninstall Workbooks and Inspector

The following Bash commands will remove the Xamarin Inspector and Workbooks:

$ sudo rm -fr /Library/Frameworks/Xamarin.Interactive.framework 
$ sudo rm -fr /Applications/Xamarin\ Workbooks.app
$ pkgutil --forget com.xamarin.Inspector
$ sudo rm -rf /usr/lib/workbooks

Uninstall the Xamarin Installer

Use the following commands to remove all traces of the Xamarin Universal Installer:

rm -rf ~/Library/Caches/XamarinInstaller/
rm -rf ~/Library/Logs/XamarinInstaller/
rm -rf ~/Library/Preferences/Xamarin/

Using the Uninstall Script

The uninstall script will remove Xamarin from a computer. To use the uninstall script:

  1. Download the uninstall script and make a note of the download location. By default this is the /Downloads directory.
  2. Open Terminal and change the working directory to where the script was downloaded:

    $ cd /location/of/file
  3. Make the script executable and the run it with sudo:

    $ chmod +x ./xamarin_uninstall.sh
    $ sudo ./xamarin_uninstall.sh
  4. Finally, delete the uninstall script.

At this point, Xamarin should be uninstalled from your computer.

Uninstalling Xamarin on Windows

Visual Studio 2015 and earlier

Xamarin can be uninstalled from a Windows machine through Control Panel. Navigate to Programs and Features or Programs > Uninstall a Program as illustrated below:

To uninstall Xamarin Studio, find Xamarin Studio 5.x.x in the list of programs and click the Uninstall button. To remove the Xamarin extension for Visual Studio, and the SDKs, find Xamarin in the list of Programs and click Uninstall. These are illustrated in the screenshot below:

These programs may also be removed to completely all Xamarin components:

  • Android SDK

  • GTK#

  • Xamarin Universal Installer

  • Java SDK (Be careful when removing this, as there may be other dependencies on it)

To uninstall Visual Studio completely, follow Microsoft's instructions.

Visual Studio 2017

Xamarin can be uninstalled from Visual Studio 2017 using the installer app:

  1. Use the Start menu to open the Visual Studio Installer.

  2. Press the Modify button for the instance you wish to change.

  3. In the Workloads tab, de-select the Mobile Development with .NET option (in the Mobile & Gaming section).

  4. Click the Modify button in the bottom right of the window.

  5. The installer will remove the de-selected components (Visual Studio 2017 must be closed before the installer can make any changes).

Individual Xamarin components (such as the Profiler or Workbooks) can be uninstalled by switching to the Individual Components tab in step 3, and un-checking specific components:

To uninstall Visual Studio 2017 completely, choose Uninstall from the three-bar menu next to the Launch button.

⚠️

WARNING: If you have two (or more) instances of Visual Studio installed side-by-side (SxS) – such as a Release and a Preview version – uninstalling one instance might remove some Xamarin functionality from the other Visual Studio instance(s), including:

  • Xamarin Profiler
  • Xamarin Workbooks/Inspector
  • Xamarin Remote iOS Simulator
  • Apple Bonjour SDK

Under certain conditions, uninstalling one of the SxS instances can result in the incorrect removal of these features. This may degrade the performance of the Xamarin Platform on the Visual Studio instance(s) that remain on the system after the uninstallation of the SxS instance.

This can be resolved by running the Repair option in the Visual Studio installer, which will re-install the missing components.

Uninstalling Visual Studio for Mac

To uninstall Visual Studio for Mac but to keep using Xamarin Studio, locate Visual Studio.app in the /Applications directory and drag it to the Trash Can. Alternatively, right-click and select Move to Trash as illustrated below:

To uninstall Xamarin completely from your machine, first delete Visual Studio for Mac, and then follow the steps listed in the Uninstall Xamarin Studio section.

Summary

In this article we looked at uninstalling Xamarin completely from a Mac through the use of Terminal commands, as well as uninstalling Xamarin from a Windows machine through the Programs and Features option (for Visual Studio 2015 and earlier), and using the Visual Studio Installer for Visual Studio 2017.

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.