Get Started on JetBrains Rider

Important

As of Rider 2023.3, the Uno Platform 5.2 net8.0-browserwasm and net8.0-desktop TargetFrameworks are not supported. See this JetBrains article for more details. In the meantime, use our VS Code support or use Uno Platform 5.1 templates as described later in this tutorial.

Prerequisites

Rider Version 2023.3+
Rider Xamarin Android Support plugin from Rider in Settings / Plugins

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:
```
uno-check
```
Follow the instructions indicated by the tool.

Open a Terminal.
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:
```
uno-check
```
If the above command fails, use the following:
```
~/.dotnet/tools/uno-check
```
Follow the instructions indicated by the tool

Open a Terminal
If dotnet --version returns command not found:
- Follow the official directions for installing .NET.
  
  Important
  
  If your distribution is Ubuntu and you want to develop for Android, make sure to use the directions to install the Microsoft feed and not the Ubuntu official feed. The latter does not contain Android workloads.
Then, 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:
```
uno-check
```
If the above command fails, use the following:
```
~/.dotnet/tools/uno-check
```
Follow the instructions indicated by the tool

You can find additional information about uno-check here.

Supported Platforms

	Rider for Windows	Rider for Mac	Rider for Linux
Windows (UWP/WinUI)	✔️	❌	❌
Android	✔️	✔️	❌†
iOS	✔️†	✔️	❌
Wasm	✔️†	✔️†	✔️†
Catalyst	❌	✔️	❌
Skia Desktop	❌†	❌†	❌†

† Notes (Click to expand)

WebAssembly: debugging from the IDE is not available yet on Rider. You can use the Chromium in-browser debugger instead.
iOS on Windows: An attached Mac is needed, the iOS simulator will open on the Mac.
Android on Linux: Xamarin.Android does not natively support Linux development. Rider has been capable of Android development on Linux in the past, but previous directions are considered obsolete. As of this comment (3 Nov 2021) Xamarin Android builds on Linux fail.
Skia Desktop on all platforms: As of Rider 2023.3, the Uno Platform 5.2 net8.0-browserwasm and net8.0-desktop TargetFrameworks are not supported. See this JetBrains article for more details. In the meantime, use our VS Code support or use Uno Platform 5.1 templates as described later in this tutorial.

Platform specific setup

You may need to follow additional directions, depending on your development environment.

Linux

Install the required dependencies:

sudo apt update
sudo apt-get install mesa-utils libgl1-mesa-glx ttf-mscorefonts-installer dbus libfontconfig1 libxrandr2

Update system and packages
```
pacman -Syu
```

Install the necessary dependencies

sudo pacman -S dotnet-targeting-pack dotnet-sdk dotnet-host dotnet-runtime python ninja gn aspnet-runtime dbus libxrandr

You may also need to install the Microsoft fonts manually.

If you are using Windows Subsystem for Linux (WSL), you can find specific instructions in the following video:

Next Steps

You're all set! You can create your first Uno Platform app.