Mac环境下Jenkins+MSBuild构建Xamarin项目遇引用缺失问题求助

我之前也帮不少开发者解决过类似的Jenkins + Xamarin构建问题，你遇到的Mscorlib引用缺失，本质上是Jenkins的执行环境和你本地Visual Studio Mac的环境不一致导致的，咱们一步步排查解决：

1. 检查Jenkins的环境变量与MSBuild路径 #

本地Visual Studio Mac会自动加载Xamarin和.NET相关的环境配置，但Jenkins默认不会继承这些配置。你需要确保Jenkins使用的是VS Mac自带的MSBuild，而不是系统默认版本：

• VS Mac的MSBuild默认路径是：/Applications/Visual Studio.app/Contents/MacOS/MSBuild
• 可以在Jenkins的构建前步骤添加一个Shell命令，对比本地终端和Jenkins的环境变量差异：

  echo $PATH && echo $MONO_HOME && msbuild -version
  

  如果Jenkins输出的MSBuild版本和本地不一致，就在构建步骤里使用完整路径调用MSBuild。

2. 明确指定构建的目标框架与配置 #

在Jenkins的构建命令中，明确指定目标框架和发布配置，避免MSBuild自动选择不兼容的版本：

/Applications/Visual Studio.app/Contents/MacOS/MSBuild YourSolution.sln /p:TargetFramework=netstandard2.0 /p:Configuration=Release

这样能确保MSBuild直接针对.NET Standard 2.0进行构建，不会因为版本匹配问题遗漏Mscorlib等核心引用。

3. 确保NuGet还原的路径与权限 #

虽然你说还原步骤正常，但Jenkins运行用户（通常是jenkins系统用户）可能没有访问本地用户NuGet缓存的权限。建议在还原步骤中指定本地包目录：

nuget restore YourSolution.sln -PackagesDirectory ./packages

将NuGet包下载到项目工作目录下，确保Jenkins构建时能直接访问到所有依赖包。

4. 切换到Jenkins用户手动验证 #

有时候问题出在Jenkins用户的环境配置上，你可以尝试切换到jenkins用户，手动执行构建命令来复现问题：

sudo su - jenkins
cd /Users/Shared/Jenkins/Home/workspace/YourProjectName
/Applications/Visual Studio.app/Contents/MacOS/MSBuild YourSolution.sln /p:TargetFramework=netstandard2.0 /p:Configuration=Release

如果手动执行也出现同样的错误，说明需要给jenkins用户配置Xamarin相关的环境变量，比如将VS Mac的MSBuild路径添加到PATH中。

5. 同步本地与Jenkins的Xamarin/Mono版本 #

旧版本的Mono对.NET Standard 2.0的支持存在兼容性问题，你本地VS Mac可能已经更新到最新版本，但Jenkins使用的Mono还是旧版。对比本地和Jenkins环境下的msbuild -version输出，确保两者的Mono和MSBuild版本一致，若不一致则更新Jenkins环境中的相关组件。

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