Xamarin.Android项目构建耗时过长咨询：资源规模与提速方案

Hey there! Let’s tackle your Xamarin Android build issues step by step.

一、当前构建耗时是否正常？ #

针对你描述的项目规模（350个drawable、210个布局文件、65个values XML），常规Debug非Clean构建应该控制在3-5分钟内，Clean构建可能会延长到5-8分钟。如果你的构建耗时远超这个范围，那确实存在优化空间，属于不正常的情况。

从你提供的日志片段来看：

Done building project "MyApp.Droid.csproj".
Project Evaluation Performance Summary: 139 ms /Users/stefan/Projects/myapp/Core/CoreApp.Core.csproj 2 calls
Project Performance Summary: 70 ms /Users/stefan/Projects/myapp/Core/CoreApp.Core.csproj ...

项目评估阶段耗时极短，说明瓶颈大概率出在资源编译、打包或者后续的构建环节，而非项目配置解析。

二、构建提速方案 #

1. 资源层面优化 #

• 压缩并转换资源格式：将PNG/JPG格式的图片转为WebP（Xamarin Android原生支持WebP），可大幅减少资源体积，加快AAPT2的编译速度；用TinyPNG等工具对drawable资源进行无损压缩。
• 精简资源：移除未使用的drawable、布局和values资源；针对目标用户群体的设备分辨率拆分资源，避免全分辨率打包（比如只保留xxhdpi和xxxhdpi）。
• 启用AAPT2：确保项目启用AAPT2（新版Xamarin默认已开启），在MyApp.Droid.csproj中添加/确认：

  <AndroidUseAapt2>True</AndroidUseAapt2>
  

  AAPT2相比旧版AAPT支持增量资源编译，能显著缩短资源处理时间。

2. 项目配置优化 #

• 启用增量构建：确认项目开启增量构建，在csproj中添加：

  <IncrementalBuild>True</IncrementalBuild>
  

• 禁用Debug阶段不必要的任务：
  • 关闭代码分析（Debug阶段无需严格检查）：在项目属性的“代码分析”中设置Debug配置为“无”
  • 禁用Android NDK调试（如果不需要原生代码调试）：在项目属性的“Android选项”中取消勾选“启用Android NDK调试”
• 更新工具链：升级到最新版本的Xamarin.Android、Visual Studio（或VS for Mac），微软持续优化构建性能，新版本通常会有明显提升。
• 并行构建：开启MSBuild并行构建，在VS的“选项”→“项目和解决方案”→“构建和运行”中设置“最大并行项目构建数”为CPU核心数；或者用命令行构建时添加/m参数。

3. 硬件与环境优化 #

• 使用SSD存储项目：机械硬盘的读写速度会严重拖慢构建过程，SSD能将资源编译、文件复制环节的耗时减少一半以上。
• 给IDE分配更多内存：在VS for Mac的“偏好设置”→“性能”中调高内存上限；Windows版VS可通过修改devenv.exe.config文件增加内存分配。
• 关闭后台冗余程序：构建时关闭浏览器、视频软件等占用CPU/内存的程序，确保构建过程获得足够资源。

三、解决修改XML后必须Clean Build的问题 #

这个问题本质是增量构建失效，以下是针对性解决方法：

• 检查XML文件的Build Action：确保所有布局、values文件的Build Action设置为AndroidResource（右键文件→“属性”中查看），如果设置为Content或其他类型，MSBuild无法跟踪其变化。
• 清除MSBuild缓存：手动删除项目的obj和bin目录，然后执行一次正常构建，之后增量构建应该恢复正常。
• 排查自定义构建任务：如果项目中添加了自定义MSBuild脚本或NuGet包，检查是否有脚本修改了资源文件的依赖关系，导致MSBuild误判资源需要重新编译。
• 检查资源文件名冲突：避免不同目录下出现同名资源（比如drawable/icon.png和layout/icon.xml这类跨目录同名文件），同名资源会干扰MSBuild的增量跟踪逻辑。

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