Catatan rilis plugin Android Gradle 8.13

Repositori JCenter menjadi hanya baca pada tanggal 31 Maret 2021. Untuk informasi selengkapnya, lihat pembaruan layanan JCenter.

Sistem build Android Studio didasarkan pada Gradle. Plugin Android Gradle menambahkan beberapa fitur yang dikhususkan untuk mem-build aplikasi Android. Meskipun plugin Android Gradle (AGP) biasanya diupdate secara bersamaan dengan Android Studio, plugin ini (dan seluruh sistem Gradle) dapat berjalan secara independen 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 mengetahui catatan rilis versi plugin Android Gradle sebelumnya, lihat catatan rilis sebelumnya.

Untuk 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:

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.13.2 dari file build.gradle.kts:

Kotlin

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

Groovy

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

Perhatian: Anda tidak boleh menggunakan dependensi dinamis dalam nomor versi, misalnya 'com.android.tools.build:gradle:8.13.+'. 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.

Versi pluginVersi Gradle minimum yang diperlukan
8.138.13
8.128.13
8.118.13
8.108.11.1
8.98.11.1
8.88.10.2
8.78.9
8.68.7
8.58.7
8.48.6
8.38.4
8.28.2
8.18.0
8.08.0

Versi lama

Versi pluginVersi Gradle yang diperlukan
7.47,5
7.37.4
7.27.3.3
7.17.2
7,07,0
4.2.0+6.7.1
4.1.0+6.5+
4.0.0+6.1.1+
3.6.0 - 3.6.45.6.4+
3.5.0 - 3.5.45.4.1+
3.4.0 - 3.4.35.1.1+
3.3.0 - 3.3.34.10.1+
3.2.0 - 3.2.14.6+
3.1.0+4.4+
3.0.0+4.1+
2.3.0+3.3+
2.1.3 - 2.2.32.14.1 - 3.5
2.0.0 - 2.1.22.10 - 2.13
1.5.02.2.1 - 2.13
1.2.0 - 1.3.12.2.1 - 2.9
1.0.0 - 1.1.32.2.1 - 2.3

Anda dapat menentukan versi Gradle di menu File > Project Structure > Project di Android Studio, atau memperbarui versi Gradle menggunakan command line. Cara yang lebih disarankan adalah menggunakan alat command line Gradle Wrapper, yang memperbarui skrip gradlew. Contoh berikut menetapkan versi Gradle ke 8.13 menggunakan Gradle Wrapper. Perhatikan, Anda perlu 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 8.13

Namun, hal ini mungkin gagal dalam beberapa kasus, misalnya jika Anda baru saja mengupdate AGP dan AGP tidak lagi sesuai dengan 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.13 dalam file gradle-wrapper.properties. 

...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.13-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
Update Fitur Baru Otter 2 | 2025.2.2 4.0-8.13
Otter | 2025.2.1 4.0-8.13
Update Fitur Baru Narwhal 4 | 2025.1.4 4.0-8.13
Update Fitur Baru Narwhal 3 | 2025.1.3 4.0-8.13
Update Fitur Baru Narwhal | 2025.1.2 4.0-8.12
Narwhal | 2025.1.1 3.2-8.11
Update Fitur Meerkat | 2024.3.2 3.2-8.10
Meerkat | 2024.3.1 3.2-8.9

Versi lama

Versi Android Studio Versi AGP yang diperlukan
Update Fitur Baru Ladybug | 2024.2.2 3.2-8.8
Ladybug | 2024.2.1 3.2-8.7
Update Fitur Baru Koala | 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

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
36,1 Update Fitur Baru Narwhal 3 | 2025.1.3 8.13.0
36,0 Meerkat | 2024.3.1 Patch 1 8.9.1
35 Update Fitur Baru Koala | 2024.2.1 8.6.0
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.

Plugin Android Gradle 8.13.2

Dukungan Kotlin 2.3: Plugin Android Gradle 8.13.2 menggunakan R8 8.13.19 yang mendukung Kotlin 2.3.

Kompatibilitas

Level API maksimum yang didukung oleh plugin Android Gradle 8.13 adalah level API 36. Berikut info kompatibilitas lainnya:

Versi minimum Versi default Catatan
Gradle 8.13 8.13 Untuk mempelajari lebih lanjut, lihat mengupdate Gradle.
SDK Build Tools 35.0.0 35.0.0 Instal atau konfigurasi SDK Build Tools.
NDK T/A 27.0.12077973 Instal atau konfigurasi versi lain dari NDK.
JDK 17 17 Untuk mempelajari lebih lanjut, lihat menyetel versi JDK.

Perbaikan masalah

Plugin Android Gradle 8.13.2

Perbaikan Masalah
Plugin Android Gradle
AAPT2 dari AGP 8.12.0 memerlukan SSSE3 dan SSE4_1 yang tidak didukung oleh server build F-Droid
Penyingkat (R8)
Dukungan untuk Kotlin 2.3: Update library kotlin-metadata-jvm ke 2.2.10.
RemoveVerificationErrorForUnknownReturnedValues dapat menyebabkan error verifikasi kunci

Plugin Android Gradle 8.13.1

Perbaikan Masalah
Plugin Android Gradle
ID resource baru dari grafik navigasi tidak diselesaikan selama kompilasi inkremental
compileSdkSpec.minorApiLevel tidak berfungsi dengan SettingsExtension
Penyingkat (R8)
Aplikasi error saat runtime dengan java.lang.VerifyError menggunakan R8 8.11 dan versi berikutnya
ApiModeling menyebabkan SurfaceTexture error selama eksekusi runtime.
Penciutan resource yang dioptimalkan gagal dengan java.lang.StringIndexOutOfBoundsException saat nama class diakhiri dengan $
Potensi bug runtime: Duplikasi metode R8 + cache interpreter ART menyebabkan ketidakcocokan superclass
D8 menghapus kolom yang digunakan
AGP 8.13.0: r8 gagal dengan ERROR: R8: java.lang.NullPointerException: Tidak dapat memanggil "Object.getClass()" karena "<local7>" adalah null
Beberapa atribut SourceFile di r8lib.jar tidak benar
Versi R8 yang disertakan dengan AGP 8.12.0+ dapat menghasilkan error kehabisan memori dengan Play Billing 8.0.0
R8 merusak fungsi Inline, suspend
Kode ilegal dibuat setelah pengoptimalan dengan R8 8.11.18

Plugin Android Gradle 8.13.0

Perbaikan Masalah
Plugin Android Gradle
Menjalankan CheckAarMetadataTask di project library saat membangun AAR
Plugin Fused Library tidak dapat memproses referensi resource dari library eksternal
Plugin Fused Library harus mengizinkan penggunaan overrideLibrary
Mengubah nilai default targetSdk aplikasi agar didasarkan pada compileSdk, bukan minSdk
`com.android.kotlin.multiplatform.library` error dengan Perangkat yang Dikelola Gradle
Penyingkat (R8)
ClassCastException dari class yang tidak mungkin dengan R8
ArrayIndexOutOfBoundsException: Indeks 0 di luar batas untuk panjang 0 sejak 8.10.0
Penguraian pola di API enableExperimentalPartialShrinking sangat ketat