Issue with running MAUI project iOS version on Visual Studio code

Sreenivasan, Sreejith 925 Reputation points
2026-06-29T14:22:56.4366667+00:00

I am facing below error:

error This version of .NET for iOS (26.5.10284) requires Xcode 26.5. The current version of Xcode is 26.6. Either install Xcode 26.5, or use a different version of .NET for iOS. See https://aka.ms/xcode-requirement for more information. Build failed with 1 error(s) and 2970 warning(s) in 7.8s

This was working fine till yesterday and today onwards this issue starts. Is there any background update happen for this issue?

My xcode version is 26.6 (17F113).

dotnet --version: 10.0.301

dotnet workload list:

Workload version: 10.0.301.1

Installed Workload Id Manifest Version Installation Source

android 36.1.69/10.0.100 SDK 10.0.300

ios 26.5.10284/10.0.100 SDK 10.0.300

maui 10.0.20/10.0.100 SDK 10.0.300

maui-android 10.0.20/10.0.100 SDK 10.0.300

maui-ios 10.0.20/10.0.100 SDK 10.0.300

The previous version was 10.0.300. I have updated to 301 after this issue occurs. I thought 301 version will support xcode 26.6. But inside androi, ios and all other SDK are still 300. So how we can fix this issue? Or do I need to downgrade xcode version?

Developer technologies | .NET | .NET Multi-platform App UI
0 comments

Answer accepted by question author

Nancy Vo (WICLOUD CORPORATION) 6,595 Reputation points Microsoft External Staff Moderator
2026-06-30T06:15:19.65+00:00

Hello @Sreenivasan, Sreejith ,

Thanks for your question.

Yes, if you have automatic updates enabled on your Mac, your system likely updated Xcode in the background.

The underlying SDK in Xcode 26.6 is exactly the same as 26.5. There are no breaking changes to worry about; it is just a strict version check getting in the way.

You can refer to these following workarounds:

  1. Since the underlying Apple code is the same, you can just tell your project to ignore the version check.
  • Open your main MAUI project file (the .csproj file).
  • Find the first <PropertyGroup> tag.
  • Add this line inside of it: <ValidateXcodeVersion>false</ValidateXcodeVersion>
  • Save the file and rebuild your project.
  1. Use the older Xcode alongside the new one.

If you prefer not to change your project code, you can run both versions of Xcode on your Mac.

  • Download Xcode 26.5 from the Apple Developer site.
  • Unzip it, rename it to something like Xcode_26.5.app, and move it to your Applications folder.
  • Open your Mac Terminal and point your system to the older version by running: sudo xcode-select -s /Applications/Xcode_26.5.app
  • Rebuild your project.

I hope this addresses your question. If this response was helpful, please consider following the guidance to provide feedback.

Was this answer helpful?

1 person found this answer helpful.
0 comments

Answer accepted by question author

Bruce (SqlWork.com) 84,251 Reputation points
2026-06-29T14:40:20.9633333+00:00

Maui always lags in Xcode and iOS sdk support. In this case 26.6 is a change to Xcode only, so Maui will work. You need to disable Xcode version checking. See:

https://github.com/dotnet/macios/issues/25658

note: the best option is to not upgrade Xcode before Maui publishes support, or install updates side by side.

Was this answer helpful?

1 person found this answer helpful.
0 comments

0 additional answers

Sort by: Most helpful
Most helpful Newest Oldest

Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.