Set min Gradle requirement via GradlePluginApiVersion attribute (#1176)

https://www.liutikas.net/2025/10/15/Gradle-Version-Checking.html

Author: Goooler

gradle/libs.versions.toml

@@ -1,5 +1,6 @@
 [versions]
 jdkRelease = "11"
+minGradle = "8.13"
 
 gradle = "9.1.0"
 

plugin/build.gradle.kts

@@ -1,3 +1,5 @@
+import org.gradle.api.plugins.JavaPlugin.API_ELEMENTS_CONFIGURATION_NAME
+
 plugins {
   id("shared")
   id("java-gradle-plugin")
@@ -32,6 +34,14 @@ val integrationTestSourceSet = sourceSets.create("integrationTest") {
 val integrationTestImplementation = configurations["integrationTestImplementation"]
   .extendsFrom(configurations.testImplementation.get())
 
+configurations.named(API_ELEMENTS_CONFIGURATION_NAME) {
+  attributes.attribute(
+    // TODO: https://github.com/gradle/gradle/issues/24608
+    GradlePluginApiVersion.GRADLE_PLUGIN_API_VERSION_ATTRIBUTE,
+    objects.named(libs.versions.minGradle.get()),
+  )
+}
+
 buildConfig {
   packageName("com.vanniktech.maven.publish")
   buildConfigField("String", "NAME", "\"com.vanniktech.maven.publish\"")
@@ -62,6 +72,7 @@ buildConfig {
         .asProvider()
         .get(),
     )
+    buildConfigField("GRADLE_MIN", libs.versions.minGradle)
     buildConfigField(
       "ANDROID_GRADLE_ALPHA",
       alpha.versions.android.gradle

plugin/src/integrationTest/kotlin/com/vanniktech/maven/publish/TestOptions.kt

@@ -80,7 +80,7 @@ enum class GradleVersion(
 ) {
   // minimum supported
   GRADLE_MIN(
-    value = "8.13",
+    value = Versions.GRADLE_MIN,
     firstUnsupportedJdkVersion = JavaVersion.VERSION_24,
   ),
 

plugin/src/main/kotlin/com/vanniktech/maven/publish/MavenPublishBasePlugin.kt

@@ -3,7 +3,6 @@ package com.vanniktech.maven.publish
 import org.gradle.api.Plugin
 import org.gradle.api.Project
 import org.gradle.api.publish.maven.plugins.MavenPublishPlugin as GradleMavenPublishPlugin
-import org.gradle.util.GradleVersion
 
 public abstract class MavenPublishBasePlugin : Plugin<Project> {
   override fun apply(project: Project) {
@@ -15,9 +14,6 @@ public abstract class MavenPublishBasePlugin : Plugin<Project> {
   }
 
   private fun Project.checkMinimumVersions() {
-    if (GradleVersion.current() < MIN_GRADLE_VERSION) {
-      error("You need Gradle version $MIN_GRADLE_VERSION or higher, was ${GradleVersion.current()}")
-    }
     plugins.withId("com.android.library") {
       if (!isAtLeastUsingAndroidGradleVersion(8, 0, 0)) {
         error("You need AGP version 8.0.0 or newer")
@@ -41,7 +37,6 @@ public abstract class MavenPublishBasePlugin : Plugin<Project> {
   }
 
   private companion object {
-    val MIN_GRADLE_VERSION: GradleVersion = GradleVersion.version("8.13")
     val KOTLIN_PLUGIN_IDS = listOf(
       "org.jetbrains.kotlin.jvm",
       "org.jetbrains.kotlin.multiplatform",