Xamarin.Android 项目在.NET 9发布后遇到的.NET 8 Android应用发布问题解析

问题背景

在.NET 9正式发布后，许多使用.NET 8构建Xamarin.Android应用的开发者遇到了一个令人困扰的问题：当尝试发布针对.NET 8的Android应用时，系统报错提示"Microsoft.Android.Runtime.34.android-arm64 was not downloaded"。这个问题主要出现在使用GitHub Actions等CI/CD流水线的环境中。

问题现象

开发者在执行dotnet publish命令时，会遇到如下错误：

error NETSDK1112: The runtime pack for Microsoft.Android.Runtime.34.android-arm64 was not downloaded.

检查工作负载安装日志时，会发现系统实际上下载的是35版本的运行时包，而非项目所需的34版本：

Downloading Microsoft.Android.Runtime.35.android-arm64.Msi.x64 (35.0.7)

问题根源

经过深入分析，这个问题主要由以下几个因素共同导致：

1. SDK版本冲突：CI环境中同时安装了.NET 8和.NET 9的SDK，而默认情况下系统会优先使用最新版本（9.0.x）的SDK和工具链。

2. 工作负载版本不匹配：当使用.NET 9的SDK时，它会尝试下载最新版本（35）的Android工作负载，而.NET 8项目需要的是34版本的运行时。

3. 全局配置缺失：在没有明确指定SDK版本的情况下，构建系统无法自动选择正确的工具链版本。

解决方案

要解决这个问题，最有效的方法是通过全局配置文件明确指定所需的SDK版本。具体步骤如下：

1. 在解决方案根目录下创建或修改global.json文件，内容如下：

{
  "sdk": {
    "version": "8.0.400"
  }
}

2. 确保CI流水线中安装的是指定版本的.NET SDK，而不是简单地使用"8.x"这样的范围版本。

3. 清理工作负载缓存（可选）：在某些情况下，可能需要清理现有的工作负载缓存以确保使用正确的版本。

深入理解

这个问题实际上反映了.NET多版本共存环境下的一个常见挑战。当新版本的.NET发布后，构建系统会倾向于使用新版本的组件，即使项目本身针对的是旧版本框架。在Xamarin.Android/Maui这类需要特定平台工具链的项目中，这种版本不匹配会导致运行时组件无法正确解析。

global.json文件的作用就是锁定特定的SDK版本，确保构建过程使用预期的工具链。这对于保持构建环境的稳定性和可重复性至关重要，特别是在团队协作和CI/CD场景中。

最佳实践建议

1. 项目初始化时就应该包含global.json：这可以避免后续的版本兼容性问题。

2. CI环境中明确指定SDK版本：不要依赖默认的最新版本，特别是在多版本共存的环境中。

3. 定期更新global.json中的SDK版本：当需要升级项目时，有计划地更新SDK版本，而不是被动地被新版本影响。

4. 考虑使用SDK版本管理器：对于本地开发环境，可以使用像dotnet-vs或类似的工具来管理多个SDK版本。

通过遵循这些实践，开发者可以避免类似的构建问题，确保Xamarin.Android项目的顺利构建和发布。