5.1.3

As part of this release we had 126 commits which resulted in 14 issues being closed.

Feature

• #1931 Add Github Actions BuildAgent

Bugs

• #1988 AppVeyor does not update the build number (version 5.1.3-beta.1+59)
• #1944 Tagged trees and blobs cause GitVersion to crash
• #1942 gitversion init - Option 5) Branch Increment mode crashes with an InvalidOperationException
• #1873 Could not load type 'System.ComponentModel.AsyncCompletedEventArgs'
• #1743 Fix for #1348, branch without commit take version from tag instead of branch name.

Improvements

• #1964 Identical config files are reported as ambiguous
• #1936 added missing overrides
• #1929 Exopose NoNormalize property for GitVersionTask
• #1921 GetVersion target does not update RepositoryBranch nor RepositoryCommit

Documentation

• #1935 (GH-1932) Convert to Wyam for Documentation
• #1924 Added Azure DevOps to the list of build platforms
• #1923 Rename azure-devops to azure-devops.md

SHA256 Hashes of the release artifacts

• 503a45fef002b771f77a74e85438e1906cc82f53548c1855c224920f259d84e6 gitversion-linux-5.1.3.tar.gz
• ae885c7eaf58f8af2350c4a8b258095bd6059f606d2b3bb6d6c9420b404f8545 gitversion-osx-5.1.3.tar.gz
• 8779071f8c21b7433e3caaf83e3e089082e1c5a671da13455569a18ca4042c94 gitversion-windows-5.1.3.tar.gz

5.1.2

As part of this release we had 19 commits which resulted in 13 issues being closed.

Bugs

• #1899 Change default increment strategy for release branches to None instead of Patch
• #1897 Release branch results in wrong version (default strategy is patch)
• #1896 Enable F# exe projects to use GitVersionTask
• #1885 Error running gitversion 5.1.1 with /? or --help Unhandled exception. System.NullReferenceException: Object reference not set to an instance of an object.
• #1883 GitVersionTask 5.1.0 - Error in Azure Devops private repos: Value cannot be null. Parameter name: source
• #1879 GH-1874, fix the nofetch behaviour, it was not correctly initialized
• #1876 GitVersionTask 5.1.1: object reference not set to an instance of object.
• #1875 GitVersion 5.1.1 AppVeyor: Input string was not in a correct format.
• #1874 Unexpected change in behavior causing TeamCity issue
• #1872 5.1.0 Error on Azure Devops ubuntu Agents

Improvement

• #1892 on exception show stack trace

Documentation

• #1884 Markdownlint clean up of the Contributing page.
• #1881 who.md: added Uno Platform

5.1.1

As part of this release we had 173 commits which resulted in 16 issues being closed.

Features

• #1849 Feature/netcore3.0
• #1762 Add -nonormalize option to disable normalize function

Bugs

• #1847 Add the xml namespace to work with MSBuild v14
• #1782 Azure Pipeline Task - default Config File path to GitVersion.yml doesn't work
• #1777 Only append /config if the user specified a configFilePath

Improvements

• #1871 adds Preview suffix to VSIX task name when appropriate
• #1865 Feature/di2
• #1861 Feature/di
• #1843 Change the implementation of AzureDevops task.
• #1838 Performance improvements - profiling and simple caching
• #1794 Feature/unit tests vsix
• #1793 Fix several issues related to worktree
• #1787 Fixed entrypoint for github actions

Documentation

• #1853 Fix typo
• #1840 Update teamcity docs with info about fetchallheads
• #1835 Docs Update - Azure DevOps piplines yml example

5.0.1

As part of this release we had 28 commits which resulted in 2 issues being closed.

Bug

• #1767 Allow head to move for dynamic repositories

Improvement

• #1741 Fix current branch variable name for GitLab CI

5.0.0

As part of this release we had 63 issues closed.

Features

• #1691 Allow overriding of the config file path
• #1654 Initial support of Drone
• #1599 Adding support to generate WiX version files
• #1591 Support for Team Foundation Server merge messages
• #1580 Integrate GitTool.Core code into GitVersion
• #1572 Docker naming scheme
• #1571 CentOS 7 docker based image
• #1488 Enable custom merge message formats via configuration
• #1451 Support for generic build servers, improved scripting support
• #1433 Provide a way to translate the PreReleaseLabel (alpha, beta etc) to a numeric value to avoid version collisions
• #1401 TfsTask - Add 'path' parameter
• #1378 Support for Team Foundation Server merge messages

Bugs

