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
tonet10.0
, and fromnet9.0-*
tonet10.0-*
. - Clean your project by deleting the
bin
andobj
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.