I'm setting up an Azure Pipelines build that needs to package a C# .NET class library into a NuGet package.
In this documentation, it lists a couple different ways to automatically generate SemVer strings. In particular, I want to implement this one:
$(Major).$(Minor).$(rev:.r)
, whereMajor
andMinor
are two variables defined in the build pipeline. This format will automatically increment the build number and the package version with a new patch number. It will keep the major and minor versions constant, until you change them manually in the build pipeline.
But that's all they say about it, no example is provided. A link to learn more takes you to this documentation, where it says this:
For
byBuildNumber
, the version will be set to the build number, ensure that your build number is a proper SemVer e.g.1.0.$(Rev:r)
. If you select byBuildNumber, the task will extract a dotted version,1.2.3.4
and use only that, dropping any label. To use the build number as is, you should use byEnvVar as described above, and set the environment variable toBUILD_BUILDNUMBER
.
Again, no example is provided. It looks like I want to use versioningScheme: byBuildNumber
, but I'm not quite sure how to set the build number, I think it pulls it from the BUILD_BUILDNUMBER
environment variable, but I can't find a way to set environment variables, only script variables. Furthermore, am I suppose to just set that to 1.0.$(Rev:r)
, or to $(Major).$(Minor).$(rev:.r)
? I'm afraid that would just interpret it literally.
Googling for the literal string "versioningScheme: byBuildNumber" returns a single result... Does anyone have a working azure-pipelines.yml
with this versioning scheme?
byBuildNumber
uses the build number you define in your YAML with the name
field.
Ex: name: $(Build.DefinitionName)-$(date:yyyyMMdd)$(rev:.r)
So if you set your build format to name: 1.0.$(rev:.r)
, it should work as you expect.