This chapter provides the information you need to migrate your Gradle 9.x builds to the latest Gradle release. For migrating from Gradle 4.x, 5.x, 6.x, 7.x, or 8.x see the older migration guide first.

We recommend the following steps for all users:

  1. Try running gradle help --scan and view the deprecations view of the generated Build Scan.

    Deprecations View of a Gradle Build Scan

    This lets you see any deprecation warnings that apply to your build.

    Alternatively, you can run gradle help --warning-mode=all to see the deprecations in the console, though it may not report as much detailed information.

  2. Update your plugins.

    Some plugins will break with this new version of Gradle because they use internal APIs that have been removed or changed. The previous step will help you identify potential problems by issuing deprecation warnings when a plugin tries to use a deprecated part of the API.

  3. Run gradle wrapper --gradle-version 9.1.0-20250628022042+0000 to update the project to 9.1.0-20250628022042+0000.

  4. Try to run the project and debug any errors using the Troubleshooting Guide.

Upgrading from 9.0 and earlier

Deprecations

Potential breaking changes