Semantic Version Plugin for Gradle

A Semantic Version Plugin for Gradle that manages a project version via a properties file, and provide tasks to automatically increment major, minor and patch build numbers.

Using the plugin

The plugin is published to the Plugin Portal; see instructions there: net.thauvin.erik.gradle.semver

Version Properties File

By default, a version.properties file will be created when Gradle is run:

#version.properties
version.major=1
version.minor=0
version.patch=0
version.preRelease=
version.buildMeta=

To change the version of your project, remove the version from your build.gradle and simply edit your the version properties file to match your version number.

If you need to change some of the property file or name of the properties key to match your own build environment. Please see the Configuration section.

Increment Version Tasks

The incrementMajor, incrementMinor and incrementPatch are available to automatically increment their respective and reset lower counterpart version numbers.

• incrementMajor will increment the major and set the minor and patch versions to 0.
• incrementMinor will increment the minor and set the path version to 0.

Examples

./gradlew incrementPatch ...

or in your gradle.build file:

someTask {
    dependsOn(incrementPatch)
    ...
}

Configuration

Version Properties

The following default properties are recognized:

Property	Description	Default
version.major	The major version.	1
version.minor	The minor version.	0
version.patch	The patch version.	0
version.preRelease	The pre-release version
version.buildMeta	The build metatdata version
version.preReleasePrefix	The pre-release prefix	-
version.buildMetaPrefix	The build metadata prefix	+
version.separator	The version separator.	.

The version number is built as follows:

version.major version.separtor version.minor version.separator version.preReleasePrefix version.preRelease version.buildMetaPrefix version.buildMeta

for example:

#version.properties
version.major=1
version.minor=0
version.patch=0
version.preRelease=beta
version.buildMeta=exp.sha.5114f85

projet.version will be 1.0.0-beta+exp.sha.5114f85 in Gradle.

Semver Task

The semver task is used to configure how the plugin will read/write the version properties file. It most cases it is not needed.

But, for example, if you wanted to save the version properties in a different file:

semver {
    properties = "my.version" // read and save properties in "my.version"
}

or using different property keys for the version data:

semver {
    majorKey = "major" // instead of the default version.major
    minorKey = "minor"
    patchKey = "patch"
    preReleaseKey = "release"
    buildMetaKey = "metadata"
}

which would match the data in my.version:

#my.version
major=1
minor=0
patch=0
release=beta
metadata=

The following task properties are available:

Properties	Description	Default
properties	The properties file.	version.properties
majorKey	The major property key.	version.major
minorKey	The minor property key.	version.minor
patchKey	The patch property key.	version.patch
preReleaseKey	The pre-release property key.	version.preRelease
preReleasePrefixKey	The build pre-release prefix key.	version.preReleasePrefix
buildMetaKey	The build metadata property key.	version.buildMeta
buildMetaPrefixKey	The build metadata prefix property key.	version.buildMetaPrefix
separatorKey	The separator property key.	version.separator

Source Code Generation

If you'd like to incorporate the version number data into your source code, please have a look at my Semantic Version Annotation Processor.