From de464eefd787157543d81c4338f77b0fb63ce4b3 Mon Sep 17 00:00:00 2001 From: Louis CAD Date: Wed, 15 Nov 2023 23:26:06 +0100 Subject: [PATCH 1/3] Update doc for Versions Catalogs support. --- docs/add-dependencies.md | 22 +++------------------- 1 file changed, 3 insertions(+), 19 deletions(-) diff --git a/docs/add-dependencies.md b/docs/add-dependencies.md index 8e17e511f..e8c2ee34b 100644 --- a/docs/add-dependencies.md +++ b/docs/add-dependencies.md @@ -192,29 +192,13 @@ Can you use it with refreshVersions? Sure, just use the version placeholder (`_`). -### Using Gradle 7+ Versions Catalogs +### Using Gradle Versions Catalogs -Gradle 7 comes with its own feature for centralizing dependencies: [Versions Catalogs](https://docs.gradle.org/7.0-rc-1/userguide/platforms.html#sub:central-declaration-of-dependencies). +Gradle 7+ comes with its own feature for centralizing dependencies: [Versions Catalogs](https://docs.gradle.org/7.0-rc-1/userguide/platforms.html#sub:central-declaration-of-dependencies). With Versions Catalog, you have a file like `gradle/libs.versions.toml` where you can centralize all your dependencies and benefit from typesafe accessors in your `build.gradle[.kts]` file. -Since the feature is incubating, you need to enable it explicitly in the project's `settings.gradle[.kts]` file: -> `enableFeaturePreview("VERSION_CATALOGS")` - -Does that work well with refreshVersions? Yes, as long as you use the version placeholder (`_`). - -=== "gradle/libs.versions.toml" -``` -[libraries] -accompanist-coil = "com.google.accompanist:accompanist-coil:_" -accompanist-flowlayout = "com.google.accompanist:accompanist-flowlayout:_" -accompanist-insets = "com.google.accompanist:accompanist-insets:_" -... -``` - -In this configuration, the versions catalog centralizes the dependency notations, while refreshVersions takes care of setting and updating the versions. - -We have ideas to integrate Versions Catalogs deeper into refreshVersions, see [this issue](https://github.com/jmfayard/refreshVersions/issues/333). +We support updating this version catalog. If you want to keep versions in the `versions.properties` file, you can use the version placeholder (`_`). ### Using the libraries.gradle pattern From a8ab9aa13d6394246e4a0121c37720c4ea1c9c81 Mon Sep 17 00:00:00 2001 From: Louis CAD Date: Wed, 15 Nov 2023 23:26:23 +0100 Subject: [PATCH 2/3] Add link of Gradle 8 migration guide --- docs/setup.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/setup.md b/docs/setup.md index 2ea49de3d..c3ec7845e 100644 --- a/docs/setup.md +++ b/docs/setup.md @@ -36,6 +36,7 @@ You should also try to update the Gradle plugins present in your build to the la The Gradle documentation has detailed migration guides if you are stuck: +- From Gradle 8+: https://docs.gradle.org/current/userguide/upgrading_version_8.html - From Gradle 7+: https://docs.gradle.org/current/userguide/upgrading_version_7.html - From Gradle 6+: https://docs.gradle.org/current/userguide/upgrading_version_6.html - From Gradle 5.x: https://docs.gradle.org/current/userguide/upgrading_version_5.html From f468795286a890b7c436c365fe3ead98ec73bc8c Mon Sep 17 00:00:00 2001 From: Louis CAD Date: Wed, 15 Nov 2023 23:29:07 +0100 Subject: [PATCH 3/3] Mention Gradle 8.4 on website --- mkdocs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index 57a473b19..bd124527a 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -20,7 +20,7 @@ extra: gradlePluginPortal: https://plugins.gradle.org/plugin/de.fayard.refreshVersions slack: https://app.slack.com/client/T09229ZC6/CP5659EL9 version: - gradle: 8.3 + gradle: 8.4 refreshVersions: '0.60.3' snapshot: '0.60.4-SNAPSHOT' keyboard_shortcuts: