Halaman ini mencantumkan fitur baru yang diperkenalkan dalam rilis pratinjau Android Studio. Build pratinjau memberikan akses awal ke fitur dan penyempurnaan terbaru di Android Studio. Anda dapat mendownload versi pratinjau ini. Jika Anda mengalami masalah saat menggunakan versi pratinjau Android Studio, beri tahu kami. Laporan bug Anda akan membantu kami menyempurnakan Android Studio.
Rilis canary berisi fitur-fitur terbaru yang sedang dalam pengembangan aktif, dan diuji sebagian. Meskipun Anda dapat menggunakan build Canary untuk pengembangan, perlu diketahui bahwa fitur dapat ditambahkan atau diubah. Release Candidate (RC) adalah versi Android Studio berikutnya, dan hampir siap untuk dirilis versi stabilnya. Kumpulan fitur untuk versi berikutnya telah distabilkan. Lihat Nama rilis Android Studio untuk memahami penamaan versi Android Studio.
Untuk mengetahui berita terbaru tentang rilis pratinjau Android Studio, termasuk daftar perbaikan penting dalam setiap rilis pratinjau, lihat Update Rilis di blog Android Studio.
Versi Android Studio saat ini
Tabel berikut mencantumkan versi Android Studio saat ini dan saluran masing-masing.
Versi | Saluran |
---|---|
Update Fitur Baru Android Studio Narwhal | 2025.1.2 | Stabil |
Plugin Android Gradle 8.12.0 | Stabil |
Update Fitur Baru Android Studio Narwhal 3 | 2025.1.3 | RC |
Update Fitur Baru Android Studio Narwhal 4 | 2025.1.4 | Canary |
Kompatibilitas dengan pratinjau plugin Android Gradle
Setiap versi pratinjau Android Studio dipublikasikan bersama dengan versi plugin Android Gradle (AGP) yang sesuai. Versi pratinjau Studio harus berfungsi dengan versi stabil AGP yang kompatibel. Namun, jika Anda menggunakan versi pratinjau AGP, Anda harus menggunakan versi pratinjau Studio yang sesuai (misalnya, Android Studio Chipmunk Canary 7 dengan AGP 7.2.0-alpha07). Upaya untuk menggunakan versi yang berbeda (misalnya, Android Studio Chipmunk Beta 1 dengan AGP 7.2.0-alpha07) akan menyebabkan kegagalan Sinkronisasi, yang akan memunculkan perintah untuk mengupdate ke versi AGP yang sesuai.
Untuk mengetahui log mendetail penghentian dan penghapusan API plugin Android Gradle, lihat update API plugin Android Gradle.
Studio Labs
Studio Labs memungkinkan Anda mencoba fitur eksperimental AI terbaru dalam versi Android Studio yang stabil, sehingga Anda dapat mengintegrasikan penawaran bantuan AI kami dengan lebih cepat dalam alur kerja pengembangan Anda. Untuk mengetahui informasi selengkapnya, lihat Studio Labs.
Berikut adalah fitur yang saat ini tersedia di Studio Labs.
Fitur | Deskripsi | Dokumen |
---|---|---|
Pembuatan pratinjau Compose | Gemini dapat otomatis membuat pratinjau Compose, termasuk data tiruan untuk parameter pratinjau, untuk composable tertentu atau semua composable dalam file. | Membuat pratinjau Compose |
Lampirkan gambar | Lampirkan gambar ke kueri Anda untuk membantu membuat UI, men-debug bug UI, mendokumentasikan arsitektur aplikasi, dan lainnya. | Melampirkan gambar |
Lampirkan file | Lampirkan file ke kueri Anda untuk membantu Gemini lebih memahami konteks pertanyaan Anda dan mengidentifikasi kode yang perlu diperbarui. | Melampirkan file |
Transformasi UI | Gunakan bahasa alami untuk memperbarui UI aplikasi Anda langsung dari panel pratinjau Compose. | Transform UI |
Update Fitur Baru Android Studio Narwhal 3 | 2025.1.3
Berikut adalah fitur baru di Update Fitur Baru Android Studio Narwhal 3 | 2025.1.3.
Untuk melihat apa yang telah diperbaiki dalam versi Android Studio ini, lihat masalah yang ditutup.
Pratinjau Compose yang dapat diubah ukurannya
Pratinjau Compose kini mendukung pengubahan ukuran dinamis untuk memberikan masukan visual instan tentang cara UI Anda beradaptasi dengan berbagai ukuran layar.
Untuk menggunakan fitur ini, masuk ke mode Fokus di Pratinjau Compose dengan mengubah opsi tampilan di toolbar:

