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 完成创建。

创建任务组后,之前选中的任务就原地转换为新的任务组。

这个任务组的使用方式其它任务一样,在 add tasks 里添加到 pipeline 即可。

3. 管理任务组

在左边的菜单中选中 task groups 进入任务组列表的页面,在列表中选中要管理的任务组进入任务组的详细页面。

task 页中可以像在 pipeline 中管理任务一样管理任务组的任务,也可以修改任务组的名称、分类、版本号等信息。

history 页中可以查看更改的历史记录。

references 页中可以看到任务组被引用的 build pipelinesrelease pipelinestask groups

4. 最后

任务组是一个很好用的功能,可惜在 yaml 管道中不能使用。有关任务组的更多内容可以参考官方文档:

azure pipelines 和 tfs 中的任务组