Get Started on Visual Studio 2019 for Xamarin

Prerequisites

  • Visual Studio 2019 16.3 or later, with:
    • Universal Windows Platform workload installed.

      visual-studio-installer-uwp

    • All Windows SDKS 10.0.17763 or later must be selected (on the right side of the installer)

      visual-studio-installer-uwp

    • Mobile development with .NET (Xamarin) workload installed.

      visual-studio-installer-xamarin

      • The iOS Remote Simulator installed (for iOS development)
      • A working Mac with Visual Studio for Mac, Xcode 8.2 or later installed (for iOS development)
      • Google's Android x86 emulators or a physical Android device (for Android development)
    • ASP.NET and web workload installed, along with .NET 5.0 or 6.0 (for WebAssembly development)

      visual-studio-installer-web

    • .NET SDK

Note

For more information about these prerequisites, see Installing Xamarin. For information about connecting Visual Studio to a Mac build host, see Pair to Mac for Xamarin.iOS development.

Finalize your environment

  1. Open a command-line prompt, Windows Terminal if you have it installed, or else Command Prompt or Windows Powershell from the Start menu.

  2. a. Install the tool by running the following command from the command prompt:

    dotnet tool install -g uno.check
    

    b. To update the tool, if you already have an existing one:

    dotnet tool update -g uno.check
    
  3. Run the tool from the command prompt with the following command:

    uno-check
    
  4. Follow the instructions indicated by the tool

You can find additional information about uno-check here.

Installing the Uno Platform Solution Templates with Visual Studio

  1. Launch Visual Studio, then click Continue without code. Click Extensions -> Manage Extensions from the Menu Bar.

  2. In the Extension Manager expand the Online node and search for Uno Platform Templates, install the Uno Platform Solution Templates extension or download it from the Visual Studio Marketplace extension, then restart Visual Studio.

Create an application from the solution template

To easily create a multi-platform application:

  • Create a new C# solution using the Uno Platform App (Xamarin|UWP) template, from Visual Studio's Start Page: new project
  • Right-click on the Solution and select Manage NuGet Packages for Solution from the context menu.
  • Update to the latest NuGet package named Uno.UI.
  • To debug the iOS head, select the Debug|iPhoneSimulator configuration
  • To debug the Android head, select the Debug|Any CPU configuration
  • To debug the UWP head, select the Debug|x86 configuration
  • To run the WebAssembly (Wasm) head, select IIS Express and press Ctrl+F5 or choose Start without debugging from the Debug menu. To enable full debugging, see these debugging instructions.

You're all set! You can now head to our tutorials on how to work on your Uno Platform app.

Make sure XAML Intellisense is enabled

Intellisense is supported in XAML when the UWP head is active: xaml-intellisense

If XAML Intellisense isn't working on a freshly-created project, try the following steps:

  1. Build the UWP head.
  2. Close all XAML documents.
  3. Close and reopen Visual Studio.
  4. Reopen XAML documents.

Troubleshooting Visual Studio and Uno Platform Installation Issues

You may encounter installation and/or post-installation Visual Studio issues for which workarounds exist. Please see Common Issues we have documented.

If you're not sure whether your environment is correctly configured for Uno Platform development, running the uno-check command-line tool should be your first step.

Getting Help

If you continue experiencing issues with Uno Platform, please visit our GitHub Discussions or Discord - #uno-platform channel where our engineering team and community will be able to help you.