Anda kini dapat mengubah ukuran jendela pratinjau dengan menarik tepinya:
Atau, Anda dapat menggunakan toolbar pengubahan ukuran, yang ditampilkan setelah pratinjau diubah ukurannya:
Jika Anda ingin menyimpan ukuran baru sebagai anotasi Preview
baru, gunakan menu klik kanan:

Fitur pengubahan ukuran dinamis membantu Anda membuat UI yang terlihat bagus di semua ukuran layar.
Setelan tampilan Android untuk menampilkan file build di modul yang sesuai
Ada setelan baru untuk menampilkan file build di bawah modul yang sesuai
dalam tampilan Android. Tampilan ini dapat membantu saat Anda mengerjakan project dengan banyak modul. Untuk mengaktifkan tampilan, buka menu Opsi
yang tersedia di samping tampilan Android.
Kemudian, pilih Appearance > Display Build Files In Module.

Insight Kebijakan Google Play di Android Studio
Android Studio kini menyertakan insight dan panduan yang lebih lengkap tentang kebijakan Google Play yang mungkin memengaruhi aplikasi Anda. Informasi ini membantu Anda membangun aplikasi yang lebih aman sejak awal, sehingga mencegah masalah yang dapat mengganggu proses peluncuran dan memerlukan lebih banyak waktu dan sumber daya untuk diperbaiki di kemudian hari.
Mulai dari Update Fitur Baru Android Studio Narwhal 3, Anda dapat melihat Insight Kebijakan Play sebagai pemeriksaan lint. Pemeriksaan lint ini akan menampilkan informasi berikut:
- Ringkasan kebijakan.
- Anjuran dan larangan untuk menghindari kesalahan umum.
- Link ke halaman kebijakan Play tempat Anda dapat menemukan kebijakan formal lengkap dan informasi serta referensi bermanfaat lainnya.
Fitur ini dimaksudkan untuk memberikan panduan prapeninjauan yang bermanfaat sehingga Anda dapat memiliki pengalaman pengiriman aplikasi yang lebih lancar. Fitur ini tidak mencakup setiap kebijakan, dan tidak memberikan keputusan akhir peninjauan aplikasi. Selalu tinjau kebijakan selengkapnya di Pusat Kebijakan untuk mendapatkan panduan. Kami juga secara aktif mengembangkan dan meningkatkan kualitas integrasi ini. Jika Anda memiliki masukan, harap laporkan.
Untuk melihat apakah ada Insight Kebijakan Google Play untuk project Anda, buka Code > Inspect for Play Policy Insights… Insight akan tercantum di jendela alat 'Problems' dan juga akan muncul sebagai peringatan Lint di file yang sesuai.

