Move from .Net 9 to .Net 10 in Maui using maccatalyst

Question

Dani_S 5,261

Hi,

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

using maccatalyst

Please provides all the steps of upgrades?

Thanks,

Answer accepted by question author

1 additional answer

Answer 1

Michael Le (WICLOUD CORPORATION) 7,785 Microsoft External Staff Moderator

Hello @Dani_S ,

The general process would be similar to Visual Studio, but with .NET CLI commands.

Make sure to download Xcode 26 and back up your project before making changes.

Please follow these steps:

Install .NET 10 SDK for macOS from the official .NET website. After installing, check it with dotnet --version. It should display 10.x.x.

Install the required workloads:

   dotnet workload install maui 
   dotnet workload install maccatalyst

Confirm with dotnet workload list.

Update your csproj file to target .NET 10:

   <TargetFrameworks>net10.0-maccatalyst</TargetFrameworks>

Update NuGet packages using dotnet list package --outdated. Then restore packages with dotnet restore.
Clean bin and obj folders
Rebuild your project with dotnet build.
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.

I hope this clarifies.

Dani_S 5,261 Reputation points

2025-11-20T06:36:02.77+00:00

I'm using vs code? can you update your answer please? I'm developing on Mac.
Michael Le (WICLOUD CORPORATION) 7,785 Reputation points Microsoft External Staff Moderator

2025-11-20T07:43:17.5066667+00:00

Hello, I have updated my answer.
Dani_S 5,261 Reputation points

2025-11-20T08:15:25.7633333+00:00

No need to update SupportedOSPlatformVersion for macatalist?
Michael Le (WICLOUD CORPORATION) 7,785 Reputation points Microsoft External Staff Moderator

2025-11-20T08:28:17.16+00:00
Yes, it should be no problem with the current default version.

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

Answer 2

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

Install .NET 10: Ensure you have the .NET 10 SDK installed. You can download it from the official .NET website.
Update Project File: Open your app's project file (.csproj) and change the Target Framework Monikers (TFMs) from .NET 9 to .NET 10. For Mac Catalyst, you will change the TFM to net10.0-maccatalyst. Your project file should look like this:
```
   <TargetFrameworks>net10.0-android;net10.0-ios;net10.0-maccatalyst</TargetFrameworks>
```
Update NuGet Packages: If your app references any NuGet packages, ensure that they are updated to their .NET 10 versions. This includes updating any references to Microsoft.Maui.Controls and other related packages.
Update Build Properties: If your app targets Mac Catalyst, ensure that the $(SupportedOSPlatformVersion) build property is set to the appropriate version for .NET 10. For example:
```
   <SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'maccatalyst'">18.2</SupportedOSPlatformVersion>
```
Clean and Rebuild: Before building your upgraded app for the first time, delete the bin and obj folders to ensure a clean build. Then, rebuild your project.
Address Deprecated APIs: Review any build warnings regarding deprecated APIs and address them as necessary.
Test Your App: After upgrading, thoroughly test your app to ensure that everything functions correctly with the new framework version.

By following these steps, you should be able to successfully upgrade your .NET MAUI app from .NET 9 to .NET 10 on Mac Catalyst.