Add support for Gradle 7.4 Version Catalogs

Gradle 7.0 introduced the “centralized declaration of dependencies”. Namely, dependencies can be aliased, grouped, and versioned in a TOML file. It would be incredibly nice if refreshVersions could target the libs.versions.toml file in future, rather than relying on a custom version.properties.

Update: notes from jmfayard

the plan for now is not to give up versions.properties

it’s to auto-generate the libraries versions catalog, with the placeholder version _ and use the typesafe accessors to help migrate an existing project to refreshVersions

Running $ ./gradlew refreshVersionsCatalog would

• Enable catalog version if necessary

// Enable Gradle's version catalog support
// https://docs.gradle.org/current/userguide/platforms.html
enableFeaturePreview("VERSION_CATALOGS")

• Generate versions.properties, with all version keys (marked as unused)
• Generate gradle/libs.dependencies.toml
• Use the IDE and auto-completion to replace hardcoded dependencies with refreshVerion’s dependency notations and versionCatalog or buildSrc/Libs.kt
• To help with this, this task will show which typesafe accessors are available $ ./ gradlew refreshVersionsMapping

androidx.car:car                             | AndroidX.car
com.retrofit:retrofit-converter-json          | Square.retrofit.converter.json
org.koin:koin                                  |  libs.koin

Documentation

• Sharing dependency versions between projects
• Cédric Champeau’s blog: Simplified version management with Gradle 7
• tivi/libs.versions.toml at 4e378d36d37a878060bc824ab63adcc5408b203b · chrisbanes/tivi

[jmfayard]

I’ve got news! cc @DanySK @beski @jsschneider @NikkyAI and all.

I implemented support for versions catalog:

• generating it automatically
• rewriting the files build.gradle(.kts) to use them
• adding dependency updates in gradle/libs.versions.toml

It’s published in the snapshot version "0.40.2-SNAPSHOT"

Have a look at the Testing? pargraph from the pull-request https://github.com/jmfayard/refreshVersions/pull/509

[jmfayard]

I have a plan to combine versions catalog and refreshVersions. I updated the issue with my notes