Menguji dan mengembangkan dengan pencadangan dan pemulihan aplikasi
Memastikan Pencadangan dan Pemulihan Android berfungsi dengan benar untuk aplikasi Anda adalah aspek penting untuk memastikan pengguna tetap berinteraksi dengan aplikasi Anda setelah beralih ke perangkat baru atau memulihkan dari cloud. Namun, menguji apakah pencadangan dan pemulihan data berfungsi untuk aplikasi Anda bisa sulit.
Android Studio Narwhal menyediakan cara bagi Anda untuk membuat cadangan aplikasi dan memulihkannya ke perangkat lain. Hal ini dapat berguna untuk menguji apakah aplikasi Anda berperilaku seperti yang diharapkan saat memulihkan data aplikasi dari perangkat ke perangkat atau dari cadangan cloud, atau jika Anda menginginkan cara yang lebih cepat untuk menyiapkan perangkat pengujian dengan data yang Anda butuhkan untuk mengembangkan dan men-debug aplikasi.
Membuat cadangan
Untuk membuat file cadangan, lakukan hal berikut:
- Men-deploy versi debug aplikasi Anda ke perangkat yang terhubung
- Gunakan salah satu tindakan berikut untuk membuat cadangan:
- Dari jendela Running Device, klik tindakan Backup App Data dari toolbar
- Pilih Run > Backup App Data dari panel menu utama
- Dari tab Device Explorer > Processes, klik kanan proses aplikasi, lalu pilih Backup App Data
- Pada dialog yang muncul, lakukan hal berikut:
- Konfirmasi ID aplikasi untuk aplikasi yang ingin Anda buat cadangannya
- Pilih apakah Anda ingin membuat cadangan Perangkat ke Perangkat, Cloud, atau Cloud (Tidak Terenkripsi)
- Konfirmasi nama dan lokasi cadangan yang ingin Anda simpan. Secara
default, cadangan disimpan ke direktori root project Android Studio
saat ini.
Buat cadangan untuk aplikasi Anda.
- Konfirmasi ID aplikasi untuk aplikasi yang ingin Anda buat cadangannya
- Klik Oke saat Android Studio menanyakan apakah aplikasi dapat dihentikan. Untuk membuat cadangan, Android Studio harus menghentikan proses aplikasi.
Anda dapat melihat cadangan yang Anda buat di jendela alat Project > Android di bawah node Backup Files.
Jenis cadangan
Anda dapat membuat berbagai jenis cadangan untuk aplikasi Anda. Saat membuat cadangan, pilih jenis cadangan yang terkait dengan skenario yang ingin Anda uji:
- Perangkat ke perangkat: Membuat cadangan aplikasi Anda, mirip dengan cadangan yang dibuat selama transfer perangkat ke perangkat. Dalam transfer perangkat ke perangkat, data pencadangan aplikasi dikirim langsung ke perangkat lain, misalnya melalui USB atau Wi-Fi.
- Cloud: Membuat cadangan aplikasi Anda, mirip dengan cadangan yang disimpan ke penyimpanan Akun Google pengguna. Saat menyiapkan perangkat baru, pengguna dapat memilih untuk memulihkan dari cadangan Cloud.
- Cloud (tidak dienkripsi): Membuat cadangan aplikasi Anda, serupa dengan cadangan yang disimpan ke penyimpanan Akun Google pengguna di perangkat yang tidak mengaktifkan enkripsi sisi klien.
Catatan: Saat menggunakan fitur untuk menguji Cloud, Cloud (Tidak Terenkripsi) atau Pencadangan Perangkat ke Perangkat, cadangan yang dibuat tidak dikirim ke Cloud atau ke perangkat lain, tidak seperti alur pencadangan sebenarnya. Layanan ini membuat cadangan aplikasi Anda seolah-olah akan disimpan ke Cloud atau dikirim ke perangkat lain. Cadangan yang dibuat untuk jenis Pencadangan apa pun dapat berada di bagian File Cadangan di jendela alat Project > Android.
Memulihkan data aplikasi
Untuk memulihkan data aplikasi, lakukan hal berikut:
- Deploy aplikasi Anda ke perangkat yang terhubung. Aplikasi harus memiliki ID aplikasi yang sama dengan file cadangan yang ingin Anda pulihkan ke perangkat.
- Buka dan klik salah satu tindakan berikut:
- Dari jendela Running Device, klik tindakan Restore App Data dari toolbar, lalu pilih file cadangan dari histori terbaru atau klik Browse.
- Buka Run > Restore App Data dari panel menu utama.
- Dari tab Device Explorer > Processes, klik kanan proses aplikasi dan pilih Restore App Data.
- Dari jendela alat Project > Android, klik kanan cadangan di bawah node Backup Files, lalu pilih Restore App Data.
- Jika berlaku, pilih cadangan dari histori terbaru atau klik Jelajahi untuk memilih file cadangan yang akan dipulihkan dari penyimpanan lokal.
Atau, Anda dapat menyertakan file cadangan sebagai bagian dari konfigurasi run, sehingga men-deploy aplikasi juga memulihkan data aplikasi dari file cadangan. Untuk melakukannya, lakukan hal berikut:
- Buka Run > Edit Configurations dari panel menu utama.
- Pilih konfigurasi eksekusi aplikasi dan buka Opsi pemulihan.
Memulihkan opsi dalam konfigurasi run. - Untuk memulihkan aplikasi dari cadangan, centang kotak di samping Pulihkan status aplikasi.
- Pilih file cadangan dari histori terbaru atau jelajahi dan pilih file cadangan dari penyimpanan lokal.
- Jika Anda hanya ingin memulihkan data aplikasi pada penginstalan aplikasi baru, centang kotak di samping Hanya pulihkan pada penginstalan APK baru. Opsi ini dapat berguna jika Anda men-deploy ke perangkat pengujian baru dan ingin memulihkan data untuk membantu proses penelusuran bug dan pengembangan aplikasi.
- Klik OK untuk menyimpan konfigurasi run.
- Deploy aplikasi Anda menggunakan konfigurasi run untuk menguji pemulihan data aplikasi Anda ke perangkat yang terhubung.
Pemeriksaan Proguard
Android Studio kini menyertakan pemeriksaan untuk mencegah aturan Proguard yang dibuat dengan buruk, atau aturan yang mencegah pengoptimalan R8. Aturan penyimpanan yang terlalu luas seperti
-keep class **.*
dan konfigurasi aturan Proguard konsumen seperti
dontshrink
dan -dontoptimize
kini memicu peringatan di IDE Studio. Untuk
membuat aturan keep yang baik yang memungkinkan penyusutan kode, cakup aturan ke
paket tertentu dan nyatakan secara eksplisit apa yang ingin Anda pertahankan.
File AGENT.md untuk konteks tingkat project
Sekarang Anda dapat menyertakan file AGENT.md
dalam project Anda. File ini adalah file Markdown yang memberikan petunjuk khusus project, aturan gaya coding, dan panduan lainnya kepada Gemini sebagai konteks.
Gemini otomatis menemukan dan menerapkan petunjuk dari file apa pun yang bernama
AGENT.md
di project Anda. Jika file AGENT.md
tidak ada, Gemini akan mencari file GEMINI.md
sebagai penggantinya.
Setelan baru untuk menonaktifkan Sinkronisasi Otomatis
Android Studio kini menawarkan setelan untuk beralih dari mode Sinkronisasi Otomatis default (misalnya, Sinkronisasi berjalan otomatis saat project dibuka) ke mode Sinkronisasi Manual baru dengan pengingat. Perilaku defaultnya tetap Sinkronisasi Otomatis. Untuk beralih ke Sinkronisasi Manual, buka File (Android Studio di macOS) > Settings > Build, Execution, Deployment > Build Tools dan tetapkan Project Sync mode ke Manual Sync with reminders sebagai Project Sync mode.
Fitur yang lulus dari Studio Labs
Fitur eksperimental berikut dari Studio Labs bersifat stabil mulai dari Update Fitur Baru Narwhal 3:
Update Fitur Baru Android Studio Narwhal 4 | 2025.1.4
Berikut adalah fitur baru di Update Fitur Baru Android Studio Narwhal 4 | 2025.1.4.
Untuk melihat apa yang telah diperbaiki dalam versi Android Studio ini, lihat masalah yang ditutup.
Perjalanan untuk Android Studio
Journeys for Android Studio membantu mempermudah penulisan dan pemeliharaan pengujian end-to-end dengan memungkinkan Anda menggunakan bahasa alami untuk mendeskripsikan langkah-langkah dan pernyataan untuk setiap pengujian—yang disebut perjalanan. Dengan memanfaatkan kemampuan visi dan penalaran Gemini, langkah-langkah yang ditulis dalam bahasa alami dikonversi menjadi tindakan yang dilakukan Gemini di aplikasi Anda, sehingga memudahkan penulisan dan pemahaman perjalanan Anda. Selain itu, Anda dapat menulis dan mendeskripsikan pernyataan yang lebih kompleks, yang dievaluasi Gemini berdasarkan apa yang dilihatnya di perangkat untuk menentukan apakah perjalanan Anda berhasil atau gagal.
Karena Gemini mempertimbangkan tindakan mana yang harus dilakukan untuk memenuhi sasaran, perjalanan lebih tangguh terhadap perubahan kecil pada tata letak atau perilaku aplikasi Anda, sehingga menghasilkan lebih sedikit pengujian yang tidak stabil saat dijalankan terhadap berbagai versi aplikasi dan konfigurasi perangkat yang berbeda.
Tulis dan jalankan perjalanan langsung dari Android Studio terhadap perangkat Android lokal atau jarak jauh. IDE memberikan pengalaman editor baru untuk membuat perjalanan serta hasil multimedia yang membantu Anda lebih memahami alasan dan eksekusi perjalanan Anda oleh Gemini.
Pencadangan dan Sinkronisasi

