.net MAUI Xcode版本不支持

Question

.net MAUI iOS开发要求对应的Xcode版本为26.6，但此版本在MAC上已处于禁用状态，只能支持最新的27.2版本，在这种情况下应该如何处理？

Answer 1

@achilles 您好，

该错误表示您的项目仍在使用较旧的 .NET for iOS workload（26.5.x），它要求 Xcode 26.6。由于您的 Mac 上已无法使用 Xcode 26.6，建议将 workload 升级到最新的稳定版本，并搭配其对应的 Xcode 版本，使开发环境回到官方支持的组合。

目前的支持情况

每个 .NET for iOS workload 都对应一个特定的 Xcode 版本。目前最新的 .NET 10 稳定版支持的是 Xcode 27.1（.NET for iOS 27.1.10018）。我尚未找到支持 Xcode 27.2 的稳定版 workload，相关支持仍在进行中，目前也没有公布具体的发布时间。因此，建议暂时使用 Xcode 27.1，而不是 Xcode 27.2。

Xcode 27.1 与 Xcode 27.2 同属 Xcode 27 系列，对 macOS 的要求相同（macOS Tahoe 26.6 或更高版本），因此无需更改当前的 macOS，可以与 Xcode 27.2 并行安装。两者之间主要是 SDK 小版本更新和工具改进，对一般的 .NET MAUI 项目开发影响不大。

建议的处理方式

1. 在 Xcode 27.2 之外并行安装 Xcode 27.1（从 Apple Developer Downloads 下载，打开前先重命名，例如 Xcode_27_1.app，再移动到 /Applications），然后切换：

   sudo xcode-select --switch /Applications/Xcode_27_1.app 

2. 确认 .NET SDK 为 10.0.402：

   dotnet --version 

3. 更新 workload:

   dotnet workload install ios maui --version 10.0.402.1 

4. 使用以下命令确认安装的版本

   dotnet workload --info 

5. 将项目中的 .NET MAUI 包更新到最新的服务版本（目前为 10.0.120），然后 clean（删除 bin/obj）、restore 并重新 build 项目。

注意事项

• UIScene 生命周期： 使用 Xcode 27 构建的应用必须采用 UIScene 生命周期，否则在 iOS 27 上启动时可能会崩溃。更新 workload 不会自动修改项目中的平台文件，如果项目仍只使用 AppDelegate，需要手动添加 SceneDelegate 及对应的 Info.plist 设置，并检查身份验证回调、深层链接（deep link）等相关逻辑。详情请参考: 为 Xcode 27 准备 .NET MAUI 应用
• 备份项目： 建议在更新前先备份项目或创建新的分支。
• 第三方 NuGet 包： 如果项目使用了包含原生绑定的第三方 NuGet 包，建议确认这些包是否已支持 iOS 27。
• 影响范围： workload 是安装在整台机器上的，同一台 Mac 或 CI 环境中的其他 .NET iOS 项目也会受到影响，需要使用相同的 Xcode 版本。

跟踪后续更新 您可以通过以下 Microsoft 官方渠道了解 workload 与 Xcode 版本的对应关系，以及后续对 Xcode 27.2 的支持情况：

• Xcode 版本要求及并行安装多个 Xcode 的方法
• .NET MAUI 相关公告（.NET Blog）
• .NET MAUI 支持策略及最新服务版本
• .NET for iOS 发布说明 希望以上信息对您有所帮助。如有其他问题，欢迎随时告诉我。

如果以上信息对您有所帮助，您可以参考此指南进行确认。感谢您的支持。