Search Gradle plugins

io.alcide.gradle-semantic-build-versioning

Owner: Niv

This is a Gradle settings-plugin that provides support for semantic versioning of builds. It is quite easy to use and extremely configurable. The plugin allows you to bump the major, minor, patch or pre-release version based on the latest version, which is identified from a git tag. It also allows you to bump pre-release versions based on a scheme that you define. The version can be bumped by using version-component-specific project properties or can be bumped automatically based on the contents of a commit message. If no manual bumping is done via commit message or project property, the plugin will increment the version-component with the lowest precedence; this is usually the patch version, but can be the pre-release version if the latest version is a pre-release one. The plugin does its best to ensure that you do not accidentally violate semver rules while generating your versions; in cases where this might happen the plugin forces you to be explicit about violating these rules. As this is a settings plugin, it is applied to settings.gradle and version calculation is therefore performed right at the start of the build, before any projects are configured. This means that the project version is immediately available (almost as if it were set explicitly - which it effectively is), and will never change during the build (barring some other, external task that attempts to modify the version during the build). While the build is running, tagging or changing the project properties will not influence the version that was calculated at the start of the build.

https://github.com/alcideio/gradle-semantic-build-versioning

Sources: https://github.com/alcideio/gradle-semantic-build-versioning

Version 4.2.2 (latest)

Created 13 May 2021.

This is a Gradle settings-plugin that provides support for semantic versioning of builds. It is quite easy to use and extremely configurable. The plugin allows you to bump the major, minor, patch or pre-release version based on the latest version, which is identified from a git tag. It also allows you to bump pre-release versions based on a scheme that you define. The version can be bumped by using version-component-specific project properties or can be bumped automatically based on the contents of a commit message. If no manual bumping is done via commit message or project property, the plugin will increment the version-component with the lowest precedence; this is usually the patch version, but can be the pre-release version if the latest version is a pre-release one. The plugin does its best to ensure that you do not accidentally violate semver rules while generating your versions; in cases where this might happen the plugin forces you to be explicit about violating these rules. As this is a settings plugin, it is applied to settings.gradle and version calculation is therefore performed right at the start of the build, before any projects are configured. This means that the project version is immediately available (almost as if it were set explicitly - which it effectively is), and will never change during the build (barring some other, external task that attempts to modify the version during the build). While the build is running, tagging or changing the project properties will not influence the version that was calculated at the start of the build.
Other versions 

Add this plugin to your build using the plugins DSL:

plugins {
  id("io.alcide.gradle-semantic-build-versioning") version "4.2.2"
}

See also:

  • Adding the plugin to build logic for usage in precompiled script plugins.

    See the relevant documentation for more information.

    Add this plugin as a dependency to <convention-plugins-build>/build.gradle(.kts):

    dependencies {
  implementation("io.alcide.gradle-semantic-build-versioning:io.alcide.gradle-semantic-build-versioning.gradle.plugin:4.2.2")
}
    It can then be applied in the precompiled script plugin:
    plugins {
  id("io.alcide.gradle-semantic-build-versioning")
}
  • The legacy method of plugin application. See the relevant documentation for more information. 
    buildscript {
  repositories {
    gradlePluginPortal()
  }
  dependencies {
    classpath("io.alcide.gradle-semantic-build-versioning:io.alcide.gradle-semantic-build-versioning.gradle.plugin:4.2.2")
  }
}

apply(plugin = "io.alcide.gradle-semantic-build-versioning")
  • Applying plugins to all subprojects .