Sekarang Anda dapat mencadangkan setelan Android Studio ke penyimpanan cloud menggunakan akun Google atau JetBrains Anda. Hal ini membantu menyinkronkan setelan Anda, seperti peta tombol, setelan Editor Kode, setelan sistem, dan lainnya. Untuk memulai, lakukan salah satu hal berikut:
Setelah membuka project di Android Studio, login ke Akun Google Anda dengan mengklik avatar di pojok kanan atas IDE, lalu mengklik Login.
- Ikuti perintah dalam dialog yang muncul dan pastikan untuk mencentang kotak guna mengizinkan Android Studio mengakses Penyimpanan Akun Google Anda.
- Ikuti perintah untuk memberikan otorisasi pada Android Studio.
Buka Setelan > Pencadangan dan Sinkronisasi.
- Pilih Google untuk menggunakan Penyimpanan Akun Google Anda guna menyinkronkan data aplikasi di seluruh penginstalan Android Studio. Atau, Anda dapat menggunakan akun JetBrains untuk menyinkronkan data aplikasi di seluruh penginstalan IntelliJ dan Android Studio.
- Setelah Anda mengikuti perintah untuk mengizinkan Android Studio mengakses penyimpanan akun pilihan Anda, kembali ke Android Studio.
- Di halaman Setelan > Pencadangan dan Sinkronisasi, Anda dapat meninjau kategori data aplikasi yang ingin disinkronkan ke akun Anda.
- Untuk menonaktifkan Pencadangan dan Sinkronisasi, hapus centang pada kotak yang mengaktifkan fitur tersebut.
Jika Anda sudah menyinkronkan data ke perangkat yang dipilih, Android Studio akan memberi Anda opsi untuk mendownload setelan dari penyimpanan jarak jauh (ini adalah opsi default) atau mengupload setelan lokal dan mengganti setelan yang disinkronkan ke penyimpanan jarak jauh.
Saran perbaikan untuk error
Di Update Fitur Baru Android Studio Meerkat, kami meluncurkan insight Gemini untuk error yang dilaporkan di jendela alat App Quality Insights. Sekarang, Android Studio dapat menggunakan Gemini untuk menganalisis data error bersama dengan kode sumber Anda untuk menyarankan potensi perbaikan. Setelah memilih error di jendela alat App Quality Insights, buka tab Insights, lalu klik Sarankan perbaikan setelah Gemini membuat insight untuk error tersebut. Kemudian, Gemini membuat saran perubahan kode yang dapat Anda tinjau dan terima di tab perbedaan editor.

