How to upgrade from .NET 8 to .NET 9

Migrating from .NET 8 to .NET 9 is a generally straightforward process. You may find below some specific adjustments to make to your projects and libraries when upgrading.

To upgrade to .NET 9:

• First, read What's New in .NET 9
• Install/Update the IDE of your choice:
  • Visual Studio 2022 - minimal version 17.12 or later
  • Visual Studio Code - minimal version 1.94 or later with the related C# Dev Kit stable version
  • JetBrains Rider - minimal version 2024.3 or later
• Run uno.check to install .NET 9.
• Change all your target framework (TFM) references from net8.0 to net9.0, and net8.0-* to net9.0-*.
• Delete your bin and obj folders

Considerations for WebAssembly

WebAssembly support for .NET 9 has made significant internal changes to use the official .NET SDK. Read the following documentation for WebAssembly migrations.