• #1758 #1754 Allow head to move when switching branches for dynamic repositories
• #1733 Latest GitVersionTask betas (since 5.0.0-beta3-44) fail on dotnet build
• #1665 GitVersion Azure Pipelines Task fails on linux
• #1643 GitVersionTask throws logging exceptions when task is reused, causing builds to fail.
• #1635 [Bugfix] CommitsSinceVersionSource decreases upon deleting a merged Release branch
• #1610 GitVersion .Net Core (Preview) Azure DevOps task error
• #1606 GitVersion cannot find remote master or develop from inherited branch config
• #1590 [Configuration Bugfix] source-branches is overwritten even if explicitly specified in the config
• #1553 GitVersion produces incompilable code if AssemblyInformationalVersion not defined for F#
• #1550 4.0.1-beta1-53: Fails to find the LibGit2Sharp.
• #1541 Ignore version numbers in branch names that are not release branches.
• #1540 Always compute mainline version with mainline commits
• #1536 Why do version numbers in branch names change the calculated version?
• #1525 Merging from develop to feature branch causes MinorPatch to change
• #1517 VSTS GitVersion Task Icon is Missing in build
• #1446 [Bugfix] Wrong version number observed in a feature branch after a tagged develop is merged into it
• #1410 [Bugfix] GitVersion crashes if there are multiple branches containing the keyword develop and the current branch has Increment policy set to Inherit with current commit being a merge commit
• #1275 GitVersion produces version with wrong commit count (release branch with feature branches on it)
• #1183 GitVersion produces incompilable code if AssemblyInformationalVersion not defined for F#
• #1035 Incorrect mainline version being calculated
• #520 HotFix tag affecting develop

Improvements

• #1724 added option to disable gitversiontask on build
• #1713 LibGit2Sharp update to 0.26.0 (2)
• #1704 Comply with the SemVer2.0 format in Metadata
• #1686 Enhance logic of getting current branch in case of drone
• #1657 SVG logo
• #1647 Add WiX define constants
• #1616 Make VSO Agent more robust
• #1605 Update GitVersionBuild.targets
• #1596 Add some tests for making a feature branch off of a release or a hotfix branch
• #1594 Added path parameter to the TfsTask
• #1593 Invalid release version after commit beetween merge release to develop
• #1584 Parallelize unit tests
• #1581 Removed GitTools.Core dependency
• #1562 GitVersion.exe is misspelled as GiVersion.exe
• #1537 Stability of MSBuild integration for future .NET Core releases
• #1487 Refactoring of merge message class
• #1473 GitVersionTask on the dotnet SDK docker image (microsoft/dotnet:2.1-sdk; Debian 9)

Documentation

• #1722 (doc) add a hint on using - vs. / for cli switches
• #1711 Remove reference to the "GitVersion for Bamboo" app
• #1619 Fix typo in docs: 'tag-number-pattern' instead of 'tag-name-pattern'
• #1479 Updating VSTS name

5.0.0-alpha.1

First alpha build of GitVersion 5, which in time will introduce a few breaking changes.

4.0.0 - Major Release

This is a major release produced as a result of a lot of hard work from many contributors, in all areas, including our own build and release process itself - which will continue to increment on, lot's of bug fixes and optimisations, and we now also run on .NET Core!

Please bear with us as we continue to evolve our release automation to take care of... these release notes right here! #1493

Hopefully we will come back to these release notes and update them at some stage in the near future.

v4.0.0-beta.14

