使用私有构建代理时VSTS无法构建Android项目（JavaMaximumHeapSize报错）

嘿，针对你在私有构建代理上遇到的XA5213（java.lang.OutOfMemoryError）错误，我来分享几个经过验证的解决办法——这类内存瓶颈问题在自定义构建环境里确实挺常见的：

1. 直接在MSBuild中指定Java堆内存上限 #

这是最直接的针对性解决方式，你可以通过MSBuild参数手动覆盖$(JavaMaximumHeapSize)的值：

• 如果是用VSTS/YAML构建任务，在MSBuild的「命令行参数」里添加：

  /p:JavaMaximumHeapSize=4G
  

  数值可以根据代理机器内存调整，比如8GB内存的机器可以设到6G，4GB内存的话设2G也能缓解问题。
• 如果是修改项目文件（.csproj），可以直接在<PropertyGroup>节点里添加：

  <PropertyGroup>
    <!-- 按需调整内存大小 -->
    <JavaMaximumHeapSize>4G</JavaMaximumHeapSize>
  </PropertyGroup>
  

2. 全局调整Android Gradle的JVM参数 #

如果不想每个项目单独设置，也可以修改Android SDK的全局配置，让所有Xamarin.Android构建都受益：

1. 找到私有代理上的Android SDK安装路径（通常是C:\Program Files (x86)\Android\android-sdk，自定义路径就找对应位置）
2. 进入tools目录，找到gradle.properties文件（没有的话直接新建一个）
3. 添加以下配置：

   org.gradle.jvmargs=-Xmx4G -XX:MaxPermSize=512m
   

   这里的-Xmx4G是把JVM最大堆内存设为4GB，MaxPermSize是永久代内存，按需调整即可。

3. 优化私有代理的硬件与环境配置 #

既然你选私有代理来提速度降成本，记得给代理机器留足资源：

• 建议代理机器至少有8GB以上物理内存，大项目构建对内存需求很高；
• 构建时关闭后台不必要的进程（比如杀毒软件实时扫描、闲置程序），避免内存被抢占；
• 确认代理上的Xamarin.Android工具链是最新稳定版，旧版本可能存在内存泄漏问题。

顺带提一句，VS AppCenter和VSTS托管的VS2017代理之所以没出问题，是因为它们的默认配置已经调高了Java堆内存上限，而私有代理的默认配置相对保守，才触发了这个溢出错误。

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