PC パソコン

Android Studio「Minimum supported Gradle version is 9.6.0」の解決方法

Android Gradle Plugin（AGP）9.4へ更新した後、Gradle Syncやビルドが「Minimum supported Gradle version is 9.6.0」で停止することがあります。これは通常、AGP 9.4が要求する最低バージョンよりプロジェクトのGradle Wrapperが古いことを示す互換性エラーです。

代表的なエラーログ

Minimum supported Gradle version is 9.6.0. Current version is 9.5.0.
Please fix the project's Gradle settings.

「Current version」の値はプロジェクトによって異なります。

原因

GoogleのAGP 9.4リリースノートでは、Gradleの最低・既定バージョンは9.6.0、JDKの最低・既定バージョンは17です。AGPだけを9.4へ上げ、gradle/wrapper/gradle-wrapper.propertiesが古いGradleを指定したままだと、AGPの初期化時に失敗します。

発生条件・対象バージョン

  • AGP 9.4.xを使用している
  • Gradle Wrapperが9.6.0未満である
  • Android Studio、コマンドライン、CIのいずれかがプロジェクトのWrapperでビルドしている

これは修正版を待つ既知不具合ではなく、AGP 9.4の公式な互換性要件です。AGPとGradleの組み合わせを揃える必要があります。

推奨する解決手順

1. 現在のGradleとJVMを確認する

./gradlew --version

Windowsではgradlew.bat --versionを実行します。

2. Gradle Wrapperを9.6.0へ更新する

./gradlew wrapper --gradle-version 9.6.0

Windowsではgradlew.bat wrapper --gradle-version 9.6.0です。タスクが起動できない場合は、gradle/wrapper/gradle-wrapper.propertiesを公式配布先へ変更します。

distributionUrl=https\://services.gradle.org/distributions/gradle-9.6.0-bin.zip

3. Wrapper一式をバージョン管理へ反映する

gradle-wrapper.propertiesのほか、更新されたgradle-wrapper.jar、gradlew、gradlew.batも確認してコミットします。これにより開発者とCIが同じGradleを使えます。

4. JDK 17以上を選ぶ

Android StudioのGradle JDKと、CIのJAVA_HOMEを確認します。

./gradlew --version
java -version

5. Syncとビルドを再実行する

./gradlew --stop
./gradlew clean
./gradlew assembleDebug

cleanは必須ではありませんが、更新後の確認には有効です。

代替策

Gradle 9.6.0へすぐ移行できない場合は、AGP 9.4への更新を一時的に戻し、現在のGradleと互換性がある以前のAGPを使います。対象AGPの公式互換表を確認し、AGPとGradleをセットで管理してください。PCへ新しいGradleをグローバルインストールするだけでは、古いWrapperを使うプロジェクトは直りません。

確認方法

  1. ./gradlew --versionでGradle 9.6.0以上、JVM 17以上が表示される
  2. Android StudioのGradle Syncが完了する
  3. ./gradlew assembleDebugが最低バージョンエラーなしで成功する
  4. CIでも./gradlewを使い、同じ結果になる

注意点

  • distributionUrlにはGradleの公式配布URLを使用します。
  • 再現性のためバージョンを固定し、動的な指定は避けます。
  • 別のエラーへ変わった場合は、JDK、サードパーティープラグイン、独自ビルドロジックのGradle 9.6対応を個別に確認します。

まとめ

「Minimum supported Gradle version is 9.6.0」は、AGP 9.4と古いGradle Wrapperの不一致を示します。Wrapperを9.6.0以上へ更新し、JDK 17以上を使用して、ローカルとCIの両方でビルドを確認してください。移行できない場合は、互換性のある以前のAGPへ一時的に戻します。

参照した公式情報

Amazon.co.jpで関連する書籍や商品を見る
スポンサーリンク