Tentang plugin Android Gradle

Sistem build Android Studio didasarkan pada Gradle. Plugin Android Gradle menambahkan beberapa fitur yang dikhususkan untuk mem-build aplikasi Android.

Halaman ini menjelaskan cara menjaga alat Gradle Anda agar selalu update. Untuk mengetahui catatan rilis plugin Android Gradle, lihat halaman catatan rilis.

Untuk mengetahui ringkasan tingkat tinggi tentang perubahan yang dapat menyebabkan gangguan pada plugin Android Gradle, lihat roadmap plugin Android Gradle.

Untuk mengetahui detail cara mengonfigurasi build Android dengan Gradle, lihat halaman berikut:

• Mengonfigurasi build Anda
• Referensi DSL plugin Android Gradle
• Referensi DSL Gradle
• Panduan pengguna performa Gradle

Untuk informasi sistem build Gradle selengkapnya, lihat Panduan pengguna Gradle.

Mengupdate plugin Android Gradle

Saat mengupdate Android Studio, Anda mungkin menerima permintaan untuk otomatis mengupdate plugin Android Gradle ke versi terbaru yang tersedia. Anda dapat memilih untuk menerima update atau menentukan versi secara manual berdasarkan persyaratan build project.

Anda dapat menentukan versi plugin di menu File > Project Structure > Project di Android Studio, atau dalam file build.gradle.kts level teratas. Versi plugin berlaku untuk semua modul yang dibuat di project Android Studio tersebut. Contoh berikut menetapkan plugin ke versi 9.3.0 dari build.gradle.kts file:

plugins {
    id("com.android.application") version "9.3.0" apply false
    id("com.android.library") version "9.3.0" apply false
    id("org.jetbrains.kotlin.android") version "2.3.21" apply false
}

plugins {
    id 'com.android.application' version '9.3.0' apply false
    id 'com.android.library' version '9.3.0' apply false
    id 'org.jetbrains.kotlin.android' version '2.3.21' apply false
}

Perhatian: Anda tidak boleh menggunakan dependensi dinamis dalam nomor versi, misalnya 'com.android.tools.build:gradle:9.3.+'. Penggunaan fitur ini dapat menyebabkan update versi yang tidak terduga dan kesulitan untuk mengatasi perbedaan versi.

Jika versi plugin yang ditentukan belum didownload, Gradle akan mendownloadnya pada project yang Anda build selanjutnya, atau klik File > Sync Project with Gradle Files dari panel menu Android Studio.

Mengupdate Gradle

Saat mengupdate Android Studio, Anda mungkin menerima permintaan untuk mengupdate juga Gradle ke versi terbaru yang tersedia. Anda dapat memilih untuk menerima update atau menentukan versi secara manual berdasarkan persyaratan build project.

Tabel berikut mencantumkan versi Gradle yang diperlukan untuk setiap versi plugin Android Gradle. Agar performanya optimal, Anda harus menggunakan Gradle dan plugin versi terbaru.

Anda dapat menentukan versi Gradle di menu File > Project Structure > Project di Android Studio, atau mengupdate versi Gradle menggunakan command line. Cara yang lebih disukai adalah menggunakan alat command line Gradle Wrapper, yang mengupdate skrip gradlew. Contoh berikut menetapkan versi Gradle ke 9.5.0 menggunakan Gradle Wrapper. Perhatikan bahwa Anda harus menjalankan perintah ini dua kali untuk mengupgrade Gradle dan Gradle Wrapper itu sendiri (untuk mengetahui informasi selengkapnya, lihat Mengupgrade Gradle Wrapper).

gradle wrapper --gradle-version 9.5.0

Namun, hal ini mungkin gagal dalam beberapa kasus, misalnya jika Anda baru saja mengupdate plugin Android Gradle dan plugin tersebut tidak lagi mematuhi versi Gradle saat ini. Dalam hal ini, Anda harus mengedit referensi distribusi Gradle dalam file gradle/wrapper/gradle-wrapper.properties. Contoh berikut menetapkan versi Gradle ke 9.5.0 dalam file gradle-wrapper.properties.

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

Kompatibilitas Android Studio dan plugin Android Gradle

Sistem build Android Studio didasarkan pada Gradle. Plugin Android Gradle (AGP) menambahkan beberapa fitur yang dikhususkan untuk membangun aplikasi Android. Tabel berikut mencantumkan versi AGP yang diperlukan untuk setiap versi Android Studio.

Untuk mendapatkan informasi tentang hal yang baru dalam plugin Android Gradle, lihat catatan rilis plugin Android Gradle.

Versi minimum alat untuk level API Android

Ada versi minimum Android Studio dan AGP yang mendukung level API tertentu. Menggunakan versi Android Studio atau AGP yang lebih rendah dari yang diperlukan oleh targetSdk atau compileSdk project Anda dapat menyebabkan masalah yang tidak terduga. Sebaiknya gunakan versi pratinjau terbaru Android Studio dan AGP untuk mengerjakan project yang menargetkan versi pratinjau Android OS. Anda dapat menginstal versi pratinjau Android Studio bersama dengan versi stabil.

Versi minimum Android Studio dan AGP adalah sebagai berikut: