---

name: gradle-9 description: > Upgrade from Gradle 8.x to Gradle 9.x with plugin compatibility updates. Required for Java 25 support. Includes plugin version mappings and migration patterns. compatibility: Java projects using Gradle 8.x metadata: version: "1.0.0" technology: java category: modernization tags: - gradle - gradle-9 - build - plugins

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

Skill Contents

Sections

• When to Use (L22-L28)
• Target Versions (L48-L60)
• Quick Start (L61-L107)
• References (L108-L113)
• Plugin Migration Details (L114-L155)
• Related Skills (L156-L160)
• Related Commands (L161-L167)

Available Resources

📚 references/ - Detailed documentation

• plugin compatibility

---

Target Versions

Quick Start

1. Update Gradle Wrapper

Copy./gradlew wrapper --gradle-version=9.2.1

2. Update Plugin Versions

Copy# 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"

Copy// 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:

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

4. Validate

Copy./gradlew clean build test

References

Plugin Migration Details

Lombok Plugin (Freefair)

Copy# 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:

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

Spotless

Copy# 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

Copy# 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

Related Commands

This skill is referenced by:

• /prepare-to-gradle-9 - Prepare for Gradle 9 upgrade
• /prepare-to-java-25 - Java 25 preparation (requires Gradle 9)