A Gradle plugin that updates module and plugin versions in your *.gradle or *.gradle.kts files to the latest available versions.
This plugin depends on the Gradle Versions Plugin.
Maintainer: Patrik Erdes
Apply this plugin and the Gradle Versions Plugin.
Include in your build.gradle
plugins {
id 'se.patrikerdes.use-latest-versions' version '0.2.18'
id 'com.github.ben-manes.versions' version '0.41.0'
}or
buildscript {
repositories {
maven {
url "https://plugins.gradle.org/m2/"
}
jcenter()
}
dependencies {
classpath "se.patrikerdes:gradle-use-latest-versions-plugin:0.2.18"
classpath 'com.github.ben-manes:gradle-versions-plugin:0.41.0'
}
}
apply plugin: 'com.github.ben-manes.versions'
apply plugin: 'se.patrikerdes.use-latest-versions'
Include in your build.gradle.kts
plugins {
id("se.patrikerdes.use-latest-versions") version "0.2.18"
id("com.github.ben-manes.versions") version "0.41.0"
}or
buildscript {
repositories {
maven {
maven { url = uri("https://plugins.gradle.org/m2/") }
}
jcenter()
}
dependencies {
classpath("gradle.plugin.se.patrikerdes:gradle-use-latest-versions-plugin:0.2.18")
classpath("com.github.ben-manes:gradle-versions-plugin:0.41.0")
}
}
apply {
plugin("com.github.ben-manes.versions")
plugin("se.patrikerdes.use-latest-versions")
}
In case you have a Multi-project build and you have some common dependency configuration in some common file in root project
(like *.gradle file), you should apply plugin to all projects. Easiest way to do this is with allprojects block like:
plugins {
id 'se.patrikerdes.use-latest-versions' version '0.2.13'
id 'com.github.ben-manes.versions' version '0.41.0'
}
allprojects {
apply plugin: 'se.patrikerdes.use-latest-versions'
apply plugin: 'com.github.ben-manes.versions'
}
This is because se.patrikerdes.use-latest-versions plugin scans files for every project separately.
In case you handle dependencies per project separately this is not needed and you can apply plugin just to selected projects.
Given this build.gradle file:
plugins {
id 'se.patrikerdes.use-latest-versions' version '0.2.18'
id 'com.github.ben-manes.versions' version '0.19.0'
}
apply plugin: 'java'
repositories {
mavenCentral()
}
ext.log4jversion = '1.2.16'
ext.codecVersion = '1.9'
def commonsLoggingVersion = "1.1.2"
dependencies {
testCompile 'junit:junit:4.0'
compile "log4j:log4j:$log4jversion"
compile "commons-codec:commons-codec:" + codecVersion
compile group: 'commons-lang', name: 'commons-lang', version: '2.4'
compile group: 'commons-logging', name: 'commons-logging', version: commonsLoggingVersion
}If you run
gradle useLatestVersions
Your plugin and module dependencies in build.gradle will be updated – both inline version number and versions based on variables – and you build.gradle file will look like this:
plugins {
id 'se.patrikerdes.use-latest-versions' version '0.2.18'
id 'com.github.ben-manes.versions' version '0.41.0' // <- Updated
}
apply plugin: 'java'
repositories {
mavenCentral()
}
ext.log4jversion = '1.2.17' // <- Updated
ext.codecVersion = '1.11' // <- Updated
def commonsLoggingVersion = "1.2" // <- Updated
dependencies {
testCompile 'junit:junit:4.12' // <- Updated
compile "log4j:log4j:$log4jversion" // <- The variable above was updated
compile "commons-codec:commons-codec:" + codecVersion // <- The variable above was updated
compile group: 'commons-lang', name: 'commons-lang', version: '2.6' // <- Updated
compile group: 'commons-logging', name: 'commons-logging', version: commonsLoggingVersion // <- The variable above was updated
}gradle useLatestVersions
# Configuration and default values:
useLatestVersions {
# A whitelist of dependencies to update, in the format of group:name
# Equal to command line: --update-dependency=[values]
updateWhitelist = []
# A blacklist of dependencies to update, in the format of group:name
# Equal to command line: --ignore-dependency=[values]
updateBlacklist = []
# When enabled, root project gradle.properties will also be populated with
# versions from subprojects in multi-project build
# Equal to command line: --update-root-properties
updateRootProperties = false
# By default plugin tries to find all relevant gradle files (e.g. *.gradle, gradle.properties etc).
# This can be slow in some cases when project has a lot of gradle files. For example when using conventions
# in buildSrc. With this option you can specify what files should plugin search and check. Plugin will ignore
# files that don't exist. Empty list means use default strategy. File paths are relative to project dir.
#
# Example:
# versionFiles = ["gradle.build", "gradle.properties"]
# Will check just $projectDir/gradle.build and $projectDir/gradle.properties
#
# Note:
# You always have to specify file that has dependencies in some common dependency format with artifact coordinates,
# e.g. compileOnly "group:module:version" or compileOnly("group:module:version") or val dependency = "group:module:version" etc.
# For example if you set just versionFiles = ["gradle.properties"] this won't work, since plugin
# won't be able to correlate variable with artifact coordinates.
#
# Equal to command line: --version-files=[values]
versionFiles = []
# List of root project files to update when updateRootProperties is enabled.
# `build.gradle` is not an acceptable entry here as it breaks other expected
# functionality. Version variables in `build.gradle` need to be moved into
# a separate file which can be listed here.
# Equal to command line: --root-version-files=[values]
rootVersionFiles = ['gradle.properties']
}
Updates module and plugin versions in all *.gradle files in the project root folder or any subfolder to the latest
available versions. This task depends on the dependencyUpdates task in the
Gradle Versions Plugin to know which dependencies can be updated.
# gradle useLatestVersions && gradle useLatestVersionsCheckThis task will succeed if all available updates were successfully applied by useLatestVersions, and it will fail if
any of the updates were not successfully applied. This task depends on the dependencyUpdates task in the
Gradle Versions Plugin to know which dependencies were
successfully updated.
useLatestVersionsCheck can not run in the same gradle run as useLatestVersions, since the dependencyUpdates task
will check the *.gradle files as they were when the gradle build started, which means that it can not pick up the
changes applied by useLatestVersions.
If your Gradle version is 4.6 or higher, you can pass the --update-dependency flag to useLatestVersions and
useLatestVersionsCheck with a value in the format $GROUP:$NAME. A complete dependency group can be updated by
using the format $GROUP. Multiple dependencies can be updated by passing the flag multiple times.
# gradle useLatestVersions --update-dependency junit:junit --update-dependency com.google.guava && gradle useLatestVersionsCheck --update-dependency junit:junit --update-dependency com.google.guavaIf your Gradle version is 4.6 or higher, you can pass the --ignore-dependency flag to useLatestVersions and
useLatestVersionsCheck with a value in the format $GROUP:$NAME. A complete dependency group can be ignored by
using the format $GROUP. Multiple dependencies can be ignored by passing the flag multiple times.
# gradle useLatestVersions --ignore-dependency junit:junit --ignore-dependency com.google.guava && gradle useLatestVersionsCheck --ignore-dependency junit:junit --ignore-dependency com.google.guavaDependencies stated in the following formats should cause the version to be successfully updated by the
useLatestVersions task. (If not, please
create an issue.)
Single and double quotes are interchangeable in all formats below.
Plugin dependencies can only be updated in Gradle 4.4+.
The plugins DSL only allows a strict format, e.g. only string literals for the version number, so there is basically only one format to support.
plugins {
id 'se.patrikerdes.use-latest-versions' version '0.1.0'
}dependencies {
compile "log4j:log4j:1.2.15"
testCompile 'junit:junit:4.0'
}Currently only if the order is group, name, version, without other elements in between.
dependencies {
testCompile group: 'junit', name: 'junit', version: '4.0'
}def and ext. (extra properties extensions) can be used interchangeably in all example below.
ext.junit_version = '4.0'
dependencies {
testCompile "junit:junit:$junit_version"
}def junit_version = '4.0'
dependencies {
testCompile "junit:junit:${junit_version}"
}ext.junit_version = '4.0'
dependencies {
testCompile "junit:junit:" + junit_version
}Currently only if the order is group, name, version, without other elements in between.
ext.junit_version = '4.0'
dependencies {
testCompile group: 'junit', name: 'junit', version: junit_version
}Gradle version: 2.8 - 4.10.2 (Updating plugin dependencies only work in 4.4+)
Versions Plugin version: 0.12.0 - 0.41.0
JDK version: 7 - 11 (7 is targeted but not tested, 11 is currently not tested but is known to work)
- Clone or download this project.
- Open the project, for example in IntelliJ open the
build.gradlefile. - You can build the jar with the Gradle
assembletask, it will be inbuild/libs/. - If you want to use the plugin locally, first publish to your local Maven repository with the Gradle
publishToMavenLocaltask. - To use it in a different project, add to your
build.gradlefile
buildscript {
repositories {
mavenLocal()
}
dependencies{
classpath group: 'se.patrikerdes',
name: 'gradle-use-latest-versions-plugin',
version: '0.2.18'
}
}
apply plugin: se.patrikerdes.UseLatestVersionsPlugin
The Versions plugin can be configured to achieve this, it is documented in the Versions plugin README
From the Maven Versions Plugin goal called use-latest-versions
Fixed issue #57, kotlin("plugin.spring") isn't updated (ghmulti)
PR #53, Recognise kotlin plugin format, e.g. 'kotlin("jvm") version "1.5.10"' (MxKaras)
PR #52, Fix "The variable ... is assigned more than once" message if variable has another as a suffix (xenomachina)
PR #49, Add option to specify version files (asodja)
PR #45, Adding list of root files with variables to update (tony-schellenberg)
PR #41, Add support to update root gradle.properties (asodja)
PR #35, Add flag to ignore specific dependency updates (blacklist) (Balthasar Biedermann)
PR #36, Allow setting of outputDir and reportfileName (dependencyUpdates) (Balthasar Biedermann)
PR #27, Add flag to update only explicitly listed dependencies. (Ian Kerins)
Fixed issue #25, Don't crash when dependencyUpdates/report.json has a version range
Fixed issue #24, Allow for non-standard buildDir setting
PR #23, Changes to address issues with Gradle multi-project builds. (b-behan)
Support com.github.ben-manes.versions version 0.21.0
PR #18, Support kt files within buildSrc. (Balthasar Biedermann)
Fixed issue #14, Kotlin dsl separate named and unnamed group name and version. (Balthasar Biedermann)
Fixed issue #15, changed the README to contain the correct way to use the plugin in a buildscript block.
Made the plugin work on Windows.
Fixed issue 10, Multiple versions in gradle.properties (Balthasar Biedermann)
PR #12, Support dependencySet of Spring Dependency management plugin. (Balthasar Biedermann)
PR #13, Support classifier and extension in dependencies. (Balthasar Biedermann)
Fixed issue 7, Update version variables in gradle.properties file, again. (0.2.4 didn't fix #7)
Fixed issue 8, Support for string interpolation with curly braces ${}
Fixed issue 7, Update version variables in gradle.properties file.
Fixed issue 3, Output formats are forced to be json,xml. (Tony Baines)
Fixed issue 2, Hardcoded Milestone Usage.
Added support for Gradle Kotlin DSL build files. (Thomas Schouten)
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent