Build and run Maui app from dotnet cli on mac

Question

Build and run Maui app from dotnet cli on mac

Brad Rice 20

I have dotnet 10 installed on my mac. Running dotnet --version yields this:

10.0.100-rc.1.25451.107

I have also installed the sdk, but when I run

dotnet build -t:Run -f net10.0-ios

I get this error:

MyMauiApp net10.0-ios failed with 1 error(s) (0.2s)

/usr/local/share/dotnet/packs/Microsoft.iOS.Sdk.net10.0_18.5/18.5.10727-net10-rc.1/targets/Xamarin.Shared.Sdk.targets(2330,3): error This version of .NET for iOS (18.5.10727-net10-rc.1) requires Xcode 16.4. The current version of Xcode is 26.0. Either install Xcode 16.4, or use a different version of .NET for iOS. See https://aka.ms/xcode-requirement for more information.

It was my understanding the dotnet 10 was compatible with current Xcode studio. Can anyone help?

2 answers

Your answer

Answer 1

Michael Le (WICLOUD CORPORATION) 5,930 Microsoft External Staff Moderator

Hello Brad,

Thank you for reaching out.

The error message you are receiving points directly to a version incompatibility. As it states:

This version of .NET for iOS (18.5.10727-net10-rc.1) requires Xcode 16.4. The current version of Xcode is 26.0.

This happens because each version of the .NET for iOS SDK is built to work with a specific version of Apple's native toolchain (Xcode). Your current .NET SDK is a release candidate (rc.1) that was specifically paired with Xcode 16.4.

But .NET 10 is out now, so you shouldn’t run into this issue anymore with Xcode 26. For the best experience with .NET 10, I’d suggest using Visual Studio 2026.

I hope this helps.

Brad Rice 20 Reputation points

2025-09-30T20:50:22.7766667+00:00

I guess dotnet maui for mac is not ready for prime time. It seems like an awful large ask to downgrade my xcode from 26 to 16, especially since I use Xcode for mobile development on another platform than maui. I was just ask to assess if we could move our code to maui. It seems windows is still the only platform for modern maui development.
Michael Le (WICLOUD CORPORATION) 5,930 Reputation points Microsoft External Staff Moderator

2025-10-01T02:09:17.8366667+00:00

Thank you for understanding. I would really appreciate it if you could confirm the answer, just in case others are experiencing the same issue.
Michael Le (WICLOUD CORPORATION) 5,930 Reputation points Microsoft External Staff Moderator

2025-10-15T10:23:32.8033333+00:00

Hello @Brad Rice ,

It's been a while since I last heard from you. Hope things are going well.

If you're still interested or have any questions, I’d be happy to help. Feel free to reach out whenever it works best for you.
Brad Rice 20 Reputation points

2025-10-15T15:24:58.2+00:00

I was still unable to get dotnet maui to compile using mac with Xcode 26. That is my goal with this ticket. When I google this, it says it is possible. I saw one result that said I needed to be on dotnet 10 rc, but that isn't working. I saw another that I had to be on dotnet 9. I am able to run a sample app to the android emulator using the dotnet cli. I want to be able to do that with ios Simulator.
Michael Le (WICLOUD CORPORATION) 5,930 Reputation points Microsoft External Staff Moderator

2025-10-20T07:21:27.2066667+00:00

Thank you for following up. .NET 10.0 RC 2 is out a few days ago, so I recommend updating to this latest release.
Brad Rice 20 Reputation points

2025-10-31T20:23:01.1133333+00:00

Thank you Michael Le, that works with my current version of Xcode 26
Michael Le (WICLOUD CORPORATION) 5,930 Reputation points Microsoft External Staff Moderator

2025-11-03T02:42:20.6166667+00:00

Thank you for your response. I’m glad it works. If you have any other questions, feel free to reach out anytime.

Also, .NET MAUI 10 is scheduled for release this month, so make sure you’re prepared when the time comes.

Answer 2

From the document Xcode requirement, we could find that :

A new version of a workload might require a different version of Xcode. This typically happens whenever Apple releases a new version of Xcode: soon afterwards we release new versions of the workloads, supporting the new version of Xcode. Updating the workloads will thus end up requiring a new version of Xcode.

This often manifests with a build error like the problem you are encountering.

The simplest solution is typically to upgrade to the version of Xcode the error message mentions.

It's also possible to install an older version of the corresponding workload to avoid having to upgrade Xcode.

In some cases the newer version of Xcode also requires updating to a newer major version of macOS (this generally occurs around April every year). If the new macOS version isn't supported on the developer's current hardware, the only option is to use an older version of the workload (or get new hardware).

Share via

Build and run Maui app from dotnet cli on mac

2 answers

Your answer