Azure Pipelines Tasks 中 Xamarin.Android 安装失败的解决方案

问题背景

在使用 Azure Pipelines 的 Bash 任务安装 Xamarin 组件时，许多用户遇到了 Xamarin.Android 安装失败的问题。错误信息显示下载失败，原因是原有的下载链接已不可用。

错误现象

当执行以下命令时会出现错误：

brew install --cask xamarin-android

错误提示为：

Error: Download failed on Cask 'xamarin-android' with message: Download failed: https://dl.xamarin.com/MonoforAndroid/Mac/xamarin.android-13.2.2.0.pkg

问题原因分析

1. 官方资源迁移：Xamarin.Android 的官方下载地址已经从旧链接迁移到了新的位置
2. Homebrew Cask 更新滞后：虽然 Homebrew 已标记该组件将在2025年8月20日停用，但在此之前仍应保持可用
3. 403 访问限制：旧链接返回403错误，表明资源已被移除或访问受限

解决方案

临时解决方案

可以使用以下 Bash 脚本作为替代安装方案：

#!/bin/bash
set -e

# 使用新的官方下载地址
XAMARIN_ANDROID_URL="https://aka.ms/xamarin-android-commercial-d17-8-macos"
PKG_FILE="xamarin-android.pkg"

# 下载安装包
echo "正在下载 Xamarin.Android..."
curl -L -o "$PKG_FILE" "$XAMARIN_ANDROID_URL"

# 验证下载
if [ ! -f "$PKG_FILE" ]; then
  echo "下载失败，退出..."
  exit 1
fi

# 安装
echo "正在安装 Xamarin.Android..."
sudo installer -pkg "$PKG_FILE" -target /

# 清理
rm -f "$PKG_FILE"

echo "Xamarin.Android 安装完成"

长期建议

1. 更新 CI/CD 流程：建议将上述脚本整合到您的持续集成流程中
2. 监控官方更新：关注 Xamarin 官方发布渠道，获取最新的安装方式
3. 考虑迁移方案：由于 Xamarin 正在逐步被 .NET MAUI 取代，建议评估迁移计划

技术细节

1. curl 参数说明：

   • -L 参数：跟随重定向
   • -o 参数：指定输出文件名

2. installer 命令：

   • -pkg 指定安装包
   • -target / 指定安装目标为根目录

3. set -e：

   • 确保脚本在出现任何错误时立即退出

验证结果

多位用户已确认该解决方案有效，能够成功完成 Xamarin.Android 的安装。该方案适用于 macOS 13 和 14 系统环境。

总结

虽然官方 Homebrew Cask 仓库中的 Xamarin.Android 安装源存在问题，但通过直接使用新的下载地址并手动安装，可以解决当前在 Azure Pipelines 中遇到的安装失败问题。建议开发团队关注官方更新，及时调整构建流程。