Maui Application Running IOS is Requiring XCode 26 and I am on XCode 16.4

krobine-2778 25 Reputation points
2025-11-17T19:18:32.07+00:00

My application that's been working using XCode 16.4 all of a sudden is requesting XCode 26. I'm getting the following error message in my application:

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

The problem is that I don't have Admin Priv's on that machine, and won't be able to upgrade to XCode 26.0 for several weeks. Also, I don't see an older version of Microsot.iOS.Sdk.Net9.0 located in /usr/local/share/dotnet/packs. If I do dotnet workload list, I have Manifest Version 9.0.111/9.0.100 with SDK 9.0.300

I tried using the following command (with my Admin).

sudo dotnet workload install maui --from-rollback-file https://aka.ms/dotnet/maui/9.0.110.json --source https://api.nuget.org/v3/index.json

But that failed "Workload installation failed" '<' is an invalid start of a value..

Any way I can get back to 16.4 without needing to upgrade to XCode 26?

Developer technologies | .NET | .NET MAUI
0 comments No comments
{count} votes

2 answers

Sort by: Most helpful
  1. Q&A Assist
    2025-11-17T19:18:57.2166667+00:00
    AI generated content. This question contains an answer created with AI from Q&A Assist. Learn more

    To resolve the issue of your .NET MAUI application requiring Xcode 26.0 while you are currently on Xcode 16.4, you have a couple of options:

    1. Install an Older Version of the Workload: Since you mentioned that you do not have admin privileges to upgrade to Xcode 26.0, you can try to install an older version of the Microsoft.iOS.Sdk that is compatible with Xcode 16.4. You can do this by using the command:
         dotnet workload install ios --version 9.0.203
      
      This command will install a specific version of the iOS workload that may not require Xcode 26.0.
    2. Check for Compatibility: You can check the release notes for the .NET MAUI version you are using to find out which versions of Xcode are supported. If you find that your current version of Xcode is supported, you may need to adjust your project settings or dependencies to align with that version.
    3. Use Different Versions of .NET for iOS: If you cannot install an older version of the workload, consider using a different version of .NET for iOS that is compatible with Xcode 16.4. You can check the .NET MAUI release versions for compatibility information.
    4. Contact Admin for Help: Since you mentioned that you do not have admin privileges, it may be beneficial to contact your system administrator for assistance in upgrading Xcode or installing the necessary workloads.

    If you continue to experience issues, reviewing the error messages and checking the compatibility of your installed workloads with the version of Xcode you have will be crucial.


    References:

    0 comments No comments

  2. Jack Dang (WICLOUD CORPORATION) 3,965 Reputation points Microsoft External Staff Moderator
    2025-11-18T08:34:31.1333333+00:00

    Hi @krobine-2778 ,

    Thanks for reaching out.

    The error you’re seeing occurs because the installed .NET for iOS workload requires a newer version of Xcode than what you currently have. This is expected behavior, and it is fully documented by Microsoft:

    https://learn.microsoft.com/dotnet/ios/troubleshooting/xcode-requirement

    Here are officially supported solutions

    1. Install an older workload version

    • If upgrading Xcode is not possible, you can use a version of the workload that supports your current Xcode (16.4).
    • Microsoft explicitly states this approach is supported:

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

    • Workload versions that correspond to each Xcode release are published in the macios GitHub release notes (you can check in the link above)
    • Example command to install a specific workload version:
    dotnet workload install ios --version <workload-set-version>
    

    Replace <workload-set-version> with the version from the release notes that supports Xcode 16.4.

    2. Upgrade Xcode

    • Install the version of Xcode the error message mentions (Xcode 26.0 in your case).
    • This is the simplest solution and fully supported.

    3. Optional: Use multiple Xcode versions

    • You can install multiple Xcode versions and switch between them with:
    
    sudo xcode-select --switch /Applications/Xcode_16.app
    
    
    • Or via Xcode → Settings → Locations → Command Line Tools.

    Important Notes

    • You do not need to uninstall existing workloads to use an older workload version.
    • Using a different Xcode version than the one officially supported may work, but it is not officially supported.
    • Microsoft only recommends aligning your workload version with the Xcode version or upgrading Xcode to match the workload.

    Hope this helps! If my answer was helpful - kindly follow the instructions here so others with the same problem can benefit as well.


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.