iOS 18 Beta与macOS 15 Beta环境下无法部署调试MAUI应用

问题背景 #

将iPhone升级至iOS Beta、Mac升级至macOS 15 Beta后，MAUI代码编写正常，但模拟器/设备调试时出现以下错误：

/usr/local/share/dotnet/packs/Microsoft.iOS.Sdk.net8.0_17.5/17.5.8020/tools/bin/mlaunch --launchsim /{app_path}/bin/Debug/net8.0-ios/iossimulator-arm64/MyApp.app --device=:v2:udid=BAECFA41-6785-4593-BDDA-F4A4AC1D9FC1 -sdk 18.0 --argument=-monodevelop-port --argument=10001 --setenv=XAMARIN_DEBUG_PORT=10001 --sdkroot /Applications/Xcode-beta.app/Contents/Developer
error HE0004: Could not load the framework 'IDEDistribution' (path: /Applications/Xcode-beta.app/Contents/SharedFrameworks/IDEDistribution.framework/Versions/A/IDEDistribution):
dlopen(/Applications/Xcode-beta.app/Contents/SharedFrameworks/IDEDistribution.framework/Versions/A/IDEDistribution, 0x0001): Library not loaded: @rpath/AppThinning.framework/Versions/A/AppThinning
Referenced from: <75213748-5F57-3584-9A4B-299BBE6F3D0B> /Applications/Xcode-beta.app/Contents/SharedFrameworks/IDEDistribution.framework/Versions/A/IDEDistribution
Reason: tried: '/usr/local/share/dotnet/packs/Microsoft.iOS.Sdk.net8.0_17.5/17.5.8020/tools/lib/mlaunch/mlaunch.app/Contents/Frameworks/AppThinning.framework/Versions/A/AppThinning' (no such file), '/Applications/Xcode-beta.app/Contents/SharedFrameworks/IDEDistribution.framework/Versions/A/Frameworks/AppThinning.framework/Versions/A/AppThinning' (no such file), '/usr/local/share/dotnet/packs/Microsoft.iOS.Sdk.net8.0_17.5/17.5.8020/tools/lib/mlaunch/mlaunch.app/Contents/Frameworks/AppThinning.framework/Versions/A/AppThinning' (no such file), '/Applications/Xcode-beta.app/Contents/SharedFrameworks/IDEDistribution.framework/Versions/A/Frameworks/AppThinning.framework/Versions/A/AppThinning' (no such file), '/usr/local/share/dotnet/packs/Microsoft.iOS.Sdk.net8.0_17.5/17.5.8020/tools/lib/mlaunch/mlaunch.app/Contents/MonoBundle/AppThinning.framework/Versions/A/AppThinning' (no such file)

尝试旧版稳定版Xcode无效，寻求解决建议。

解决步骤 #

1. 升级.NET MAUI Workload至适配Xcode 18的版本 #

当前使用的Microsoft.iOS.Sdk.net8.0_17.5对应Xcode 17.5，与你当前的Xcode-beta（适配iOS 18/macOS 15）版本不兼容。需要更新到支持Xcode 18的预览版Workload：

• 执行命令更新预览版Workload：

  dotnet workload update --preview
  

• 若使用.NET 9预览版，直接安装对应iOS workload即可，.NET 9原生适配Apple最新Beta系统。

2. 确认Xcode命令行工具路径 #

旧版Xcode在macOS 15 Beta下可能无法正常运行，但仍需确保系统指向正确的Xcode版本：

• 查看当前命令行工具路径：

  xcode-select -p
  

• 若指向Xcode-beta，切换到稳定版（仅当稳定版能在macOS 15 Beta运行时有效）：

  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
  

3. 清理项目缓存并重新生成 #

缓存不兼容可能导致调试失败：

• 删除项目根目录下的bin和obj文件夹
• 执行命令清理并恢复项目：

  dotnet clean
  dotnet restore
  

• 重启IDE（VS for Mac/Rider）后重新编译调试

4. 临时应急方案（不推荐） #

若需紧急调试，可手动复制缺失的框架文件：

• 在Xcode-beta中找到AppThinning.framework，通常路径为/Applications/Xcode-beta.app/Contents/Frameworks/AppThinning.framework
• 将其复制到错误提示中缺失的路径，例如：

  sudo cp -r /Applications/Xcode-beta.app/Contents/Frameworks/AppThinning.framework /usr/local/share/dotnet/packs/Microsoft.iOS.Sdk.net8.0_17.5/17.5.8020/tools/lib/mlaunch/mlaunch.app/Contents/Frameworks/
  

注意：该方法可能因版本不匹配引发其他问题，仅作临时应急。

关于降级或等待更新的疑问 #

• 降级系统：若上述方法均无效，回到macOS 14 + iOS 17稳定版是最稳妥的方案，可保证开发环境完全兼容。
• 等待更新：若不想降级，只能等待微软发布支持Xcode 18的.NET MAUI正式更新，或持续跟进.NET预览版的迭代——预览版会优先适配Apple的Beta系统版本。

内容的提问来源于stack exchange，提问作者metal_man