Android Studio ビルドシステムは Gradle をベースにしており、Android Gradle プラグインは Android アプリのビルドに役立つ複数の機能を追加します。
このページでは、Gradle ツールを最新の状態に保つ方法について説明します。Android Gradle プラグインのリリースノートについては、リリースノートのページをご覧ください。
Android Gradle プラグインの今後の破壊的変更の概要については、Android Gradle プラグインのロードマップをご覧ください。
Gradle で Android ビルドを設定する方法の詳細については、下記のページをご覧ください。
Gradle ビルドシステムの詳細については、Gradle のユーザーガイドをご覧ください。
Android Gradle プラグインのアップデート
Android Studio をアップデートすると、Android Gradle プラグインを利用可能な最新バージョンに自動的にアップデートするように促すメッセージが表示されることがあります。アップデートに同意するか、プロジェクトのビルド要件に基づいて手動でバージョンを指定するかを選択できます。
プラグインのバージョンは、Android Studio の [File] > [Project Structure] > [Project] メニュー、または最上位の build.gradle.kts ファイルで指定できます。プラグインのバージョンは、その Android Studio プロジェクトでビルドされたすべてのモジュールに適用されます。次の例では、build.gradle.kts ファイルからプラグインをバージョン 9.0 に設定しています。
Kotlin
plugins { id("com.android.application") version "9.0" apply false id("com.android.library") version "9.0" apply false id("org.jetbrains.kotlin.android") version "2.2.21" apply false }
Groovy
plugins { id 'com.android.application' version '9.0' apply false id 'com.android.library' version '9.0' apply false id 'org.jetbrains.kotlin.android' version '2.2.21' apply false }
注意: バージョン番号には、'com.android.tools.build:gradle:9.+' などの動的な依存関係を使用しないでください。予期しないバージョンのアップデートが起こり、バージョンの相違を解決するのが難しくなる可能性があるためです。
指定したプラグイン バージョンがダウンロードされていない場合、次回のプロジェクトのビルド時に Gradle によってダウンロードされます。または、Android Studio のメニューバーから [File] > [Sync Project with Gradle Files] をクリックします。
Gradle のアップデート
Android Studio をアップデートすると、Gradle を利用可能な最新バージョンにアップデートするように促すメッセージが表示されることもあります。アップデートに同意するか、プロジェクトのビルド要件に基づいて手動でバージョンを指定するかを選択できます。
次の表に、Android Gradle プラグインの各バージョンに必要な Gradle のバージョンを示します。最高のパフォーマンスを得るには、Gradle とプラグインの両方について、最新バージョンを使用してください。
| プラグインのバージョン | 必要な Gradle の最小バージョン |
|---|---|
| 9.0 | 9.1.0 |
| 8.13 | 8.13 |
| 8.12 | 8.13 |
| 8.11 | 8.13 |
| 8.10 | 8.11.1 |
| 8.9 | 8.11.1 |
| 8.8 | 8.10.2 |
| 8.7 | 8.9 |
| 8.6 | 8.7 |
| 8.5 | 8.7 |
| 8.4 | 8.6 |
| 8.3 | 8.4 |
| 8.2 | 8.2 |
| 8.1 | 8.0 |
| 8.0 | 8.0 |
古いバージョン
| プラグインのバージョン | 必要な Gradle のバージョン |
|---|---|
| 7.4 | 7.5 |
| 7.3 | 7.4 |
| 7.2 | 7.3.3 |
| 7.1 | 7.2 |
| 7.0 | 7.0 |
| 4.2.0 以降 | 6.7.1 |
| 4.1.0 以降 | 6.5 以降 |
| 4.0.0 以降 | 6.1.1 以降 |
| 3.6.0 - 3.6.4 | 5.6.4 以降 |
| 3.5.0 - 3.5.4 | 5.4.1 以降 |
| 3.4.0 - 3.4.3 | 5.1.1 以降 |
| 3.3.0 - 3.3.3 | 4.10.1 以降 |
| 3.2.0 - 3.2.1 | 4.6 以降 |
| 3.1.0 以降 | 4.4 以降 |
| 3.0.0 以降 | 4.1 以降 |
| 2.3.0 以降 | 3.3 以降 |
| 2.1.3 - 2.2.3 | 2.14.1 - 3.5 |
| 2.0.0 - 2.1.2 | 2.10 - 2.13 |
| 1.5.0 | 2.2.1 - 2.13 |
| 1.2.0 - 1.3.1 | 2.2.1 - 2.9 |
| 1.0.0 - 1.1.3 | 2.2.1 - 2.3 |
Gradle のバージョンは、Android Studio の [File] > [Project Structure] > [Project] メニューで指定するか、コマンドラインを使用して Gradle のバージョンを更新できます。推奨される方法は、gradlew スクリプトを更新する Gradle ラッパー コマンドライン ツールを使用することです。次の例では、Gradle Wrapper を使用して Gradle のバージョンを 9.1.0 に設定しています。Gradle と Gradle Wrapper 自体の両方をアップグレードするには、このコマンドを 2 回実行する必要があります（詳しくは、Gradle Wrapper のアップグレードをご覧ください）。
gradle wrapper --gradle-version 9.1.0
ただし、AGP を更新したばかりで、現在の Gradle バージョンに準拠していない場合など、一部のケースでは失敗する可能性があります。この場合は、gradle/wrapper/gradle-wrapper.properties ファイルの Gradle 配布リファレンスを編集する必要があります。次の例では、gradle-wrapper.properties ファイルで Gradle のバージョンを 9.1.0 に設定しています。
...
distributionUrl = https\://services.gradle.org/distributions/gradle-9.1.0-bin.zip
...
Android Gradle プラグインと Android Studio の互換性
Android Studio ビルドシステムは Gradle をベースにしており、Android Gradle プラグイン（AGP）は Android アプリのビルドに役立つ複数の機能を追加します。次の表に、Android Studio の各バージョンに必要な AGP のバージョンを示します。
| Android Studio バージョン | 必要な AGP バージョン |
|---|---|
| Otter 3 Feature Drop | 2025.2.3 | 4.0 ～ 9.0 |
| Otter 2 Feature Drop | 2025.2.2 | 4.0 ～ 8.13 |
| Otter | 2025.2.1 | 4.0 ～ 8.13 |
| Narwhal 4 Feature Drop | 2025.1.4 | 4.0 ～ 8.13 |
| Narwhal 3 Feature Drop | 2025.1.3 | 4.0 ～ 8.13 |
| Narwhal Feature Drop | 2025.1.2 | 4.0 ～ 8.12 |
| Narwhal | 2025.1.1 | 3.2-8.11 |
| Meerkat Feature Drop | 2024.3.2 | 3.2-8.10 |
| Meerkat | 2024.3.1 | 3.2-8.9 |
古いバージョン
| Android Studio バージョン | 必要な AGP バージョン |
|---|---|
| Ladybug Feature Drop | 2024.2.2 | 3.2-8.8 |
| Ladybug | 2024.2.1 | 3.2-8.7 |
| Koala Feature Drop | 2024.1.2 | 3.2-8.6 |
| Koala | 2024.1.1 | 3.2-8.5 |
| Jellyfish | 2023.3.1 | 3.2-8.4 |
| Iguana | 2023.2.1 | 3.2-8.3 |
| Hedgehog | 2023.1.1 | 3.2-8.2 |
| Giraffe | 2022.3.1 | 3.2-8.1 |
| Flamingo | 2022.2.1 | 3.2-8.0 |
| Electric Eel | 2022.1.1 | 3.2-7.4 |
| Dolphin | 2021.3.1 | 3.2-7.3 |
| Chipmunk | 2021.2.1 | 3.2-7.2 |
| Bumblebee | 2021.1.1 | 3.2-7.1 |
| Arctic Fox | 2020.3.1 | 3.1-7.0 |
Android Gradle プラグインの新機能については、Android Gradle プラグインのリリースノートをご覧ください。
Android API レベルをサポートするツールの最小バージョン
特定の API レベルをサポートする Android Studio と AGP には最小バージョンがあります。プロジェクトの targetSdk または compileSdk で必要とされるバージョンよりも低いバージョンの Android Studio または AGP を使用すると、予期しない問題が発生する可能性があります。Android OS のプレビュー版をターゲットとするプロジェクトでは、最新プレビュー版の Android Studio と AGP の使用をおすすめします。Android Studio のプレビュー版を安定版と一緒にインストールできます。
Android Studio と AGP の最小バージョンは次のとおりです。
| API レベル | Android Studio の最小バージョン | AGP の最小バージョン |
|---|---|---|
| 36.1 | Narwhal 3 Feature Drop | 2025.1.3 | 8.13.0 |
| 36.0 | Meerkat | 2024.3.1 パッチ 1 | 8.9.1 |
| 35 | Koala Feature Drop | 2024.2.1 | 8.6.0 |
| 34 | Hedgehog | 2023.1.1 | 8.1.1 |
| 33 | Flamingo | 2022.2.1 | 7.2 |