Get Started on Visual Studio 2022
This getting started will guide you through setting up your environment to create Uno Platform applications using C# and .NET with Visual Studio 2022.
If you want to use another environment or IDE, see our general getting started.
Install Visual Studio with Workloads
To create Uno Platform applications you will need Visual Studio 2022 17.8 or later:
ASP.NET and web development workload installed (for WebAssembly development)
.NET Multi-platform App UI development workload installed (for iOS, Android, Mac Catalyst development).
.NET desktop development workload installed (for Skia-based targets development)
Uno Platform 5.0 does not support Xamarin projects anymore. To build Xamarin-based projects in Visual Studio 2022, in Visual Studio's installer
Individual components tab, search for Xamarin and select
Xamarin Remoted Simulator. See this section on migrating Xamarin projects to .NET 6.
Check your environment
Open a command-line prompt, Windows Terminal if you have it installed, or else Command Prompt or Windows Powershell from the Start menu.
Setup uno.check by:
Installing the tool:
dotnet tool install -g uno.check
Updating the tool, if you previously installed it:
dotnet tool update -g uno.check
Run the tool from the command prompt with the following command:
Follow the instructions indicated by the tool.
Install the Uno Platform Extension
Launch Visual Studio 2022, then click
Continue without code. Click
Manage Extensionsfrom the Menu Bar.
In the Extension Manager expand the Online node and search for
Uno, install the
Uno Platformextension or download it from the Visual Studio Marketplace, then restart Visual Studio.
Additional Setup for Windows Subsystem for Linux (WSL)
It is possible to build and debug Skia+GTK projects under WSL, if you choose to do so.
To setup your environment for WSL:
- Install WSL Ubuntu 22.04 or later
- Install the prerequisites for Linux mentioned below, in your installed distribution using the Ubuntu shell
Running Uno Platform apps using WSL makes use of WSLg's support for Wayland.
Additional Setup for Skia+GTK projects
In order to run Skia+GTK heads, you will need to make sure to install the GTK3 runtime.
Once the GTK3 runtime is installed, you will need restart your IDE for the changes to take effect.
Now that you're done with setting up your environment, you can create your first Uno Platform app.