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 versions of the Uno Platform Plugin that support 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.

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

  1. On the Welcome to JetBrains Rider screen, click New Solution.

    A screen showing the Welcome to JetBrains Rider screen

  2. From the project types list on the left, locate and click Uno Platform App. It will be under the Uno Platform section.

  3. Configure your new project by providing a solution name and a directory location.

  4. Choose a template to build your application.

    A screen showing the Uno Platform App Template

    Tip

    For a detailed overview of the Uno Platform project wizard and all its options, see the Wizard guide.

  5. Click the create button and wait for the solution to load.

  6. You should now have a folder structure that looks like this:

    A screen showing the structure of the solution in Rider

Important

A notification should appear prompting you to sign in or register with Uno Platform.

Signing in with your Uno Platform account in Rider unlocks powerful tools like Hot Reload, helping you speed up development.

With a single registration, you also gain early access to new features and the opportunity to connect with the Uno Platform community, where you can share feedback and network.

Detailed information on registration and sign-in is available here.

Uno Platform Sign in / Register notification

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: