I get this error in Visual Studio after updating macOS and Xcode: This version of .NET for iOS (26.0.11017) requires Xcode 26.0. The current version of Xcode is 27.0.

Question

I get this error in Visual Studio after updating macOS and Xcode: This version of .NET for iOS (26.0.11017) requires Xcode 26.0. The current version of Xcode is 27.0.

Mr_K 0

I get this error in Visual Studio Community 18.12.0 after updating macOS(27.2.1) and Xcode(27.0):

This version of .NET for iOS (26.0.11017) requires Xcode 26.0. The current version of Xcode is 27.0. Either install Xcode 26.0, or use a different version of .NET for iOS. See https://aka.ms/xcode-requirement for more information.

I use the following settings for my iOS project in Visual Studio:

Target framework: .NET 10.0

Target OS: 26.0

Supported OS version: 18.0

And I installed the NuGet packages Microsoft.Maui.Controls(11.0.0), Microsoft.Maui.Core(11.0.0) and Microsoft.Maui.Essentials(11.0.0) today in my iOS project.

PS C:\MyProjects\TestProject> dotnet --list-sdks 9.0.306 [C:\Program Files\dotnet\sdk] 9.0.308 [C:\Program Files\dotnet\sdk] 11.0.100 [C:\Program Files\dotnet\sdk]

PS C:\MyProjects\TestProject> dotnet workload list
Workload version: 11.0.100-manifests.5d612b92
Installed Workload Id      Manifest Version         Installation Source
----------------------------------------------------------------------------------------
android                    37.2.29/11.0.100         VS 18.12.12405.243, VS 17.14.36717.8
ios                        27.2.11039/11.0.100      VS 18.12.12405.243, VS 17.14.36717.8
maccatalyst                27.2.11039/11.0.100      VS 18.12.12405.243, VS 17.14.36717.8
maui-windows               11.0.0/11.0.100          VS 18.12.12405.243, VS 17.14.36717.8

How can I solve the issue? Is it not yet possible to use Xcode 27.0 for debugging my iOS project?

0 comments

2 answers

Your answer

Answer 1

Bruce (SqlWork.com) 85,786

As you updated MacOs to Golden Gate, Xcode 26 is not supported. You will need to update your Maui workload to 10.0.100 or higher for Xcode 27 support.

also read the release notes as Xcode 27 support requires source code changes.

https://devblogs.microsoft.com/dotnet/migrate-dotnet-maui-apps-uikit-scene-lifecycle/

The lastest Maui 10 and 11 releases require Xcode 27.2

0 comments

Answer 2

Yes. The error is a toolchain mismatch: the build is using .NET for iOS 26.0.11017, which was validated for Xcode 26.0, while the Mac now has Xcode 27.0 selected.

The supported fixes are:

Install the Xcode version required by the error
- Install Xcode 26.0 alongside Xcode 27.0.
- Then select the required Xcode on the Mac with:
```
     xcode-select --switch <path-to-Xcode-26.0>
```
- This is the simplest supported path when the error explicitly names the required Xcode version.
Use a .NET for iOS workload version that supports Xcode 27.0
- Each .NET for iOS workload requires a specific Xcode version.
- The exact supported Xcode version for a workload is listed in the release notes.
- If support for Xcode 27.0 has been released, install the matching workload set version.
If Visual Studio is pointing to an old or removed Xcode path, reset Xcode selection on the Mac
- Delete these files if they exist:
  - ~/Library/Preferences/Xamarin/Settings.plist
  - ~/Library/Preferences/maui/Settings.plist
- Then either:
  - run xcode-select --switch ..., or
  - set DEVELOPER_DIR to the intended Xcode path.

Important details for this case:

The installed CLI workloads shown in dotnet workload list are 27.2.11039/11.0.100, but the error mentions 26.0.11017. That indicates Visual Studio is building with an older .NET for iOS toolchain than the one shown in the command-line output.
Updating macOS and Xcode alone can trigger this problem because newer Xcode versions often require matching newer workloads.
Using a different Xcode version than the one required may work in limited cases, but it is not supported.
As a temporary workaround only, the Xcode version check can be skipped by setting this in the project file:
```
  <ValidateXcodeVersion>false</ValidateXcodeVersion>
```
This is not a supported long-term fix.

For immediate debugging reliability, the lowest-risk option is to install Xcode 26.0 alongside Xcode 27.0 and switch to it when building this project.

References: