Gradle 9 Upgrade

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

When to Use

• Recommended for all projects - Gradle 9.2.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

Sections

• When to Use
• Target Versions
• Quick Start
• References
• Plugin Migration Details
• Related Skills
• Available Resources

Available Resources

📚 references/ - Detailed documentation

• plugin compatibility

---

Target Versions

Component	Gradle 8.x	Gradle 9.x	Notes
Gradle	8.14.3	9.2.1	Recommended for all projects
Lombok Plugin	8.14.2	9.2.0	Freefair for Gradle 9.2.1
Spotless	6.x	8.1.0	Major bump
SonarQube	6.x	7.2.2.6593	Major bump
Develocity	0.1.x	0.2.8	Compatibility
Flyway	10.x	11.19.0	If used
jOOQ	9.x	10.1.1	If used
Protobuf	0.9.x	0.9.6	Gradle 9 compatible

Quick Start

1. Update Gradle Wrapper

./gradlew wrapper --gradle-version=9.2.1

2. Update Plugin Versions

# gradle/libs.versions.toml
[plugins]
lombok = "io.freefair.lombok:9.2.0"
spotless = "com.diffplug.spotless:8.1.0"
sonarqube = "org.sonarqube:7.2.2.6593"
protobuf = "com.google.protobuf:0.9.6"

// settings.gradle
plugins {
    id 'bitso.develocity' version "${develocityPluginVersion}"  // 0.2.8
    id 'org.sonarqube' version "${sonarqubePluginVersion}"      // 7.2.2.6593
}

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.1.0"

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

• spring-boot-3-5 - Upgrade Spring Boot first
• java-25 - Java 25 requires Gradle 9