Get Started on Visual Studio

Prerequisites

  • Visual Studio 2019 16.3 or later, with:

    • Universal Windows Platform workload installed.

    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 Core 2.2 (for WASM development)

    visual-studio-installer-web

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.

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 Cross-Platform App (Uno Platform) template, from Visual Studio's Start Page:

new project

  • Update to the latest NuGet package named Uno.UI. To get the very latest features, check the pre-release box.
  • To debug the iOS head, select the Debug|iPhoneSimulator configuration
  • To debug the Android head, select the Debug|AnyCPU 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 menu. Note that F5 will not work because Visual Studio debugging isn't supported. See here for debugging instructions through Chrome.

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.

Video Tutorial

Getting Started Visual Studio Video

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.

Getting Help

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