VSTS/Azure DevOps：自动递增 NuGet 包版本

Question

运行 .NET Core Pack 任务，如何让输出的 NuGet 包版本自动递增？

所以，例如，如果我当前的版本是1.0.0，那么下次我调用Pack任务时，我希望看到1.0.1。

我正在使用带有Build.BuildNumber 的环境构建变量，并在例如20180913-.2.0等。我想建立一个更传统的版本控制系统。

Answer 1

从docs，变量Rev:.r 是每日 构建修订计数。接受的“解决方案”将导致一天完成1.0.12 的版本，然后第二天将是1.0.1。

如果您想要一个简单的增量和独特 semver，请使用1.0.$(BuildID)。

$(BuildID) 是用于构建的内部不可变计数器，因此比 $(BuildNumber) 干净得多。

---

BuildID 将始终递增 - 无需重置。 因此，经过一个小颠簸之后，您最终会说 1.2.123 变成 1.3.124。

如果您想很好地执行此任务，可以使用 npm version 或类似方法来完成，例如用于 Dart 或 Flutter 构建的 pubspec_version。

- script: npm version $RELEASE_TYPE

其中$RELEASE_TYPE 是您可以根据构建设置的变量（即：CI、PR 等），其值为major、minor、patch、prerelease 等。

- script: npm version $RELEASE_TYPE
  condition: startsWith(variables['build.sourceBranch'], 'refs/head/release/')
  env:  
    releaseType: minor

---

更新：Bump Repo 版本和在构建中使用（使用 npm）

为了更新 repo 版本，我最终将 npm version 作为 DevDependency 包含在内，它的 precommit hook 可以在任何提交时提升项目版本。

这种技术可以应用于其他项目类型，将它们放在一个子文件夹中 - 尽管可能会导致服务器操作系统要求的复杂化。

要在您的构建中使用此版本，请添加此 bash 脚本任务，它将获取版本并将其导出为任务变量：

v=`node -p "const p = require('./package.json'); p.version;"`
echo "##vso[task.setvariable variable=packageVersion]$v"

---

.Net Core Task only 版本

很遗憾，没有回购。

解决方法 1：

jobs:
  - job: versionJob #reads version number from the source file
    steps:
      - powershell: |
          $fv = Get-Content versionFile
          Write-Host ("##vso[task.setvariable variable=versionFromFile;isOutput=true]$fv")
        displayName: 'version from file' 
        name: setVersionStep  


  - job: buildJob # consumes version number, calculates incremental number and set version using assemblyinfo.cs
    dependsOn: versionJob
    variables:
      versionFromFile: $[ dependencies.versionJob.outputs['setVersionStep.versionFromFile'] ] # please note that spaces required between $[ and dependencies
      buildIncrementalNumber: $[ counter(dependencies.versionJob.outputs['setVersionStep.versionFromFile'],1) ] #can't use $versionFromFile here


    steps:
      - powershell: |
          Write-Host ($env:versionFromFile)
          Write-Host ($env:versionFromFile + '.' + $env:buildIncrementalNumber)
        displayName: 'version from file output' 

解决方法 2：

This post 描述了其他几个，使用 version-prefix 并自动将 BuildNumber 应用为 version-suffix。

Answer 2

我可能已经明白了。对于任何撕掉头发的人，试试这个：

打包任务：

• 自动包版本控制：使用环境变量
• 环境变量： Build.BuildNumber

然后，在您拥有 Tasks、Variables、Triggers、Options 的顶部菜单中，单击选项并设置：

• 内部版本号格式：1.0$(Rev:.r)

保存并排队。这将产生例如1.0.1.

（如果我错了，或者如果这不能长期工作，请纠正我。）

Answer 3

如果您只是想增加主要、次要或修订版本号，在变量中使用counter 运算符是一种简单而优雅的方法。它会自动将当前值加一。

这是我使用的：

variables:
  major: '1'
  minor: '0'
  revision: $[counter(variables['minor'], 1)] #this will get reset when minor gets bumped. The number after Counter is the seed number (in my case, I started at 1).
  app_version: '$(major).$(minor).$(revision)'

如果您想查看使用此功能的实际 4-job 管道，我在这里有一个 https://github.com/LanceMcCarthy/DevReachCompanion/blob/master/azure-pipelines.yml

Answer 4

对我来说，将选项选项卡上的内部版本号格式设置为

$(date:yyyy).$(date:MMdd)$(rev:.r) 

并添加下一个构建参数：

/p:Version=1.$(Build.BuildNumber) /p:AssemblyVersion=1.$(Build.BuildNumber)

在这种情况下，我们手动管理主要版本，但次要版本和内部版本号将自动设置。易于理解您部署的版本。

Answer 5

我正在使用 ado 管道和 yaml 构建。我所做的是利用管道变量、计数器函数和内联 powershell 函数来创建版本号。它会自动递增并使整个构建过程变得很好。

Another SO Post about something similar