• #1455 - Added .editorconfig and fixed cake tab/space mismatches contributed by Jake Ginnivan (JakeGinnivan)
• #1453 - 4.0 Release?
• #1449 - Mono Not finding Library /ibgit2-baa87df.so.24
• #1439 - GitReleaseNotes updates contributed by Artur (arturcic)
• #1438 - Update GitReleaseNotes contributed by Artur (arturcic)
• #1432 - Cake build - Don't hard code gitreleasenotes.exe path. contributed by Darrell (dazinator)
• #1431 - Fixes #1430 - gitreleasenotes step. contributed by Darrell (dazinator)
• #1430 - Appveyor build failing on master +fix
• #1428 - Add C++ (Modern/UWP,MFC, etc.) support for SemVer in GitVersion contributed by S. Tunney (stunney)
• #1420 - Versioning all assemblies
• #1416 - Update LibGit2Sharp to 0.25.0-preview-0033 contributed by Nathan Lowe (nlowe)
• #1395 - Version is different on a fresh repo clone
• #1393 - Update CONTRIBUTING.md contributed by Ilya Chudin (chuuddo)
• #1389 - VSTS - BuildNumber replacement not wanted
• #1388 - GitVersion.exe - dotnetcore
• #1387 - DotNetCore Docker Image
• #1385 - Fix issue Montonically increasing AssemblyFileVersion to satisfy the … contributed by Ruh Ullah Shah (ruhullahshah)
• #1383 - Filter tag method refactor followup contributed by Joseph Kingry (jkingry)
• #1381 - GitVersionTask Parallel restore issue when multi targeting
• #1380 - TFS Task fails when there are spaces in the agent path.
• #1375 - Support for bitbucket pull request merge message contributed by Pavel Teplukhin (Dobriy33)
• #1374 - Improve performance - Filter list of all tags first by those parsable to a semantic version contributed by Joseph Kingry (jkingry)
• #1373 - Updated NuGet 4.3.0+ support of SemVer 2.0.0 contributed by (AlirezaInGitHub)
• #1371 - #1355 Fix develop branch config in mainline mode contributed by Pavel Teplukhin (Dobriy33)
• #1368 - Fix dotnet publish and VS2017 contributed by MysticBoy (maikebing)
• #1366 - Montonically increasing AssemblyFileVersion to satisfy the MSI
• #1365 - switch GetMainlineTip from using branch config key to using the regex contributed by (tvoyle)
• #1364 - Finding mainline tip uses key instead of regex from branch config
• #1363 - Move packaging logic to cake
• #1362 - Command-line GitVersion in a Linux environment
• #1360 - Push v4.0.0-beta.13 to nuget
• #1352 - Fixing example command for installing libcurl3 contributed by Scott Ranger (scottrangerio)
• #1351 - Make sure GetVersion is called for project references contributed by Brandon Ording (bording)
• #1350 - Fix issue with "tracks-release-branches" and custom release branch names contributed by Vitaly (melnikvitaly)
• #1346 - Version in develop branch is ahead of master?
• #1344 - Docker improvements contributed by Neil Scholten (neilinger)
• #1342 - Fix/release issues contributed by Jake Ginnivan (JakeGinnivan)
• #1340 - Fix addin/tool versions contributed by Gary Ewan Park (gep13)
• #1339 - update README.md - fix minor typo contributed by John Wilson (wislon)
• #1338 - Add release documentation contributed by Jake Ginnivan (JakeGinnivan)
• #1337 - GitVersion is not L337 enough
• #1336 - Fix/possible infinite inherit contributed by Jake Ginnivan (JakeGinnivan)
• #1334 - Cannot exclude a prefix from the merge message when determining the next version
• #1331 - No valid git object identified by 'refs/remotes/origin/HEAD' exists in the repository.
• #1329 - MSBuild task does not create gitversion.properties file in Jenkins env
• #1324 - Add VS extension updater contributed by Taylor Southwick (twsouthwick)
• #1313 - removes all duplicate repos if not origin contributed by Jonathan Kuleff (JonCubed)
• #1311 - Errors when calculating for pull reqest
• #1296 - Question: New v4 Beta?
• #1269 - #1175 - NetStandard contributed by Darrell (dazinator)
• #1248 - Upgrade LibGit2Sharp from v0.23 to v0.24 contributed by Asbjørn Ulsberg (asbjornu)
• #1195 - StackoverflowException when using msbuild in VS2017 in 4.0.0-beta11
• #1065 - Version calculation performance on tfs build
• #1050 - VSTS build step does not check the build number for environment variables
• #932 - New mode: mainline +enhancement
• #895 - Add support for additional assembly metadata in AssemblyInfo.cs
• #878 - GitVersion doesn't pick up version tags assigned to the latest commit
• #138 - Support generating AssemblyVersion attributes in other languages +enhancement
• #117 - Log line number for version conflict
• #116 - Add Username+Password support to MSBuild Task

Commits: 2e1266b...4bc1e59

v4.0.0-beta.13

This release has been a long time coming, good news, the release process is being documented so any of the maintainers can perform releases.

