解决.NET8 Android应用发布时Microsoft.Android.Runtime.34缺失问题

问题背景

在.NET 8.0环境下开发Android应用时，开发者可能会遇到一个典型的构建错误："Microsoft.Android.Runtime.34.android-arm64 was not downloaded"。这个问题通常出现在以下场景：

1. 使用GitHub Actions进行持续集成时
2. 构建服务器上同时安装了.NET 9.0 SDK
3. 尝试发布基于.NET 8.0的Maui Android应用

问题根源分析

这个问题的根本原因在于SDK版本冲突。当构建环境中同时存在.NET 8.0和9.0 SDK时，工作负载安装过程可能会优先下载9.0版本的Android运行时组件（如Microsoft.Android.Runtime.35），而.NET 8.0应用构建时却需要34版本的运行时组件。

解决方案

经过实践验证，最可靠的解决方案是通过全局配置文件锁定SDK版本：

1. 在解决方案根目录下创建或修改global.json文件
2. 明确指定使用.NET 8.0 SDK：

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

技术细节

为什么这个方法有效？

global.json是.NET CLI工具的配置文件，它可以：

• 锁定特定的SDK版本
• 确保构建过程使用预期的工具链
• 避免多版本SDK共存时的自动选择问题

其他尝试过的方案

在找到最终解决方案前，开发者可能会尝试以下方法但效果不佳：

1. 指定工作负载版本：dotnet workload install maui-android --version 8.0.402
2. 修改目标框架：net8.0-android35.0
3. 设置环境变量：BUILD_TOOLS_VERSION=35.0.0

这些方法之所以不奏效，是因为它们没有从根本上解决SDK版本选择的问题。

最佳实践建议

1. 版本锁定：对于生产环境构建，始终使用global.json锁定SDK版本
2. 环境隔离：考虑为不同版本的构建使用独立的构建代理或容器
3. 明确依赖：在项目文件中明确指定所有NuGet包的版本
4. 构建日志检查：定期检查构建日志，确保下载了正确版本的运行时组件

总结

在.NET多版本共存的环境中构建Android应用时，SDK版本管理至关重要。通过global.json文件明确指定SDK版本是最可靠的方式，可以避免因自动版本选择导致的构建失败问题。这个问题也提醒我们，在持续集成环境中，明确的环境配置是保证构建可靠性的关键因素。

对于使用GitHub Actions的团队，建议将global.json文件纳入版本控制，确保所有构建环境的一致性。同时，定期更新SDK版本时，也要同步更新这个配置文件，保持开发、构建和部署环境的一致性。