Move from .Net 9 to .Net 10 in Maui

Question

Hi,

I have app in .Net 9 in Maui, how I move to to .Net 10.

Please provides all the steps of upgrades?

Thanks,

Answer 1

Hello @Dani_S ,

Since targeting .NET 10 is only officially supported in Visual Studio 2026 and later version, you need to download Visual Studio 2026 from the official Microsoft website: https://visualstudio.microsoft.com/downloads/

If you are developing for iOS/Mac, you need to install Xcode 26.

To update your project to target .NET 10, follow these steps:

1. Open your project in VS 2026.
2. Open .csproj file.
3. Change the <TargetFramework> element to net10.0 like this:

       <TargetFrameworks>net10.0-android;net10.0-ios;net10.0-maccatalyst</TargetFrameworks>
       <TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('windows'))">$(TargetFrameworks);net10.0-windows10.0.19041.0</TargetFrameworks>
   

   For Android, while API 21 is still supported in .NET 10, it's recommended to update existing projects to API 24 to avoid unexpected runtime errors.

      <SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'android'">24.0</SupportedOSPlatformVersion>
   

4. Update NuGet packages: Tools > NuGet Package Manager > Manage NuGet Packages for Solution... > Updates tab.
5. Check workloads and SDKs: Tools > Get Tools and Features to ensure you have the latest .NET 10 SDKs installed, you can check the output of dotnet workload list.
6. Replace all deprecated APIs in your code, refer to https://learn.microsoft.com/en-us/dotnet/maui/whats-new/dotnet-10?view=net-maui-10.0
7. Delete bin and obj folders from your project directory.
8. Rebuild your project: Build > Rebuild Solution.

I hope this clarifies things.

Answer 2

To upgrade your .NET MAUI app from .NET 9 to .NET 10, follow these steps:

1. Install .NET 10: Ensure that you have .NET 10 installed along with the .NET MAUI workload. You can do this using Visual Studio or the standalone installer.
2. Update Project File: Open your app's project file (.csproj) and change the Target Framework Monikers (TFMs) from 9 to 10. For example, if your project file currently has:

      <TargetFrameworks>net9.0-android;net9.0-ios;net9.0-maccatalyst;net9.0-tizen</TargetFrameworks>
   

   Update it to:

      <TargetFrameworks>net10.0-android;net10.0-ios;net10.0-maccatalyst;net10.0-tizen</TargetFrameworks>
   

3. Update NuGet Packages: If your project references any NuGet packages, ensure that you update them to their .NET 10 versions. This includes packages like Microsoft.Maui.Controls and Microsoft.Extensions.Logging.Debug.
4. Adjust Build Properties: If your app targets specific platforms like iOS or Mac Catalyst, update the $(SupportedOSPlatformVersion) build properties for these platforms to the appropriate version for .NET 10.
5. Clean and Rebuild: Before building your upgraded app, delete the bin and obj folders to avoid any conflicts. Then, rebuild your project.
6. Update XAML Compiler Warnings: If you have any XAML compiler warnings, ensure that you update the relevant build properties in your project file to match any changes in the compiler error codes.
7. Test Your App: After upgrading, thoroughly test your app to ensure that everything works as expected with the new framework version.

Following these steps will help you successfully upgrade your .NET MAUI app from .NET 9 to .NET 10.