Setelan baru untuk membuka project baru dengan tampilan Project
Ada setelan baru agar project baru terbuka di tampilan Project secara default. Untuk mengaktifkan setelan, buka File (Android Studio di macOS) > Settings > Advanced Settings > Project View lalu pilih Set Project view as the default.
Alat pengujian Screenshot Pratinjau Compose
Gunakan alat Pengujian Screenshot Pratinjau Compose untuk menguji UI Compose Anda dan mencegah regresi. Alat baru ini membantu Anda membuat laporan HTML yang memungkinkan Anda mendeteksi secara visual setiap perubahan pada UI aplikasi. Pelajari lebih lanjut di Pengujian Screenshot Pratinjau Compose.
Peningkatan component tree Layout Inspector tersemat
Berinteraksi dengan hierarki komponen di Layout Inspector Tersemat kini lebih intuitif dan efisien berkat beberapa peningkatan utama. Pembaruan ini dirancang untuk menyederhanakan alur kerja Anda dan memberikan insight yang lebih jelas tentang struktur UI Compose Anda.
- Scrolling Horizontal: Anda kini dapat men-scroll secara horizontal dalam hierarki komponen, sehingga memudahkan Anda menavigasi dan memeriksa tata letak yang lebar atau bertingkat dalam tanpa kehilangan konteks.
- Scrolling Otomatis saat Pemilihan: Memilih item di hierarki komponen kini akan otomatis men-scroll tampilan, baik secara horizontal maupun vertikal, untuk memfokuskan item yang dipilih dengan rapi. Hal ini memastikan elemen yang Anda minati selalu ditampilkan di posisi yang menonjol.
- Visualisasi Hubungan yang Lebih Baik: Kami telah menyempurnakan garis dukungan dalam hierarki komponen untuk menawarkan isyarat visual yang lebih jelas dalam memahami hubungan antar-node. Garis putus-putus kini menunjukkan dengan jelas hubungan stack panggilan antara induk dan node turunannya, sehingga membantu Anda melacak koneksi terprogram dengan lebih efektif. Garis solid terus merepresentasikan semua hubungan induk-turunan standar lainnya dalam struktur.
Peningkatan ini bertujuan untuk memberikan pengalaman pen-debug-an yang lebih lancar dan efisien, sehingga Anda dapat dengan cepat memahami dan menyempurnakan UI.

