Increase App Version

The CI Build templates auto-increment the AppVersion on each run. In detail, the pipeline uses a counter based on a combination of following variables in your current pipeline (or <App-Repo>/.devops/variables.version.yaml (older templates)):

  # Please increase Major / Minor manually, when you plan a new release with significant changes
  - name:  'Version.Major'
    value: '17'
  - name:  'Version.Minor'
    value: '0'
  # auto-increment based on: [major].[minor] (variable 'Build' can overrule auto-increment)
  - name:  'Version.Build'
    value: $[ coalesce(variables['Build'], counter(format('{0}.{1}', variables['Version.Major'], variables['Version.Minor']), 0)) ]
  # by default 0 (auto-increment based on: [major].[minor].[build])
  - name:  'Version.Revision'
    value: $[ counter(format('{0}.{1}.{2}', variables['Version.Major'], variables['Version.Minor'], variables['Version.Build']), 0) ]
  # App-Version: [Major].[Minor].[Build].[Revision]
  - name:  'AppVersion'
    value: $[ format('{0}.{1}.{2}.{3}', variables['Version.Major'], variables['Version.Minor'], variables['Version.Build'], variables['Version.Revision']) ]
  • Major Version (fixed version)
  • Minor Version (fixed version)
  • Build version auto incremented by counter based on "Major.Minor"
  • Patch Version also auto incremented by counter, but always 0

To increment the Major or Minor version modify the variables in <App-Repo>/.devops/variables.version.yaml.

Example Minor Version Increment

Your current version is 17.0.453 (App-Version 17.0.453.0) and you want to release a new minor version. Therefor change the variables in your current pipeline (or <App-Repo>/.devops/variables.version.yaml (older templates)):

  # Please increase Major / Minor manually, when you plan a new release with significant changes
  - name:  'Version.Major'
    value: '17'
  - name:  'Version.Minor'
    value: '1'

Changed variable Version.Minor will cause the next build to have the Version 17.1.0 (App-Version 17.1.0.0).

Example Major Version Increment

Your current version is 17.0.453 (App-Version 17.0.453.0) and you want to release a new major version. Therefor change the variables in your current pipeline (or <App-Repo>/.devops/variables.version.yaml (older templates)):

  # Please increase Major / Minor manually, when you plan a new release with significant changes
  - name:  'Version.Major'
    value: '18'
  - name:  'Version.Minor'
    value: '0'

Changed variable Version.Major will cause the next build to have the Version 18.0.0 (App-Version 18.0.0.0).