.NET MAUI iOS Release构建卡在--enable-serialization-discovery

问题背景 #

使用Windows端Visual Studio 17.6.4构建net6.0-android和net6.0-ios应用，配对Mac设备（macOS 13.4.1，Xcode 14.3.1）并连接iPad，执行iOS Release构建时出现以下问题：

• 输出--enable-serialization-discovery ~后进程停滞，最长1小时无进展
• 偶发构建成功，但耗时超20分钟

已尝试的措施：

• 关闭VS后删除Mac端/Users/(user)/Library/Caches/Xamarin/XMA缓存，重启VS
• 删除项目的obj、bin目录
• 重启Windows和Mac设备

针对性解决方案 #

1. 优化AOT编译参数（核心提速点） #

iOS Release构建默认启用AOT编译，这是耗时最长的环节，可通过调整项目配置减少编译负载：

• 编辑项目.csproj文件，添加以下属性：

  <PropertyGroup>
    <!-- 启用增量AOT，仅编译代码变更部分 -->
    <IncrementalAot>true</IncrementalAot>
    <!-- 仅编译目标架构（如arm64，减少多架构编译耗时） -->
    <RuntimeIdentifiers>ios-arm64</RuntimeIdentifiers>
    <!-- 临时禁用全量优化（仅用于调试构建速度，正式发布需恢复） -->
    <MtouchExtraArgs>--optimize=-all</MtouchExtraArgs>
  </PropertyGroup>
  

2. 修复跨设备通信问题（对应Broker日志SocketException） #

SocketException通常是Windows与Mac的Broker通信中断导致，空的xxxx.Broker.xxx.stderr.log是进程异常退出的表现，可按以下步骤修复：

• 确保Windows与Mac处于同一局域网，关闭双方防火墙或添加Visual Studio、Xamarin Broker的网络例外
• 在VS中重新配对Mac：进入工具>选项>Xamarin>iOS设置，移除现有配对，重新输入Mac用户名和密码完成配对
• 删除Mac端Broker日志残留：删除/Users/(user)/Library/Logs/Xamarin/Services/Xamarin.Messaging.Broker下所有日志文件，通过活动监视器结束Xamarin.Messaging.Broker进程后重启VS

3. 释放Mac端编译资源 #

• 关闭Mac上所有非必要应用（如Xcode后台进程、浏览器、视频软件等），避免CPU/内存被占用
• 检查Mac磁盘剩余空间，确保有项目大小3-5倍的可用空间，防止磁盘IO瓶颈拖慢编译

4. 调整VS构建设置 #

• 进入项目属性>iOS>构建，临时取消勾选「启用设备特定的优化」（正式发布需重新开启）
• 在VS的工具>选项>项目和解决方案>构建和运行中，设置「最大并行项目构建数」为CPU核心数的1.5倍左右，启用并行构建加速

疑问解答 #

• Broker日志的SocketException与空stderr.log是否有关？
  是的。SocketException说明Windows与Mac的Broker服务通信出现中断，空的stderr.log是Broker进程异常退出时未正常写入日志的结果，清理日志并重新配对设备可解决这类通信问题。

• 是否是AOT编译耗时过长？如何确认进度？
  iOS Release构建的AOT编译确实是最耗时的步骤，可通过以下方式确认是否在推进：

  • 打开Mac活动监视器，查看dotnet或mtouch进程的CPU占用率，持续高占用说明编译正在进行
  • 在Mac终端执行ps aux | grep mtouch，查看是否有AOT相关的进程在运行

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