Sistem build Android Studio didasarkan pada Gradle. Plugin Android Gradle menambahkan beberapa fitur yang dikhususkan untuk membangun aplikasi Android. Meskipun plugin Android Gradle (AGP) biasanya diupdate secara bersamaan dengan Android Studio, plugin ini (dan seluruh sistem Gradle) dapat berjalan secara terpisah dari Android Studio dan dapat diupdate secara terpisah.
Halaman ini menjelaskan cara menjaga alat Gradle Anda agar selalu update dan apa saja yang ada pada update terbarunya. Untuk catatan rilis versi plugin Android Gradle sebelumnya, lihat catatan rilis sebelumnya.
Untuk melihat apa yang telah diperbaiki dalam versi plugin Android Gradle ini, lihat masalah yang ditutup.
Untuk ringkasan tingkat tinggi tentang perubahan yang dapat menyebabkan gangguan yang akan datang di 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 Gradle DSL
- 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 8.4.0 dari file build.gradle.kts
:
Kotlin
plugins { id("com.android.application") version "8.4.0" apply false id("com.android.library") version "8.4.0" apply false id("org.jetbrains.kotlin.android") version "1.9.23" apply false }
Groovy
plugins { id 'com.android.application' version '8.4.0' apply false id 'com.android.library' version '8.4.0' apply false id 'org.jetbrains.kotlin.android' version '1.9.23' apply false }
Perhatian: Anda tidak boleh menggunakan dependensi dinamis dalam nomor
versi, misalnya
'com.android.tools.build:gradle:8.4.+'
.
Penggunaan fitur ini dapat menyebabkan update versi yang tidak terduga dan kesulitan
dalam menyelesaikan perbedaan versi.
Jika versi plugin yang ditentukan belum didownload, Gradle akan mendownloadnya pada saat berikutnya Anda membuat project, 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.
Versi plugin | Versi Gradle minimum yang diperlukan |
---|---|
8.4 | 8,6 |
8.3 | 8.4 |
8.2 | 8.2 |
8.1 | 8.0 |
8.0 | 8.0 |
7.4 | 7,5 |
Versi lama
Versi plugin | Versi Gradle yang diperlukan |
---|---|
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 |
Anda dapat menentukan versi Gradle pada menu File >
Project Structure > Project di Android Studio,
atau mengupdate versi Gradle menggunakan command line.
Cara yang direkomendasikan adalah menggunakan
alat command line Gradle Wrapper, yang memperbarui skrip gradlew
. Contoh berikut
menetapkan versi Gradle ke 8.4 menggunakan Gradle Wrapper.
Perhatikan bahwa Anda perlu menjalankan perintah ini dua kali untuk mengupgrade Gradle dan
Wrapper Gradle itu sendiri (untuk mengetahui informasi selengkapnya, lihat
Mengupgrade Wrapper Gradle).
gradle wrapper --gradle-version 8.4
Namun, hal ini mungkin gagal dalam beberapa kasus, misalnya jika Anda baru saja mengupdate AGP
dan tidak lagi mematuhi versi Gradle saat ini. Dalam hal ini, Anda perlu mengedit referensi distribusi Gradle dalam file gradle/wrapper/gradle-wrapper.properties
. Contoh berikut menetapkan versi Gradle ke 8.4 dalam file gradle-wrapper.properties
.
...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.4-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.
Versi Android Studio | Versi AGP yang diperlukan |
---|---|
Koala | 2024.1.1 | 3,2-8,5 |
Ubur-ubur | 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 |
Versi lama
Versi Android Studio | Versi AGP yang diperlukan |
---|---|
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 |
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:
Level API | Versi Android Studio minimum | Versi AGP minimum |
---|---|---|
Pratinjau VanillaIceCream | Ubur-ubur | 2023.3.1 | 8.4 |
34 | Hedgehog | 2023.1.1 | 8.1.1 |
33 | Flamingo | 2022.2.1 | 7.2 |
Perubahan pembuatan versi (November 2020)
Kami memperbarui penomoran versi untuk plugin Android Gradle (AGP) agar lebih cocok dengan alat build Gradle yang mendasarinya.
Berikut adalah perubahan penting:
AGP sekarang akan menggunakan pembuatan versi semantik, dan perubahan yang dapat menyebabkan gangguan akan ditargetkan untuk rilis utama.
Satu versi utama AGP akan dirilis per tahun, sejalan dengan rilis utama Gradle.
Rilis setelah AGP 4.2 adalah versi 7.0 dan akan memerlukan upgrade ke Gradle versi 7.x. Setiap rilis utama AGP akan memerlukan upgrade versi utama di alat Gradle yang mendasarinya.
API tidak akan digunakan lagi sekitar satu tahun sebelumnya, dengan fungsi penggantian yang tersedia secara bersamaan. API yang tidak digunakan lagi akan dihapus sekitar satu tahun kemudian selama update utama berikutnya.
Kompatibilitas
Level API maksimum yang didukung plugin Android Gradle 8.3 adalah API level 34. Berikut adalah info kompatibilitas lainnya:
Versi minimum | Versi default | Catatan | |
---|---|---|---|
Gradle | 8,6 | 8,6 | Untuk mempelajari lebih lanjut, lihat mengupdate Gradle. |
SDK Build Tools | 34.0.0 | 34.0.0 | Instal atau konfigurasi SDK Build Tools. |
NDK | T/A | 26.1.10909125 | Instal atau konfigurasi versi lain dari NDK. |
JDK | 17 | 17 | Untuk mempelajari lebih lanjut, lihat menyetel versi JDK. |
Berikut adalah fitur baru di plugin Android Gradle 8.4.
Rilis patch
Berikut adalah daftar rilis patch di Android Studio Jellyfish dan plugin Android Gradle 8.4.
Android Studio Jellyfish | 2023.3.1 Patch 2 dan AGP 8.4.2 (Juni 2024)
Update keamanan penting: Kerentanan keamanan di plugin GitHub yang tersedia di Android Studio Iguana | 2023.2.1 dan yang lebih tinggi dapat mengekspos token akses ke pihak yang tidak berwenang.
Perbaikan: Jetbrains menyelesaikan masalah ini pada produk platform IntelliJ, dan perbaikannya kini tersedia di Android Studio Jellyfish | 2023.3.1 Patch 2 (2023.3.1.20).
Jika sudah memiliki build Android Studio di saluran stabil, Anda bisa mendapatkan update dengan mengklik Help > Check for Updates (atau Android Studio > Check for Updates di macOS). Jika tidak, download build stabil terbaru.
Selain itu, jika Anda aktif menggunakan fungsi permintaan pull GitHub di IDE, kami sangat menyarankan agar Anda mencabut token GitHub apa pun yang digunakan oleh plugin. Karena plugin ini dapat menggunakan integrasi OAuth atau token akses pribadi (PAT), harap periksa keduanya dan cabut sesuai kebutuhan:
- Untuk mencabut akses integrasi OAuth, buka Applications > Authorized OAuth Apps dan cabut akses untuk token JetBrains IDE Integration.
- Untuk mencabut akses PAT, buka Token akses pribadi dan hapus token yang dikeluarkan untuk plugin GitHub. Nama token default-nya adalah plugin integrasi GitHub IntelliJ IDEA, tetapi Anda mungkin menggunakan nama kustom.
Setelah mencabut akses untuk token, Anda perlu menyiapkan plugin lagi untuk mendapatkan semua fitur plugin, termasuk operasi Git, agar berfungsi kembali.
Kami mohon maaf atas ketidaknyamanan yang ditimbulkan dan mendesak semua pengguna untuk segera melakukan update guna mengamankan kode dan data mereka.
Update minor ini juga menyertakan perbaikan bug ini.
Android Studio Jellyfish | 2023.3.1 Patch 1 dan AGP 8.4.1 (Mei 2024)
Update minor ini mencakup perbaikan bug ini.
Class library diciutkan
Mulai Plugin Android Gradle 8.4, jika project library Android diperkecil, class program yang disusutkan akan dipublikasikan untuk publikasi antar-project. Artinya, jika aplikasi bergantung pada versi subproject library Android yang diperkecil, APK akan menyertakan class library Android yang diperkecil. Anda mungkin perlu menyesuaikan aturan library keep jika ada class yang tidak ada dalam APK.
Jika Anda mem-build dan memublikasikan AAR, jar lokal yang menjadi dependensi library Anda akan disertakan sebagai tidak menyusut dalam AAR, yang berarti penyingkat kode tidak akan berjalan pada class tersebut.
Untuk kembali ke perilaku sebelumnya, setel
android.disableMinifyLocalDependenciesForLibraries
dalam file gradle.properties
dan
laporkan bug.
Versi AGP mendatang akan menghapus flag ini dan menghapus flag ini.