Menggunakan LLM lokal
Update Fitur Baru Narwhal 4 Android Studio memungkinkan Anda memilih LLM yang mendukung fitur AI IDE.

LLM harus ada di komputer lokal Anda, yang menguntungkan jika Anda memiliki konektivitas internet terbatas atau batasan terkait penggunaan model AI, atau Anda hanya ingin bereksperimen dengan model penelitian open source.
LLM lokal menawarkan alternatif untuk dukungan LLM yang ada di Android Studio. Namun, Gemini di Android Studio biasanya memberikan pengalaman pengembangan Android terbaik karena Gemini dioptimalkan untuk Android dan mendukung semua fitur Android Studio. Dengan Gemini, Anda dapat memilih dari berbagai model untuk tugas pengembangan Android Anda, termasuk model default tanpa biaya atau model yang diakses dengan kunci Gemini API berbayar.
Dukungan untuk LLM lokal memerlukan penginstalan penyedia LLM seperti LM Studio atau Ollama di komputer lokal Anda bersama dengan model yang kompatibel pilihan Anda.
Asisten Upgrade Android SDK kini mendukung Android 16 / API 36
Migrasi dari Android 15 / API 35 ke Android 16 / API 36 telah ditambahkan ke Asisten Upgrade Android SDK. Untuk mendapatkan bantuan terkait migrasi, buka Tools > Android SDK Upgrade Assistant.
Plugin Android Gradle 9.0
Plugin Android Gradle 9.0 adalah rilis utama baru AGP, dan menghadirkan perubahan API dan perilaku.
Untuk mengupdate ke plugin Android Gradle 9.0.0-alpha02, gunakan Asisten Upgrade plugin Android Gradle di Android Studio Narwhal 4 Feature Drop | 2025.1.4.
Upgrade Assistant AGP membantu mempertahankan perilaku yang ada saat mengupgrade project Anda jika sesuai, sehingga Anda dapat mengupgrade project untuk menggunakan AGP 9.0, meskipun Anda belum siap mengadopsi semua default baru di AGP 9.0.
Kompatibilitas
Level API Android maksimum yang didukung oleh plugin Android Gradle 9.0.0-alpha02 adalah level API 36.
Plugin Android Gradle 9.0.0-alpha02 memerlukan Gradle 9.0.0.
Perubahan perilaku
Plugin Android Gradle 9.0 memiliki perilaku baru berikut:
Perilaku | Rekomendasi |
---|---|
Plugin Android Gradle 9.0 menggunakan versi NDK r28c secara default.
|
Pertimbangkan untuk menentukan versi NDK yang ingin Anda gunakan secara eksplisit. |
Plugin Android Gradle 9.0 secara default mewajibkan konsumen library untuk menggunakan versi SDK kompilasi yang sama atau lebih tinggi. |
Gunakan SDK kompilasi yang sama atau lebih tinggi saat menggunakan library.
Jika hal ini tidak memungkinkan, atau Anda ingin memberi konsumen library yang Anda
publikasikan lebih banyak waktu untuk beralih, tetapkan
AarMetadata.minCompileSdk
secara eksplisit.
|
AGP 9.0 menyertakan update pada default properti Gradle berikut. Dengan demikian, Anda dapat memilih untuk mempertahankan perilaku AGP 8.13 saat mengupgrade:
Properti | Fungsi | Perubahan dari AGP 8.13 ke AGP 9.0 | Rekomendasi |
---|---|---|---|
android.uniquePackageNames |
Memastikan bahwa setiap library memiliki nama paket yang berbeda. | false → true |
Tentukan nama paket unik untuk semua library dalam project Anda. Jika tidak memungkinkan, Anda dapat menonaktifkan tanda ini saat melakukan migrasi. |
android.dependency.useConstraints |
Mengontrol penggunaan batasan dependensi antar-konfigurasi. Nilai default di AGP 9.0 adalah false yang hanya menggunakan batasan dalam pengujian perangkat aplikasi (AndroidTest).
Menyetelnya ke true akan mengembalikan perilaku ke 8.13.
|
true → false |
Jangan gunakan batasan dependensi di mana pun kecuali jika Anda membutuhkannya. Menerima default baru tanda ini juga mengaktifkan pengoptimalan dalam proses impor project yang akan mengurangi waktu impor untuk build dengan banyak subproject library Android. |
aandroid.enableAppCompileTimeRClass |
Mengompilasi kode dalam aplikasi terhadap class R non-final, sehingga
kompilasi aplikasi sejalan dengan kompilasi library. Hal ini meningkatkan inkrementalitas dan membuka jalan bagi pengoptimalan performa pada alur pemrosesan resource di masa mendatang. |
false → true |
Banyak project yang dapat mengadopsi perilaku baru tanpa perubahan sumber. Jika kolom class R digunakan di mana pun yang memerlukan konstanta, seperti kasus switch, lakukan refaktor untuk menggunakan pernyataan if berantai. |
android.sdk.defaultTargetSdkToCompileSdkIfUnset |
Menggunakan versi SDK kompilasi sebagai nilai default untuk versi SDK target di aplikasi dan pengujian. Sebelum perubahan ini, versi SDK target akan ditetapkan secara default ke versi SDK minimum. |
false → true |
Tentukan versi SDK target secara eksplisit untuk aplikasi dan pengujian. |
android.onlyEnableUnitTestForTheTestedBuildType |
Hanya membuat komponen pengujian unit untuk jenis build yang diuji. Dalam project default, hal ini menghasilkan satu pengujian unit untuk proses debug, dengan perilaku sebelumnya adalah menjalankan pengujian unit untuk proses debug atau rilis. |
false → true |
Jika project Anda tidak memerlukan pengujian untuk dijalankan untuk debug dan rilis, tidak ada perubahan yang diperlukan. |
android.proguard.failOnMissingFiles |
Menggagalkan build dengan error jika ada file keep yang ditentukan dalam DSL AGP tidak ada di disk. Sebelum perubahan ini, salah ketik dalam nama file akan menyebabkan file diabaikan tanpa pemberitahuan. | false → true |
Menghapus deklarasi file proguard yang tidak valid |
android.r8.optimizedResourceShrinking |
Memungkinkan R8 menyimpan lebih sedikit resource Android dengan mempertimbangkan class dan resource Android secara bersamaan. | false → true |
Jika aturan penyimpanan project Anda sudah selesai, tidak ada perubahan yang diperlukan. |
android.r8.strictFullModeForKeepRules |
Memungkinkan R8 menyimpan lebih sedikit dengan tidak secara implisit menyimpan konstruktor default
saat class disimpan.
Artinya, -keep class A tidak lagi menyiratkan
-keep class A { <init>(); } |
false → true |
Jika aturan penyimpanan project Anda sudah selesai, tidak ada perubahan yang diperlukan.
Ganti -keep class A
dengan
-keep class A { <init>(); }
dalam aturan penyimpanan project Anda untuk kasus apa pun yang memerlukan konstruktor
default untuk dipertahankan.
|
android.defaults.buildfeatures.shaders |
Mengaktifkan kompilasi shader di semua subproject | true → false |
Aktifkan kompilasi shader hanya di subproject yang berisi shader yang akan dikompilasi dengan menetapkan kode berikut di file build Gradle project tersebut:
android { buildFeatures { shaders = true } } |
Fitur yang dihapus
Plugin Android Gradle 9.0 menghapus fungsi berikut:
- Dukungan aplikasi Wear OS yang disematkan
AGP 9.0 menghapus dukungan untuk menyematkan aplikasi Wear OS, yang tidak lagi didukung di Play. Hal ini mencakup penghapusan konfigurasiwearApp
dan DSLAndroidSourceSet.wearAppConfigurationName
. Lihat Mendistribusikan ke Wear OS untuk mengetahui cara memublikasikan aplikasi Anda ke Wear OS.
DSL yang Diubah
Plugin Android Gradle 9.0 memiliki perubahan DSL yang dapat menyebabkan gangguan berikut:
- Parameterisasi
CommonExtension
telah dihapus. Dengan sendirinya, ini hanyalah perubahan yang merusak tingkat sumber untuk membantu menghindari perubahan yang merusak tingkat sumber di masa mendatang, tetapi juga berarti bahwa metode blok DSL perlu dipindahkan dariCommonExtension
keApplicationExtension
,LibraryExension
,DynamicFeatureExtension
, danTestExtension
.
DSL yang dihapus
Plugin Android Gradle 9.0 menghapus:
AndroidSourceSet.jni
, karena tidak berfungsi.AndroidSourceSet.wearAppConfigurationName
, karena terkait dengan dukungan aplikasi Wear OS sematan yang dihapus.BuildType.isRenderscriptDebuggable
, karena tidak berfungsi.ComponentBuilder.enabled
. Diganti denganComponentBuilder.enable
.Installation.installOptions(String)
. Digantikan oleh properti yang dapat diubah dariInstallation.installOptions
.VariantBuilder.targetSdk
dantargetSdkPreview
, karena tidak bermakna dalam library. Sebagai gantinya, gunakanGeneratesApkBuilder.targetSdk
atauGeneratesApkBuilder.targetSdkPreview
.Blok
PostProcessing
eksperimental, tetapi tidak pernah stabil.ProductFlavor.setDimension
, yang digantikan oleh propertidimension
Variant.unitTest
, karena tidak berlaku untuk plugincom.android.test
.unitTest
tersedia di subjenisVariantBuilder
yang memperluasHasUnitTest
.VariantBuilder.enableUnitTest
, karena tidak berlaku untuk plugincom.android.test
.enableUnitTest
tersedia di subjenisVariantBuilder
yang memperluasHasUnitTestBuilder
.VariantBuilder.unitTestEnabled
dihapus dan diganti denganenableUnitTest
yang namanya lebih konsisten pada subtipeVariantBuilder
yang memperluasHasUnitTestBuilder
.
Menghapus properti Gradle
Properti Gradle berikut awalnya ditambahkan sebagai cara untuk menonaktifkan fitur yang diaktifkan secara default secara global.
Fitur ini telah dinonaktifkan secara default sejak AGP 8.0 atau yang lebih rendah. Aktifkan fitur ini hanya di subproject yang menggunakannya untuk build yang lebih efisien.
Properti | Fungsi | Penggantian |
---|---|---|
android.defaults.buildfeatures.aidl |
Mengaktifkan kompilasi AIDL di semua subproject |
Aktifkan kompilasi AIDL hanya di subproject yang memiliki
sumber AIDL
dengan menyetel properti berikut dalam file build Gradle project tersebut:
android { buildFeatures { aidl = true } } |
android.defaults.buildfeatures.renderscript |
Mengaktifkan kompilasi RenderScript di semua subproject |
Aktifkan kompilasi renderscript hanya di subproject yang memiliki sumber renderscript dengan menetapkan properti berikut di file build Gradle project tersebut:
android { buildFeatures { renderScript = true } } |
API yang Dihapus
Plugin Android Gradle 9.0 menghapus:
- API
BaseExtension.registerTransform
yang tidak digunakan lagi dan dinonaktifkan, yang hanya tetap ada untuk memungkinkan kompilasi terhadap versi AGP terbaru saat menargetkan agar berjalan di AGP 4.2 atau yang lebih rendah.
Properti Gradle yang diterapkan
AGP 9.0 akan menampilkan error jika Anda menetapkan properti Gradle berikut.
Upgrade Assistant plugin Android Gradle tidak akan mengupgrade project ke AGP 9.0 yang menggunakan properti ini.
Properti | Fungsi |
---|---|
android.r8.integratedResourceShrinking |
Pengecilan resource kini selalu dijalankan sebagai bagian dari R8, implementasi sebelumnya telah dihapus. |