[Azure DevOps] 如何使用任务组

1. 使用 PowerShell 脚本

在上一篇文章中我们学会了怎么使用扩展在编译前实时更改版本号。有些情况下我们希望不适用扩展，例如喜欢发明轮子，或者根本没有安装扩展的权限。这时候我们可以自己写 PowerShell 解决这个问题。

在 Pipeline 中添加一个 PowerShell 的任务，Type 选择 Inline，然后在 Script 里输入这段 PowerShell 脚本：

$ComponentPath = $Env:Build_SourcesDirectory

$VersionNumber = $Env:AssemblyVersion+"."+$Env:Build_BuildId+".0"

$ErrorActionPreference = "Stop"

Write-Output "ComponentPath""$ComponentPath""."

Write-Output "VersionNumber""$VersionNumber""."

$assemblyFiles = Get-ChildItem -Recurse -Path $ComponentPath -Include AssemblyInfo.cs | Where-Object { $_.fullname -notmatch "\\packages\\" }

$assemblyVersionRegex     = New-Object System.Text.RegularExpressions.Regex -ArgumentList '^\s*\[assembly:\s*AssemblyVersion\("[^"]*"\)\]',MultiLine

$assemblyFileVersionRegex = New-Object System.Text.RegularExpressions.Regex -ArgumentList '^\s*\[assembly:\s*AssemblyFileVersion\("[^"]*"\)\]',MultiLine

$assemblyInfoVersionRegex = New-Object System.Text.RegularExpressions.Regex -ArgumentList '^\s*\[assembly:\s*AssemblyInformationalVersion\("[^"]*"\)\]',Multiline

foreach ($file in $assemblyFiles)

{

    $content = [System.IO.File]::ReadAllText($file)

    $assemblyVersionReplacement     = [string]::Format("[assembly: AssemblyVersion(""{0}"")]",              $VersionNumber)

    $assemblyFileVersionReplacement = [string]::Format("[assembly: AssemblyFileVersion(""{0}"")]",          $VersionNumber)

    $assemblyInfoVersionReplacement = [string]::Format("[assembly: AssemblyInformationalVersion(""{0}"")]", $VersionNumber)

    $content = $assemblyVersionRegex.Replace($content, $assemblyVersionReplacement)

    $content = $assemblyFileVersionRegex.Replace($content, $assemblyFileVersionReplacement)

    $content = $assemblyInfoVersionRegex.Replace($content, $assemblyInfoVersionReplacement)

    [System.IO.File]::WriteAllText($file, $content)

    Write-Output "Updated file ""$file"" to have version ""$VersionNumber""."

}

上面这段 PowerShell 的作用是修改项目里的 AssemblyInfo.cs，将版本号改为 $Env:AssemblyVersion+"."+$Env:Build_BuildId+".0"。有了这个 Task，我们可以不再依赖扩展来实现这个功能。

需要注意的是，在 PowerShell 里使用 Azure Pipelines 的变量的格式是 $Env: + 变量名，变量名里的句号 . 要改为下划线 _，例如 $(Build.BuildId) 在 PowerShell 里的引用方式为 $Env:Build_SourcesDirectory。

2. 使用任务组

下一步，为了不在每个 Pipeline 中复制粘贴这个 Task 及其中的 PowerShell 脚本，我们需要把这个 Task 做成一个公共的东西。这时候可以使用任务组，它可以将已在生成或发布管道中定义的一系列任务封装到可添加到生成或发布管道中的单个可重用任务，就像任何其他任务一样。不过需要注意的是 YAML 管道不支持任务组，任务组只能用在经典管道中。

创建任务组的方式如下图所示，在任务列表中选中一个或多个任务，然后在右键菜单中选中 Create task group，在弹出的对话框中输入名称，选择分类，最后点击 Create 完成创建。