Plugin Android Gradle 8.3.0 (Feb 2024)

Plugin Android Gradle 8.3.0 merupakan rilis utama yang menyertakan berbagai peningkatan dan fitur baru.

Kompatibilitas

API level maksimum yang didukung plugin Android Gradle 8.3 adalah API level 34. Berikut adalah info kompatibilitas lainnya:

Versi minimum Versi default Catatan
Gradle 8.4 8.4 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 25.1.8937393 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.3.

Rilis patch

Berikut adalah daftar rilis patch di Android Studio Iguana dan plugin Android Gradle 8.3.

Android Studio Iguana | 2023.2.1 Patch 2 dan AGP 8.3.2 (April 2024)

Update minor ini mencakup perbaikan bug ini.

Android Studio Iguana | 2023.2.1 Patch 1 dan AGP 8.3.1 (Maret 2024)

Update minor ini mencakup perbaikan bug ini.

Dukungan untuk Katalog Versi Gradle

Android Studio mendukung Katalog Versi Gradle berbasis TOML, sebuah fitur yang memungkinkan Anda mengelola dependensi di satu lokasi pusat dan berbagi dependensi antar-modul atau project. Android Studio kini mempermudah konfigurasi katalog versi melalui saran editor dan integrasi dengan dialog Project Structure. Pelajari cara menyiapkan dan mengonfigurasi Katalog Versi Gradle atau cara memigrasikan build ke katalog versi.

Pelengkapan kode dan navigasi

Android Studio menawarkan pelengkapan kode saat Anda mengedit katalog versi dalam format file TOML atau menambahkan dependensi dari katalog versi ke file build. Untuk menggunakan pelengkapan kode, tekan Ctrl+Spasi (Command+Spasi di macOS). Selain itu, Anda dapat dengan cepat beralih dari referensi dependensi dalam file build.gradle aplikasi ke tempat yang dideklarasikan dalam katalog versi dengan menekan Ctrl+b (Command+b di macOS).

Pelengkapan kode saat menambahkan dependensi

Integrasi dengan dialog Project Structure

Jika project menggunakan katalog versi yang ditentukan dalam format file TOML, Anda dapat mengedit variabel yang telah ditentukan di sana melalui tampilan dialog Project Structure Variables (File > Project Structure > Variables) di Android Studio. Untuk setiap katalog versi, ada menu drop-down yang mencantumkan variabel dari katalog tersebut. Untuk mengedit variabel, klik nilainya dan timpa. Saat Anda menyimpan perubahan ini, file TOML akan diperbarui sebagaimana mestinya.

Variabel dari katalog versi di dialog Project Structure

Anda juga dapat memperbarui dependensi dalam dialog Project Structure tampilan Dependencies (File > Project Structure > Dependencies). Untuk memperbarui versi menggunakan dialog Project Structure, buka modul dan dependensi yang ingin Anda edit, lalu perbarui kolom Request Version. Saat Anda menyimpan perubahan ini, file TOML akan diperbarui. Perhatikan bahwa jika versi dependensi ditentukan menggunakan variabel, mengupdate versi secara langsung dengan cara ini akan mengganti variabel dengan nilai hardcode. Perlu diketahui juga bahwa menghapus dependensi dari file build, baik Anda menggunakan dialog Project Structure atau tidak, tidak akan menghapus dependensi dari katalog versi.

Dependensi dari katalog versi dalam dialog Project Structure

Masalah umum dan batasan

Berikut adalah masalah umum atau batasan terkait dukungan Katalog Versi Gradle di Android Studio.

  • Terjadi error saat menandai deklarasi alias plugin di file skrip Kotlin: saat Anda menambahkan deklarasi plugin dari formulir alias(libs.plugins.example), editor akan menambahkan garis bawah berwarna merah di bagian libs. Ini adalah masalah umum pada Gradle versi 8.0 dan yang lebih lama, serta akan diatasi dalam rilis Gradle mendatang.

  • Android Studio hanya mendukung katalog versi dalam format TOML: saat ini dukungan dialog penyelesaian kode, navigasi, dan Project Structure Android Studio hanya tersedia untuk katalog versi yang ditentukan dalam format file TOML. Namun, Anda tetap dapat menambahkan katalog versi secara langsung dalam file settings.gradle dan menggunakan dependensinya dalam project.

  • Navigasi untuk file build KTS tidak didukung: membuka definisi dependensi dalam katalog versi menggunakan Control+klik (Command+klik di macOS) belum didukung untuk file build yang ditulis menggunakan skrip Kotlin.

  • Firebase Assistant menambahkan dependensi secara langsung dalam skrip build: Firebase Assistant menambahkan dependensi secara langsung ke skrip build Anda, bukan melalui katalog versi.

  • Fungsi "Find usages" tidak didukung: menemukan penggunaan variabel katalog versi dalam file build lain belum didukung, baik file build berada di KTS atau Groovy. Artinya, penggunaan Control+klik (Command+klik di macOS) pada definisi variabel dalam katalog versi tidak mengarah pada file build tempat variabel digunakan.

  • Dialog Project Structure di Android Studio menampilkan beberapa file katalog jika berada dalam folder gradle root, tetapi tidak menampilkan katalog untuk build gabungan. Misalnya, jika Anda memiliki dua file katalog, satu untuk aplikasi dan satu untuk build gabungan, dialog Project Structure hanya akan menampilkan file katalog aplikasi. Anda dapat menggunakan build gabungan, tetapi Anda harus mengedit file TOML-nya secara langsung.

Insight SDK tambahan: masalah kebijakan

Android Studio menampilkan peringatan lint dalam file build.gradle.kts dan build.gradle serta di Dialog Struktur Project untuk SDK publik yang memiliki pelanggaran kebijakan Play di Google Play SDK Index. Anda harus memperbarui dependensi apa pun yang melanggar kebijakan Play karena pelanggaran ini dapat mencegah Anda memublikasikan ke Konsol Google Play pada masa mendatang. Peringatan pelanggaran kebijakan melengkapi peringatan versi usang yang ditampilkan oleh Android Studio.

Dukungan versi compileSdk Android Studio

Android Studio menampilkan peringatan jika project Anda menggunakan compileSdk yang tidak didukung oleh versi Android Studio saat ini. Jika tersedia, sebaiknya beralih ke versi Android Studio yang mendukung compileSdk yang digunakan oleh project Anda. Perhatikan bahwa mengupgrade Android Studio mungkin juga mengharuskan Anda mengupgrade AGP. AGP juga menampilkan peringatan di jendela alat Build jika compileSdk yang digunakan oleh project Anda tidak didukung oleh versi AGP saat ini.

Perubahan perilaku lint

Mulai dari plugin Android Gradle 8.3.0-alpha02, saat menjalankan lint pada modul, tugas analisis lint terpisah akan dijalankan untuk komponen utama dan pengujian modul. Alasan untuk perubahan ini adalah untuk meningkatkan performa. Untuk kembali ke perilaku sebelumnya, tetapkan android.experimental.lint.analysisPerComponent=false di file gradle.properties Anda.

Penyingkatan resource yang akurat aktif secara default

Penyingkatan resource yang tepat, yang menghapus entri yang tidak digunakan dari file resources.arsc dan menghilangkan file resource yang tidak digunakan, diaktifkan secara default. Jika penyingkatan ini diaktifkan, tabel resource Anda akan dikurangi dan hanya entri folder res yang direferensikan yang akan disertakan dalam APK.

Untuk menonaktifkan penyingkatan resource yang akurat, tetapkan android.enableNewResourceShrinker.preciseShrinking ke false dalam file gradle.properties project Anda.