dotnet workload install fetches outdated maui-ios version, forcing Xcode downgrade

[TimBarton]

Description

On a clean macOS system with the latest version of Xcode (e.g., 26.3), running dotnet workload install maui for the .NET 10 SDK (10.0.103) downloads an outdated version of the maui-ios workload (specifically, one that requires Xcode 26.2).

This forces an immediate build failure with the error: error: This version of .NET for iOS (26.2.10197) requires Xcode 26.2. The current version of Xcode is 26.3.

The issue seems to be with the workload manifests being delivered to the installer, likely due to a regional CDN caching problem, as no amount of local troubleshooting resolves the issue.

Steps to Reproduce

Steps to Reproduce

Start with a clean macOS system with Xcode 26.3 installed.

Install the latest official .NET 10 SDK (e.g., 10.0.103 Arm64).

Run dotnet workload install maui.

Observe the installed workloads. It installs the Microsoft.iOS.Sdk.net10.0_26.2 pack (version 26.2.10197).

Try to build any .NET 10 MAUI project targeting iOS.

The build fails with the Xcode version mismatch error.

Troubleshooting Steps Attempted (All Failed)

We have exhaustively tried to resolve this locally, proving the issue is likely external. All of the following failed to solve the problem:

Running dotnet workload repair.

Running dotnet workload update (with and without --source nuget.org).

Manually deleting bin and obj folders.

Manually deleting ~/.dotnet, /usr/local/share/dotnet, and all global.json files.

Performing a complete uninstallation and reinstallation of all .NET SDKs multiple times.

Verifying no DOTNET_ environment variables or custom nuget.config files exist.

The only workaround was to manually downgrade Xcode to match the outdated workload version, which is not a sustainable solution.

Workload version: 10.0.103

Installed Workload Id Manifest Version Installation Source

maui 10.0.20/10.0.100 SDK 10.0.100

Link to public reproduction project repository

No response

Version with bug

10.0.20

Is this a regression from previous behavior?

Yes, this used to work in .NET MAUI

Last version that worked well

10.0.20

Affected platforms

macOS

Affected platform versions

No response

Did you find any workaround?

downgrading

Relevant log output

[Moritz-Karrasch]

The same error here.

Unfortunately, after every XCode update, there are problems with .NET MAUI.

[johannes-steurer]

same here. very annoying as this happens on a regular basis

[MitchBomcanhao]

xcode 26.3 was released only a few days ago.
the dotnet sdk you're using is almost a month old.

rule of thumb - only update xcode when the relevant dotnet version (and supporting bits) has been updated.
you claim that an outdated workload is downloaded - saying that implies a newer one exists. Does one even exist?

[AlleSchonWeg]

Golden rule for Mac:
Disable automatic updates. Ever!!!

[bdizzleog]

Just download xcode 26.2 and then turn off automatic updates:

https://developer.apple.com/download/more/

[jfversluis]

To make managing Xcode versions easier, look into Xcodes, notice the s at the end. We will always be behind on the Xcode versions, even if it's just one day. Indeed disable automatic updates and have a look at https://github.com/dotnet/macios/releases for the latest Xcode that is supported at this time.

Closing this as there is not much we can do here, and this is certainly not a MAUI SDK issue.

[davidwasserman]

Try putting the following in your .csproj file. Note that this may not be best practice and I'd only use it temporarily until the .NET framework has caught up. It did work for me though.

<PropertyGroup>
  <ValidateXcodeVersion>false</ValidateXcodeVersion>
</PropertyGroup>

[bearyung]

Try putting the following in your .csproj file. Note that this may not be best practice and I'd only use it temporarily until the .NET framework has caught up. It did work for me though.

<PropertyGroup>
  <ValidateXcodeVersion>false</ValidateXcodeVersion>
</PropertyGroup>

It is a nice hack! at least for the minor Xcode version changes (e.g. 26.2 -> 26.3) i think there will have no breaking changes which mandatory Xcode update is required.

[alvinchesaro]

false

This actually works! Thank you @davidwasserman.

[rpatuelli]

Great hack, thanks @davidwasserman. I have Visual Studio 2026 (18.4.3) which was expecting Xcode version 26.2, but my Mac Server is running version 26.4. I tested it on the simulator and deployed the app to the store without any problems. I can't disable updates on the Mac Server; I have a rental user.