使用CakeBuild构建Xamarin.Android项目时提示mscorlib未找到

我之前帮不少开发者排查过这类问题，这个错误本质是构建过程中Xamarin.Android工具链无法正确找到或加载必要的框架程序集，通常和CI环境配置、Cake脚本的构建参数有关，给你几个针对性的解决方案：

• 明确指定MSBuild版本和目标框架
  确保Cake脚本里使用的MSBuild和本地开发环境一致（比如VS2022的MSBuild），同时指定正确的Xamarin.Android目标框架。示例代码如下：

  MSBuild("./YourXamarinApp.csproj", new MSBuildSettings {
      TargetFramework = "monoandroid13.0", // 替换成你的项目实际目标版本
      ToolVersion = MSBuildToolVersion.VS2022,
      Properties = {
          { "AndroidSdkDirectory", EnvironmentVariable("ANDROID_SDK_ROOT") },
          { "AndroidNdkDirectory", EnvironmentVariable("ANDROID_NDK_ROOT") },
          { "JavaSdkDirectory", EnvironmentVariable("JAVA_HOME") }
      }
  });
  

  这样能避免Cake默认使用的MSBuild版本和Xamarin.Android工具链不兼容。

• 校验CI环境的Xamarin.Android组件和环境变量
  很多时候CI机器上的Xamarin.Android组件没有安装完整，或者ANDROID_SDK_ROOT、ANDROID_NDK_ROOT、JAVA_HOME这些环境变量没有正确设置。你可以在Cake脚本开头添加一段检查逻辑，确保这些路径都存在：

  var androidSdkRoot = EnvironmentVariable("ANDROID_SDK_ROOT");
  if (string.IsNullOrEmpty(androidSdkRoot) || !DirectoryExists(androidSdkRoot)) {
      throw new Exception("ANDROID_SDK_ROOT is not set or invalid.");
  }
  

  另外，Windows CI环境优先使用Visual Studio自带的MSBuild，不要用Mono的MSBuild，前者对Xamarin.Android的支持更稳定。

• 清理构建缓存并重新还原依赖
  旧的构建缓存或损坏的NuGet包也可能导致这个问题。在构建步骤前添加清理和还原操作：

  // 清理bin和obj目录
  CleanDirectories("./**/bin");
  CleanDirectories("./**/obj");
  // 还原NuGet包
  NuGetRestore("./YourSolution.sln");
  

  同时确认项目里的Xamarin.Android相关NuGet包版本和工具链版本匹配，不要混用不同版本的组件。

• 检查项目文件的配置错误
  打开你的.csproj文件，检查是否有错误的程序集引用或目标框架设置。比如有没有误写TargetFrameworkVersion，或者引用了不存在的mscorlib版本。如果项目里有自定义的MonoAndroid属性，确保和Cake脚本里的参数没有冲突。

• 本地模拟CI环境排查
  如果本地能正常构建，CI环境出错，建议在本地用命令行执行Cake脚本，模拟CI的环境变量和工具路径，复现错误后更容易定位问题所在。

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