How to Upgrade from .NET 9 to .NET 10

Migrating from .NET 9 to .NET 10 is a generally straightforward process. Below are some specific adjustments you may need to make to your projects and libraries when upgrading.

To upgrade to .NET 10:

First, read What's New in .NET 10.
Use .NET 10 RC1 along with:
- Visual Studio - the latest version of Visual Studio 2026 Insiders, as recommended by Microsoft in their announcement. Use version 18.0.0 [11104.47] or later to ensure compatibility with the latest stable Uno Platform extension.
- Visual Studio Code - the latest version of Visual Studio Code and the C# Dev Kit extension, also recommended by Microsoft in the same announcement.
- Rider - the latest stable version, as .NET 10 support has been available since Rider 2025.1.
Run the latest stable version of uno.check with the --pre-major parameter to install .NET 10.
Uno Platform provides an updated Visual Studio extension in the store that supports Visual Studio 2026 and the new .slnx solution format.
Change all your target framework (TFM) references from net9.0 to net10.0, and from net9.0-* to net10.0-*.
Clean your project by deleting the bin and obj folders.

Known Issues

For an up-to-date list of known issues when using .NET 10 with Uno Platform, please refer to our Health Status page.