Xamarin Native项目：如何在Microsoft App Center构建脚本配置SonarQube分析？

我之前刚好帮团队搞定过Xamarin Native项目在App Center CI/CD里集成SonarQube静态分析的需求，踩了不少小坑，分享下完整的实操步骤，应该能直接套用：

1. 前期准备工作 #

首先得确保基础配置没问题，避免后续踩坑：

• 先确认你本地的SonarQube分析逻辑是可复用的：比如已经有sonar-project.properties配置文件，或者能通过命令行参数指定所有核心配置（项目Key、SonarQube服务器地址、访问Token等）
• 把敏感配置存到App Center的环境变量里：在项目的「Settings」→「Environment Variables」中添加SONAR_SERVER_URL、SONAR_TOKEN、SONAR_PROJECT_KEY这几个变量，不要把这些信息硬编码到脚本里。

2. 编写App Center预构建脚本 #

App Center支持在构建的不同阶段运行自定义脚本，我们需要在Pre-build阶段执行SonarQube分析，下面分两种构建环境给出脚本：

2.1 macOS构建机（bash脚本） #

macOS构建机默认没装SonarScanner，先在脚本里安装工具，再执行分析：

# 安装SonarScanner CLI和JSON处理工具jq
brew install sonar-scanner jq

# 执行SonarQube静态分析
ANALYSIS_OUTPUT=$(sonar-scanner \
  -Dsonar.host.url=$SONAR_SERVER_URL \
  -Dsonar.login=$SONAR_TOKEN \
  -Dsonar.projectKey=$SONAR_PROJECT_KEY \
  -Dsonar.projectName="你的项目名称" \
  -Dsonar.sources="." \
  -Dsonar.exclusions="**/bin/**,**/obj/**,**/Packages/**" \
  -Dsonar.cs.xamarin.android.projectPaths="src/YourApp.Android/YourApp.Android.csproj" \
  -Dsonar.cs.xamarin.ios.projectPaths="src/YourApp.iOS/YourApp.iOS.csproj")

# 提取分析任务ID
TASK_ID=$(echo "$ANALYSIS_OUTPUT" | grep -o 'ceTaskId=\w*' | cut -d'=' -f2)

# 轮询质量门状态，直到出结果
while true; do
  QUALITY_GATE_RESPONSE=$(curl -u $SONAR_TOKEN: -X GET "$SONAR_SERVER_URL/api/ce/task?id=$TASK_ID")
  TASK_STATUS=$(echo "$QUALITY_GATE_RESPONSE" | jq -r '.task.status')
  
  if [ "$TASK_STATUS" == "SUCCESS" ]; then
    GATE_STATUS=$(echo "$QUALITY_GATE_RESPONSE" | jq -r '.task.qualityGate.status')
    if [ "$GATE_STATUS" != "OK" ]; then
      echo "❌ SonarQube质量门未通过，终止构建"
      exit 1
    fi
    echo "✅ SonarQube分析通过，继续构建流程"
    break
  elif [ "$TASK_STATUS" == "FAILED" ]; then
    echo "❌ SonarQube分析任务失败，终止构建"
    exit 1
  fi
  
  sleep 5
done

2.2 Windows构建机（PowerShell脚本） #

Windows环境用Chocolatey安装依赖，脚本逻辑和macOS一致：

# 安装SonarScanner和jq
choco install sonarscanner jq -y

# 执行SonarQube分析
$ANALYSIS_OUTPUT = sonar-scanner `
  -Dsonar.host.url=$env:SONAR_SERVER_URL `
  -Dsonar.login=$env:SONAR_TOKEN `
  -Dsonar.projectKey=$env:SONAR_PROJECT_KEY `
  -Dsonar.projectName="你的项目名称" `
  -Dsonar.sources="." `
  -Dsonar.exclusions="**/bin/**,**/obj/**,**/Packages/**" `
  -Dsonar.cs.xamarin.android.projectPaths="src/YourApp.Android/YourApp.Android.csproj" `
  -Dsonar.cs.xamarin.ios.projectPaths="src/YourApp.iOS/YourApp.iOS.csproj"

# 提取任务ID
$TASK_ID = ($ANALYSIS_OUTPUT | Select-String 'ceTaskId=\w*').Matches.Value.Split('=')[1]

# 轮询质量门状态
while ($true) {
  $QUALITY_GATE_RESPONSE = curl -u "$($env:SONAR_TOKEN):" -X GET "$($env:SONAR_SERVER_URL)/api/ce/task?id=$TASK_ID"
  $TASK_STATUS = ($QUALITY_GATE_RESPONSE | ConvertFrom-Json).task.status
  
  if ($TASK_STATUS -eq "SUCCESS") {
    $GATE_STATUS = ($QUALITY_GATE_RESPONSE | ConvertFrom-Json).task.qualityGate.status
    if ($GATE_STATUS -ne "OK") {
      Write-Host "❌ SonarQube质量门未通过，终止构建"
      exit 1
    }
    Write-Host "✅ SonarQube分析通过，继续构建流程"
    break
  } elseif ($TASK_STATUS -eq "FAILED") {
    Write-Host "❌ SonarQube分析任务失败，终止构建"
    exit 1
  }
  
  Start-Sleep -Seconds 5
}

3. 配置App Center构建流程 #

把脚本加到App Center里很简单：

• 打开项目的「Build」页面，选择你要配置的分支和构建配置（iOS/Android）
• 滚动到「Build scripts」区域，选择「Pre-build」阶段，把上面的脚本粘贴进去
• 保存配置，触发一次测试构建，验证分析是否正常执行，且质量门未通过时会终止构建

几个关键注意事项 #

• 确保SonarQube服务器能被App Center的构建机访问：如果是私有Sonar服务器，需要把App Center的IP段加到服务器白名单里
• 调整sonar.exclusions参数：根据你的项目结构排除不需要分析的文件，比如第三方库、自动生成的代码
• 构建超时设置：大型项目分析时间可能较长，App Center默认超时是30分钟，不够的话可以联系官方支持调整超时时间

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