Upgrade Gradle 9 Skill | Agent Skills

Upgrade Gradle 9

Upgrade from Gradle 8.x to Gradle 9.x with all required plugin updates.

When to Use

Recommended for all projects - Gradle 9.3.1 is now the standard
Upgrading to Java 25 (requires Gradle 9.x)
Need Gradle 9 features
Current Gradle 8.x plugins are deprecated
When asked to "prepare for Gradle 9"

Skill Contents

Available Resources

📚 references/ - Detailed documentation

plugin compatibility

Target Versions

| Component | Gradle 8.x | Gradle 9.x | Notes | |-----------|------------|------------|-------| | Gradle | 8.14.3 | 9.3.1 | Recommended for all projects | | Lombok Plugin | 8.14.2 | 9.2.0 | Freefair, aligned with Gradle 9 | | Spotless | 6.x | 8.2.1 | Major bump | | SonarQube | 6.x | 7.2.2.6593 | Major bump | | Bitso Develocity | 0.1.x | 0.2.8 | Bitso wrapper plugin (not upstream com.gradle.develocity) | | Flyway | 10.x | 11.19.0 | Stay on 11.x; Flyway 12.x may introduce breaking changes | | jOOQ | 9.x | 10.2 | If used | | Protobuf | 0.9.x | 0.9.6 | Gradle 9 compatible |

Quick Start

1. Update Gradle Wrapper

./gradlew wrapper --gradle-version=9.3.1

2. Update Plugin Versions

# gradle/libs.versions.toml
[plugins]
lombok = "io.freefair.lombok:9.2.0"
spotless = "com.diffplug.spotless:8.2.1"
sonarqube = "org.sonarqube:7.2.2.6593"
protobuf = "com.google.protobuf:0.9.6"
bitso-develocity = { id = "bitso.develocity", version = "0.2.8" }

// settings.gradle - use version catalog alias
plugins {
    alias(libs.plugins.bitso.develocity)  // Bitso wrapper plugin, not upstream com.gradle.develocity
}

3. Add JUnit Platform Launcher

Required for JUnit 5.11+ with Gradle 9:

subprojects {
    plugins.withType(JavaPlugin).configureEach {
        dependencies {
            testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
        }
    }
}

4. Validate

./gradlew clean build test

References

| Reference | Content | |-----------|---------| | references/plugin-compatibility.md | Plugin version mappings and known issues |

Plugin Migration Details

Lombok Plugin (Freefair)

# Old (Gradle 8.x)
lombok = "io.freefair.lombok:8.14.2"

# New (Gradle 9.x)
lombok = "io.freefair.lombok:9.2.0"

Requires Lombok 1.18.42 for Java 25 bytecode support:

lombok {
    version = libs.versions.lombok.get()  // 1.18.42
}

Spotless

# Old (Gradle 8.x)
spotless = "com.diffplug.spotless:6.x"

# New (Gradle 9.x)
spotless = "com.diffplug.spotless:8.2.1"

For Java 25 formatting, use palantir-java-format 2.74.0.

SonarQube

# Old (Gradle 8.x)
sonarqube = "org.sonarqube:6.x"

# New (Gradle 9.x)
sonarqube = "org.sonarqube:7.2.2.6593"

Related Skills

| Skill | Purpose | |-------|---------| | upgrade-spring-boot-3-5 | Upgrade Spring Boot first | | upgrade-java-25 | Java 25 requires Gradle 9 |

Agent Skills: Upgrade Gradle 9

Install this agent skill to your local

Skill Files