Microsoft Visual Studios For Mac

Visual Studio for Mac Develop apps and games for iOS, Android, and web using.NET.

Visual Studio for Mac requires an active internet connection for installation. Visual Studio for Mac now includes support for generating an API client from an OpenAPI or gRPC service. This includes the ability to generate the client from a local file or URL, manage service references, and regenerate the client code if the service changes.


You can use this guide to uninstall each component in Visual Studio for Mac individually by navigating to the relevant section, or you can use the scripts provided in the Uninstall Script section to uninstall everything.


This information will only remove Visual Studio 2019 or 2017 for Mac from your machine. to uninstall Visual Studio Code, see this issue for details.

Uninstall Script

There are two scripts that can be used to uninstall Visual Studio for Mac and all components for your machine:

The following sections provide information on downloading and using the scripts.

Visual Studio for Mac and Xamarin script


You can uninstall Visual Studio and Xamarin components in one go by using the uninstall script.

This uninstall script contains most of the commands that you will find in the article. There are three main omissions from the script and are not included due to possible external dependencies. To remove this, jump to the relevant section below and remove them manually:

To run the script, do the following steps:

  1. Right-click on the script and select Save As to save the file on your Mac.

  2. Open Terminal and change the working directory to where the script was downloaded:

  3. Make the script executable and the run it with sudo:

  4. Finally, delete the uninstall script and remove Visual Studio for Mac from the dock (if it's there).

.NET Core script

The uninstall script for .NET Core is located in the dotnet cli repo

To run the script, do the following steps:

  1. Right-click on the script and select Save As to save the file on your Mac.

  2. Open Terminal and change the working directory to where the script was downloaded:

  3. Make the script executable and the run it with sudo:

  4. Finally, delete the .NET Core uninstall script.

Uninstall Visual Studio for Mac

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

Deleting this app bundle removes Visual Studio for Mac, even though there may be other files related to Xamarin still on the file system.

To remove all traces of Visual Studio for Mac, run the following commands in Terminal:

You may also want to remove the following directory containing various Xamarin files and folders. However, before you do you should be aware that this directory contains the Android signing keys. For more information refer to the section Uninstalling Android SDK and Java SDK:

Uninstall Mono SDK (MDK)

Microsoft Visual Studio For Mac Os 10.6.8

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#.


There are other applications outside of Visual Studio for Mac that 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:

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.

Use the following commands to remove Xamarin.Android:

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.


You should be aware that Android signing keys that are generated by Visual Studio for Mac are located in ~/Library/Developer/Xamarin/Keystore. Make sure to back these up appropriately, or avoid removing this directory if you wish to keep your keystore.

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

Uninstall Android AVD


There are other applications outside of Visual Studio for Mac that also use Android AVD and these additional android components, such as Android Studio.Removing this directory may cause projects to break in Android Studio.

To remove any Android AVDs and additional Android components use the following command:

To remove only the Android AVDs use the following command:

Uninstall Xamarin.iOS

Xamarin.iOS allows iOS application development using C# or F# with Visual Studio for Mac.

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

Uninstall Xamarin.Mac

Xamarin.Mac can be removed from your machine using the following two commands to eradicate the product and license from your Mac respectively:

Uninstall Workbooks and Inspector

Starting with 1.2.2, Xamarin Workbooks & Inspector can be uninstalled from a terminal by running:

For older versions, you need to manually remove the following artifacts:

  • Delete the Workbooks app at '/Applications/Xamarin'
  • Delete the Inspector app at 'Applications/Xamarin'
  • Delete the add-ins: '~/Library/Application Support/XamarinStudio-6.0/LocalInstall/Addins/Xamarin.Interactive' and '~/Library/Application Support/XamarinStudio-6.0/LocalInstall/Addins/Xamarin.Inspector'
  • Delete Inspector and supporting files here: /Library/Frameworks/Xamarin.Interactive.framework and /Library/Frameworks/Xamarin.Inspector.framework

Uninstall the Xamarin Profiler

Uninstall the Visual Studio Installer

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

Uninstall Visual Studio 2019 for Mac Preview

Visual Studio 2019 for Mac Preview was launched as a separate preview, allowing you to continue to work with your Visual Studio 2017 for Mac install side-by-side.

Now that Visual Studio 2019 for Mac has been released, you can now safely remove the Visual Studio 2019 for Mac Preview application.

To uninstall the preview application bundle, select Visual Studio (Preview) from your Applications folder and click Move to Trash, as depicted in the following image:

You can also remove the Preview plist file with the following command:

See also


Signing in to Visual Studio for Mac is how you activate your subscription. When you download Visual Studio for Mac, you'll always get the Community edition by default. If you have a Professional or Enterprise license, you should sign-in on first run to unlock any additional features. In addition you'll also get the following:

  • Access to the Visual Studio Dev Essentials program – This program includes free software offerings, training, support, and more. See Visual Studio Dev Essentials for more information.

  • Automatically connect to Azure in the IDE without prompting again for credentials for the same account.

When you launch Visual Studio for Mac for the first time, you're prompted to log in using a Microsoft account. Use a Microsoft account that is connected to the license that you wish to use. If you do not have a Microsoft account, see How do I sign up for an account.

If you do decide not to log in straight away, you'll be able to use an evaluation copy for 30 days. After 30 days you must log in to continue using your copy of Visual Studio for Mac.

How to sign in to Visual Studio for Mac


Make sure that you're connected to the internet before signing in to Visual Studio for Mac. > Subscriptions can only be activated online. If you're not connected, choose 'I'll do this later' and log in through the menu when you get connected.

To sign in to Visual Studio for Mac on first launch, do the following steps:

  1. Click the Sign in with Microsoft button on the sign-in window:

  2. Enter your Microsoft Credentials:

  3. After you've logged in, you'll see an option to select keyboard shortcuts. Pick the option you wish to use and Continue. You'll then be prompted with the Visual Studio 2019 for Mac start window. From here, you can open or create a new project:

Alternatively, you can use the Visual Studio > Sign in… menu item to sign in and out at any time.

Microsoft Visual Studio For Mac

Adding multiple user accounts

Visual Studio for Mac supports adding multiple accounts to your personalization account. These additional accounts will allow you to access resources, such as Azure, from any added account.

To add additional user accounts, choose the Visual Studio > Account... menu from Visual Studio for Mac. Click the Add... button to enter additional account credentials.

View or change your profile information

  1. Go to Visual Studio > Account… and select the My profile button.

  2. In the browser window, choose Edit profile and change the settings that you want.

  3. When you're done, choose Save changes.

Visual Studio Enterprise For Mac

See also