Xcode 26.2 Support

[rolfbjarne]

✅ Checklist

Xcode X.Y

• Create new milestone in GitHub.
• Create a new issue with a copy of this list, assign it to the milestone.

Beta 1

• Update binding status in wiki (read instructions in the Makefile in the wiki's git repository)
• Create a new xcodeX[.Y] branch - this needs deciding where to branch from (which is outside the scope of this document). Push this branch to origin with no changes.
• Create PR with an Xcode bump.
  • Update the following values in Make.versions:
    • *_NUGET_OS_VERSION
  • Update the following values in Make.config:
    • XCODE_VERSION
    • XCODE_URL
    • XCODE_DEVELOPER_ROOT
  • Update the xcodeChannel value in tools/devops/automation/templates/variables/common.yml. Change to Beta if using an Xcode beta or release candidate, and switch back to Stable with the final (stable) Xcode release.
  • Add the new OS versions to the builds/Version-*.plist.in files.
  • Build and fix any issues.
  • Run the following tests locally, and fix any issues (these are the ones that typically fail in Xcode bumps, but there may be other failing tests as well - CI will report any such failures once the PR is created):
    • xtro
    • monotouch-test
    • introspection
    • cecil
    • bgen
• Bind APIs!

Beta X

• Update binding status in wiki.
• Create PR with an Xcode bump.
  • Build and fix any issues.
  • Run the following tests locally, and fix any issues (these are the ones that typically fail in Xcode bumps, but there may be other failing tests as well - CI will report any such failures once the PR is created):
    • xtro
    • monotouch-test
    • introspection
    • cecil
    • bgen
• Update any existing API bindings PRs if needed.
• Bind APIs!

Pre-release process

This happens after the stable version of Xcode has been released and the xcodeX[.Y] branch has been updated according to the previous section(s).

• Make sure all the PRs targeting the xcodeX[.Y] branch have been merged and no more changes are desired for the release.
• Merge the xcodeX[.Y] branch into main.
• Merge main into the target release branch (for instance this was release/9.0.1xx for the Xcode 16.4 release).
• Review the API diff to make sure all api differences are expected.
• Make sure the release branch created packages after the merge and pushed them to maestro.
• Create VS insertion (this may not happen for all releases, sometimes we release only to NuGet).
• Let MAUI know about our new package names, so they can update their darc dependencies. For instance, these dependencies: https://github.com/dotnet/maui/blob/408a1cc69d6a120cafa4e75ae30411f1ec48fa3a/eng/Version.Details.xml#L15-L30 would have to be updated to net9.0_18.5 or net9.0_15.5 for our Xcode 16.4 release.

Release process

• Write release notes.
• Publish NuGets to nuget.org.
• Publish release notes.
• Update API diff (the STABLE_NUGET_VERSION_* variables in Make.config). Can only be done after the NuGets have been published to nuget.org.
  • [apidiff] Update reference/stable versions to .NET 10 / Xcode 26.2. #24463
• Update docs by executing docs/sync-mobile-docs.sh. Beware if docs were modified in the docs-mobile repository by somebody else, any such changes will have to be copied back first.
  • Update build properties for the latest .NET 10 (Xcode 26.2) release. docs-mobile#94
• Update API / reference docs. See update-api-docs.md for instructions.
  • New monikers: https://dev.azure.com/msft-skilling/Content/_workitems/edit/506430
  • https://github.com/dotnet/macios-api-docs/pull/17
  • https://apidrop.visualstudio.com/binaries/_git/binaries/pullrequest/2199
• Make sure all items in the milestone for the current release have been closed.
• Close this issue & close the milestone.
• Wonder about life as you consider the impossibility of actually reaching this point, because you can't close the milestone before all issues have been closed, and you can't close this issue until checking off all items, which you can't do until you've closed the milestone. Decide to schedule yet another viewing of Life of Brian to cope celebrate the release 🍾.

[thedee]

Currently get this error on the pipeline:

error : This version of .NET for iOS (26.2.10191) requires Xcode 26.2. The current version of Xcode is 26.1.1. Either install Xcode 26.2, or use a different version of .NET for iOS. See https://aka.ms/xcode-requirement for more information. [/Users/runner/work/1/s/XXX/XXX/XXX.csproj::TargetFramework=net10.0-ios]

[rolfbjarne]

@thedee yes, we released support for Xcode 26.2 yesterday. Does it work if you use Xcode 26.2? If you want to keep using Xcode 26.1, you can pin the workloads to the previous version (10.0.101) as described in the release notes for the Xcode 26.1 release: https://github.com/dotnet/macios/releases/tag/dotnet-10.0.1xx-xcode26.1-10502

[thedee]

@rolfbjarne I am using vmImage of macos-15 and here is the list of Xcode version it shows is available. I do not see 26.2.

Xcode_16.0.0.app
Xcode_16.0.app
Xcode_16.1.0.app
Xcode_16.1.app
Xcode_16.2.0.app
Xcode_16.2.app
Xcode_16.3.0.app
Xcode_16.3.app
Xcode_16.4.0.app
Xcode_16.4.app
Xcode_16.app
Xcode_26.0.1.app
Xcode_26.0.app
Xcode_26.1.1.app
Xcode_26.1.app
Xcode.app
/Applications/Xcode_16.4.app/Contents/Developer
Xcode 16.4
Build version 16F6

[seth-govalidate]

@thedee 26.2 isn't installed in macos-15. It looks like it won't be available for some time too. I assume you are on Azure Devops. If you're on Github Actions, it will be availableon macos-26 soon.

[LeonHuertaG]

I got this error:
This version of .NET for iOS (26.0.9752) requires Xcode 26.0. The current version of Xcode is 16.4, and after updating mac and xcode it changed to this: This version of .NET for iOS (26.0.9752) requires Xcode 26.0. The current version of Xcode is 26.2

[seth-govalidate]

@LeonHuertaG Thos are the default xcodes on those images. You need to select the xcode version you want to use like:
sudo xcode-select --switch /Applications/Xcode_${{ parameters.xcodeversion }}.app/Contents/Developer

[PavloLukianets]

@rolfbjarne is 26.2 support for net 9 planned?

[rolfbjarne]

@rolfbjarne is 26.2 support for net 9 planned?

No, only for .NET 10.