doc/articles/create-an-app-rider.md
[!NOTE] Make sure to setup your environment first by following our instructions.
[!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:
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. [!NOTE] Starting with Uno.Sdk 6.0, Skia rendering is now the default rendering engine in Uno Platform templates for iOS/Android/WebAssembly. If you prefer native rendering instead, you can switch this setting in the
Featurestab underRenderer.
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 <a target="_blank" href="https://aka.platform.uno/app-wizard">Live Wizard</a>.
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, and 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 newtemplate directly in the CLI.
[!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 <a href="https://aka.platform.uno/account-access" target="_blank">here</a>.
When using macOS or Linux for developing your application and you have selected the WinAppSDK target, you may get the UNOB0014 error, which mentions that building on macOS or Linux is not supported. While Uno Platform is able to filter out unsupported targets from the command line and other IDEs, 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>net10.0-android;net10.0-ios;net10.0-windows10.0.26100;net10.0-browserwasm;net10.0-desktop</TargetFrameworks>
To be:
<TargetFrameworks>net10.0-android;net10.0-browserwasm;net10.0-desktop</TargetFrameworks>
<TargetFrameworks Condition=" $([MSBuild]::IsOSPlatform('windows')) ">$(TargetFrameworks);net10.0-windows10.0.26100</TargetFrameworks>
<TargetFrameworks Condition=" !$([MSBuild]::IsOSPlatform('linux')) ">$(TargetFrameworks);net10.0-ios</TargetFrameworks>
Make sure to adjust the list of target frameworks based on the platforms you have in your original list.
Select the MyUnoApp (Desktop) debug profile, then click the green arrow or the debug button.
Set the Android debug profile in the debugger toolbar, then click the green arrow or the debug button.
If you don't already have an emulator, you can create and manage one directly in Rider.
Install the Android plugin (if it isn’t already):
File → Settings → Plugins → Marketplace → search Rider Android Support → Install → restart Rider.Confirm Android SDK is set:
File → Settings → search Android SDK Location → make sure the SDK path is valid and components are installed.
Open Device Manager:
View → Tool Windows → Device Manager.Run your Uno app:
[!NOTE] Whether you're using a physical device or the emulator, the app will install but may not automatically open. You may have to manually open it.
[!IMPORTANT] To run WebAssembly with Rider, you will need to install one of the following browsers:
- Google Chrome
- Microsoft Edge (Chromium-based)
Select the MyUnoApp (WebAssembly) debug profile, then click the green arrow or the debug button.
A new browser window will automatically run your application.
[!IMPORTANT] If you get an "Error: Default system browser option is not supported for Blazor apps. Please select a Chromium-based browser." error message, you will also need to change the project configuration in Rider for WebAssembly, to ensure it uses either Chrome or Microsoft Edge. To do this, click on the TFMs dropdown to access the Edit Configuration option. Then navigate to WebAssembly, and change the browser setting from 'Default' to 'Chrome' or 'Edge'.
[!IMPORTANT] There is currently a known issue with Rider version 2024.2 on macOS that causes an 'Access to localhost was denied' error when launching applications on WebAssembly. Until this issue is resolved, you will need to reload the browser page to successfully load the application. Please refer to this open related Rider issue to track progress on this issue we are prioritizing with the JetBrains team.
[!NOTE] There is no debugging for WebAssembly within Rider for Uno Platform, but you can debug using the built-in Chrome tools.
Select the MyUnoApp debug profile with the mobile Apple logo, then click the green arrow or the debug button.
Debugging iOS apps on Rider for Mac works directly with a local simulator or connected device.
Starting with Rider 2026.1, you can build, deploy, and debug iOS apps from Windows via a remote Mac build host. Rider automatically verifies that the Mac has the correct macOS version, Xcode, .NET SDK, and required workloads and can install missing components automatically.
Since Uno Platform uses the same .NET iOS toolchain as MAUI, this capability works with Uno Platform projects out of the box.
Setup steps:
Next to the MyUnoApp debug profile with the mobile Apple logo, you have the Connect to Mac... button in the toolbar:
By clicking on it, it will open the Remote Mac Computers dialog. Click + and enter your Mac's IP address or hostname, then click OK and Connect. Rider will connect over SSH (make sure Remote Login is enabled on your Mac under System Settings > General > Sharing).
Once connected, Rider verifies the remote environment and installs any missing components. Press Run or Debug to deploy to the selected simulator or device.
If you see an "Invalid Codesign Key" dialog when running, click Set Codesign Key... to open Project Properties > iOS > Bundle Signing, then set Signing identity to Developer (Automatic).
Select the MyUnoApp (WinAppSDK Unpackaged) debug profile, then click the green arrow or the debug button.
[!NOTE] Debugging Windows App SDK profile is only supported on Windows.
Now that you're Created and Debug the App.
Learn more about: