Android Studio ビルドシステムは、Gradle と Android Gradle をベースにしています。 プラグインは、Android アプリのビルドに固有の機能をいくつか追加します。ただし、 Android Gradle プラグイン（AGP）は通常、Android とのロックステップでアップデートされる プラグイン（および他の Gradle システム）は、プラグイン（および他の Gradle システム）を 個別に更新できます。
このページでは、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 プロジェクトでビルドされたすべてのモジュールに適用されます。次の例では、
バージョン 8.6.0 へのプラグインを
build.gradle.kts ファイル:
Kotlin
plugins {
id("com.android.application") version "8.6.0" apply false
id("com.android.library") version "8.6.0" apply false
id("org.jetbrains.kotlin.android") version "2.0.20" apply false
}
Groovy
plugins {
id 'com.android.application' version '8.6.0' apply false
id 'com.android.library' version '8.6.0' apply false
id 'org.jetbrains.kotlin.android' version '2.0.20' apply false
}
注意: バージョンでは動的な依存関係を使用しないでください。
たとえば、
'com.android.tools.build:gradle:8.6.+'。
この機能を使用すると、予期しないバージョン アップデートが発生し、
解消されます。
指定したプラグイン バージョンがダウンロードされていない場合、次回のプロジェクトのビルド時に Gradle によってダウンロードされます。または、Android Studio のメニューバーから [File] > [Sync Project with Gradle Files] をクリックします。
Gradle のアップデート
Android Studio をアップデートすると、Gradle を利用可能な最新バージョンにアップデートするように促すメッセージが表示されることもあります。アップデートに同意するか、プロジェクトのビルド要件に基づいて手動でバージョンを指定するかを選択できます。
次の表に、Android Gradle プラグインの各バージョンに必要な Gradle のバージョンを示します。最高のパフォーマンスを得るには、Gradle とプラグインの両方について、最新バージョンを使用してください。
| プラグインのバージョン | 最小限必要な Gradle バージョン |
|---|---|
| 850 | 8.7 |
| 8.4 | 8.6 |
| 8.3 | 8.4 |
| 8.2 | 8.2 |
| 8.1 | 8.0 |
| 8.0 | 8.0 |
| 7.4 | 7.5 |
古いバージョン
| プラグインのバージョン | 必要な Gradle のバージョン |
|---|---|
| 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 のバージョンは、[File] >
プロジェクトの構造 >Android Studio の [Project] メニュー
コマンドラインを使用して Gradle のバージョンを更新します。
推奨される方法は、
Gradle ラッパー
コマンドライン ツール。gradlew スクリプトを更新します。次の
この例では、Gradle ラッパーを使用して Gradle のバージョンを 8.6 に設定しています。
Gradle と
Gradle ラッパー自体（詳細については、
Gradle ラッパーのアップグレード）。
gradle wrapper --gradle-version 8.6
ただし、AGP を更新したばかりの場合などは、これが失敗することがあります。
現在の Gradle バージョンとの互換性がない状態になっています。この例では
Gradle ディストリビューション参照を編集する必要があります。
gradle/wrapper/gradle-wrapper.properties ファイル。次の
この例では、次のようにして Gradle のバージョンを 8.6 に設定します。
gradle-wrapper.properties ファイル。
...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.6-bin.zip
...
Android Gradle プラグインと Android Studio の互換性
Android Studio ビルドシステムは Gradle をベースにしており、Android Gradle プラグイン（AGP）は Android アプリのビルドに役立つ複数の機能を追加します。次の表に、Android Studio の各バージョンに必要な AGP のバージョンを示します。
| Android Studio バージョン | 必要な AGP バージョン |
|---|---|
| テントウムシ |2024 年 2 月 1 日 | 3.2 ～ 8.7 |
| Koala Feature Drop |2024 年 1 月 2 日 | 3.2 ～ 8.6 |
| コアラ |2024 年 1 月 1 日 | 3.2 ～ 8.5 |
| クラゲ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 |
古いバージョン
| Android Studio バージョン | 必要な AGP バージョン |
|---|---|
| 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 の使用をおすすめします。Google Chat では
インストール
Android Studio のプレビュー版と安定版のプレビュー版をご覧ください。
Android Studio と AGP の最小バージョンは次のとおりです。
| API レベル | Android Studio の最小バージョン | AGP の最小バージョン |
|---|---|---|
| VanillaIceCream のプレビュー | クラゲ2023 年 3 月 1 日 | 8.4 |
| 34 | Hedgehog | 2023.1.1 | 8.1.1 |
| 33 | Flamingo | 2022.2.1 | 7.2 |
バージョニングの変更（2020 年 11 月）
基盤となる Gradle ビルドツールのバージョン番号により近い番号で管理できるよう、Android Gradle プラグイン（AGP）のバージョン番号の付け方を変更します。
主な変更点は次のとおりです。
AGP はセマンティック バージョニングを使用するようになり、互換性のない変更はメジャー リリースとして扱われます。
Gradle のメジャー リリースに合わせて、AGP のメジャー バージョンを年 1 回リリースします。
AGP 4.2 の次のリリースはバージョン 7.0 となり、Gradle のバージョンも 7.x にアップグレードする必要があります。AGP のメジャー リリースのたびに、基盤となる Gradle ツールのメジャー バージョン アップグレードが必要になります。
API はメジャー リリースの約 1 年前からサポート終了となり、それと同時に代替機能が利用可能になります。サポートが終了した API は、約 1 年後のメジャー アップデート時に削除されます。
互換性
Android Gradle プラグイン 8.6 がサポートする最大 API レベルは、API レベル 34 です。 その他の互換性に関する情報は次のとおりです。