Create an app with Rider

Note

Make sure to setup your environment first by following our instructions.

Create the App

Important

Rider (2024.2 and above): For Rider (2024.2 and above), we have released a Preview version of the Uno Platform Plugin that supports creating Uno Platform projects using the "New Solution" dialog. Make sure to follow the directions for Rider 2024.2 provided below.
Rider (2024.1 and earlier): Current versions of Rider (2024.1 and earlier) do not support creating Uno Platform projects using the "New Solution" dialog, even if the Uno Platform project template appears. Make sure to follow the directions for Rider 2024.1 provided below.

Rider Version 2024.2+
Previous Rider Version 2024.1

Creating an Uno Platform project is done by following these steps:

On the Welcome to JetBrains Rider screen, click New Solution.
From the project types list on the left, locate and click Uno Platform App. It will be under the Uno Platform section.
Configure your new project by providing a solution name and a directory location.
Choose a template to build your application.

Tip

For a detailed overview of the Uno Platform project wizard and all its options, see the Wizard guide.
Click the create button and wait for the solution to load.
You should now have a folder structure that looks like this:

Creating an Uno Platform project is done using dotnet new and the Uno Platform Live Wizard by following these steps:

Open a browser and navigate to the Live Wizard.
Configure your new project by providing a project name, then click Start.
Choose a template to build your application.

Tip

For a detailed overview of the Uno Platform project wizard and all its options, see the Wizard guide.
Click the Create button on the top right corner, then click the Copy button.
In your terminal, navigate to the folder that will contain your new app.
Create a new project by pasting the command that was previously generated in the Live Wizard.
Open the solution in Rider, you should now have a folder structure that looks like this:

Tip

If you are not able to run the online Live Wizard, you can explore the dotnet new template directly in the CLI.

Important

A notification window will appear for the free registration of the extension. If the notification disappears before you can enter the license, you can find it again in the "Notification Bell" icon at the top right of the Rider window.

Considerations for macOS and Linux

When using macOS or Linux for developing your application and you have selected the WinAppSDK target, you may get the UNOB0014 error which mentions building on macOS or Linux is not supported. While Uno Platform is able to filter out unsupported targets from the command line and other IDE, Rider currently does not support this automatic filtering.

To correct this, you'll need to modify your csproj file in order to make the project compatible.

You can change this line:

<TargetFrameworks>net8.0-android;net8.0-ios;net8.0-maccatalyst;net8.0-windows10.0.19041;net8.0-browserwasm;net8.0-desktop</TargetFrameworks>

To be:

<TargetFrameworks>net8.0-android;net8.0-browserwasm;net8.0-desktop</TargetFrameworks>
<TargetFrameworks Condition=" $([MSBuild]::IsOSPlatform('windows')) ">$(TargetFrameworks);net8.0-windows10.0.19041</TargetFrameworks>
<TargetFrameworks Condition=" !$([MSBuild]::IsOSPlatform('linux')) ">$(TargetFrameworks);net8.0-ios;net8.0-maccatalyst</TargetFrameworks>

Make sure to adjust the list of target frameworks based on the platforms you have in your original list.

Debug the App

Select the MyUnoApp (Desktop) debug profile then click the green arrow or the debug button.

A view of the Rider taskbar for Desktop

Next Steps

Now that you're Created and Debug the App.

Learn more about:

Uno Platform features and architecture
Hot Reload feature
Uno Platform App solution structure
Troubleshooting
How-tos and Tutorials See real-world examples with working code.
Use the API Reference to Browse the set of available controls and their properties.