• #1336 - Fix/possible infinite inherit contributed by Jake Ginnivan (JakeGinnivan)
• #1323 - Trunk Based Development branching strategy: Release build respecting commit tag, not branch name
• #1322 - License?
• #1320 - Expose the tag and sha of source commit
• #1319 - [Question] Can GitVersionTask be configured to only update specified Assembly*Versions and not others
• #1312 - #1150 Remove criteria preventing the download of prerelease versions … contributed by Justin (Tankatronic)
• #1309 - Maintain two major versions in parallel
• #1307 - .NET Standard 2.0: dotnet build fails
• #1306 - Add configuration parameter to format CommitDate #1305 contributed by Oliver Daum (ccHanibal)
• #1305 - Add configuration parameter to format CommitDate
• #1303 - Improve documentation for assembly version schemes contributed by Thomas Levesque (thomaslevesque)
• #1302 - Improve documentation for assembly-versioning-scheme and assembly-file-versioning-scheme
• #1299 - Trying to add assembly-file-versioning-scheme to GitVersion.yml file
• #1297 - honour increment config value for Mainline contributed by Jonathan Kuleff (JonCubed)
• #1295 - [Question] Is this Version flow possible?
• #1294 - +semver:patch does not seem to work with Mainline mode
• #1293 - Ensure that PreReleaseNumber is always a number contributed by Pedro Marques (pitermarx)
• #1291 - Improve ExecuteCore.ExecuteInternal when HEAD is not pointing at the desired branch contributed by (Jericho)
• #1289 - Incorrect calculated version on new branch without any commits
• #1287 - Improve shallow clone exception contributed by Asbjørn Ulsberg (asbjornu)
• #1283 - How to create vsix package from updated code?
• #1282 - Request failed with status code: 401
• #1280 - Closes #1274 - Removed system.web (replaced databinder.eval) contributed by Darrell (dazinator)
• #1279 - Fixes #1278 - ContinuaCI use environment variable not registry. contributed by Darrell (dazinator)
• #1278 - Continua Ci - uses registry - needs fix
• #1276 - Added Octopus Deploy to list contributed by Peter Neave (peterneave)
• #1274 - Remove System.Web dependency
• #1273 - Allow branch names starting with master contributed by Tim Barnett (tgbarnett)
• #1272 - Allow branch names starting with master contributed by Tim Barnett (tgbarnett)
• #1271 - Allow for brach names to start with reserved names
• #1270 - VSTS GitVersion variables are not resolved when tagging sources
• #1268 - Per-folder configuration for monorepo support
• #1265 - GitVersionTask.targets for buildMultitarget does not output AssemblyInfo
• #1264 - Nitpicky typo correction contributed by Curtis Buice (cbuice)
• #1263 - How to run GitVersion in Mono?
• #1260 - VsoAgentBuildNumberTests refactored with accordance to the remark from @asbjornu contributed by (dpurge)
• #1259 - Changing hardcoded master/develop regex contributed by Paul Wiens (pwiens)
• #1258 - #1257 Fix regexp in VsoAgent contributed by (dpurge)
• #1257 - TFS build number overwritten fully instead of only replacing gitversion variables
• #1256 - use correct possessive pronoun contributed by Stephen Eidson (rarrarrarr)
• #1252 - Wrong variable names in documentation
• #1251 - Need some help to configure
• #1249 - Clean up AssemblyInfo file updating contributed by Brandon Ording (bording)
• #1247 - Sync FileVersion contributed by Brandon Ording (bording)
• #1242 - GitVersionInformation in SDK-style projects
• #1241 - FileVersion inconsistency between UpdateAssemblyInfo and UpdateVersionProperties
• #1237 - add a null check for the merge base contributed by Simon Cropp (SimonCropp)
• #1230 - nullref in GitRepoMetadataProvider.FindMergeBase
• #1228 - Update mkdocs.yml to fix typo contributed by Craig Russell (CDRussell)
• #1227 - GitVersion /output buildserver does not create gitversion.properties file
• #1225 - Pick better merge base contributed by Jake Ginnivan (JakeGinnivan)
• #1224 - Feature/fix mainline feature branch bump contributed by Jake Ginnivan (JakeGinnivan)
• #1223 - Add failing test for issue #1221 contributed by Maxime Beaudry (mabead)
• #1221 - Increment 'Minor' number when merging feature branch in master in Mainline mode
• #1220 - Added 'EnsureWixToolsetInstalled' BeforeTarget to GetVersionTask.targets contributed by Forest Balk (forestb)
• #1219 - Improvements to Dockerfile contributed by Ben Hall (BenHall)
• #1211 - Wrong pull request version when branching from a tagged merge commit contributed by Morten Larsen (baunegaard)
• #1204 - Invalid release version when some branch created from it contributed by (czesiu)
• #1202 - Random exception - this remote has never connected
• #1195 - StackoverflowException when using msbuild in VS2017 in 4.0.0-beta11
• #1112 - More caching of merge bases contributed by Daniel Rose (DanielRose)
• #1110 - Gitversion fails on buildserver
• #1043 - LibGit2Sharp.NotFoundException: Object not found - no match for id
• #886 - AssemblyFileVersionAttribute format configurable +enhancement
• #544 - MajorMinorPatchTag - AssemblyVersion vs AssemblyFileVersion +fix

v4.0.0-beta.12

• Bug fixes
• Docker image

Proper release notes coming soon