Perubahan perilaku: Aplikasi yang menargetkan Android 16 atau yang lebih tinggi

Seperti rilis sebelumnya, Android 16 menyertakan perubahan perilaku yang dapat memengaruhi aplikasi Anda. Perubahan perilaku berikut ini berlaku khusus bagi aplikasi yang menargetkan Android 16 atau yang lebih tinggi. Jika aplikasi menargetkan Android 16 atau yang lebih tinggi, Anda harus memodifikasi aplikasi untuk mendukung perilaku ini, jika berlaku.

Pastikan Anda meninjau daftar perubahan perilaku yang memengaruhi semua aplikasi yang berjalan di Android 16, terlepas dari targetSdkVersion aplikasi Anda.

Pengalaman pengguna dan UI sistem

Android 16 (API level 36) menyertakan perubahan berikut yang dimaksudkan untuk menciptakan pengalaman pengguna yang lebih konsisten dan intuitif.

Opsi tidak ikut layar penuh akan dihapus

Android 15 menerapkan tampilan penuh untuk aplikasi yang menargetkan Android 15 (level API 35), tetapi aplikasi Anda dapat memilih tidak ikut dengan menetapkan R.attr#windowOptOutEdgeToEdgeEnforcement ke true. Untuk aplikasi yang menargetkan Android 16 (API level 36), R.attr#windowOptOutEdgeToEdgeEnforcement tidak digunakan lagi dan dinonaktifkan, dan aplikasi Anda tidak dapat memilih untuk tidak menggunakan layar penuh.

  • Jika aplikasi Anda menargetkan Android 16 (API level 36) dan berjalan di perangkat Android 15, R.attr#windowOptOutEdgeToEdgeEnforcement akan terus berfungsi.
  • Jika aplikasi Anda menargetkan Android 16 (API level 36) dan berjalan di perangkat Android 16, R.attr#windowOptOutEdgeToEdgeEnforcement akan dinonaktifkan.

Untuk pengujian di Android 16 Beta 3, pastikan aplikasi Anda mendukung layar penuh dan hapus penggunaan R.attr#windowOptOutEdgeToEdgeEnforcement sehingga aplikasi Anda juga mendukung layar penuh di perangkat Android 15. Untuk mendukung tampilan dari tepi ke tepi, lihat panduan Compose dan View.

Migrasi atau pilihan tidak ikut diperlukan untuk kembali prediktif

Untuk aplikasi yang menargetkan Android 16 (API level 36) atau yang lebih tinggi dan berjalan di perangkat Android 16 atau yang lebih tinggi, animasi sistem kembali prediktif (kembali ke layar utama, lintas tugas, dan lintas aktivitas) diaktifkan secara default. Selain itu, onBackPressed tidak dipanggil dan KeyEvent.KEYCODE_BACK tidak dikirim lagi.

Jika aplikasi Anda menangkap peristiwa kembali dan Anda belum bermigrasi ke kembali prediktif, update aplikasi Anda untuk menggunakan API navigasi kembali yang didukung. Atau, pilih untuk tidak ikut sementara dengan menetapkan atribut android:enableOnBackInvokedCallback ke false di tag <application> atau <activity> dari file AndroidManifest.xml aplikasi Anda.

Animasi kembali ke layar utama prediktif.
Animasi lintas aktivitas prediktif.
Animasi lintas tugas prediktif.

API font elegan tidak digunakan lagi dan dinonaktifkan

Aplikasi yang menargetkan Android 15 (API level 35) memiliki atribut elegantTextHeight TextView yang ditetapkan ke true secara default, yang mengganti font ringkas dengan font yang jauh lebih mudah dibaca. Anda dapat menggantinya dengan menetapkan atribut elegantTextHeight ke false.

Android 16 tidak lagi menggunakan atribut elegantTextHeight, dan atribut akan diabaikan setelah aplikasi Anda menargetkan Android 16. "Font UI" yang dikontrol oleh API ini tidak digunakan lagi, jadi Anda harus menyesuaikan tata letak untuk memastikan rendering teks yang konsisten dan tahan lama dalam bahasa Arab, Lao, Myanmar, Tamil, Gujarati, Kannada, Malayalam, Odia, Telugu, atau Thai.

Perilaku
elegantTextHeight untuk aplikasi yang menargetkan Android 14 (API level 34) dan yang lebih lama, atau untuk aplikasi yang menargetkan Android 15 (API level 35) yang mengganti default dengan menetapkan atribut elegantTextHeight ke false.
Perilaku
elegantTextHeight untuk aplikasi yang menargetkan Android 16, atau untuk aplikasi yang menargetkan Android 15 (API level 35) yang tidak mengganti setelan default dengan menetapkan atribut elegantTextHeight ke false.

Fungsi inti

Android 16 (API level 36) menyertakan perubahan berikut yang mengubah atau memperluas berbagai kemampuan inti sistem Android.

Pengoptimalan penjadwalan pekerjaan dengan tarif tetap

Sebelum menargetkan Android 16, saat scheduleAtFixedRate melewatkan eksekusi tugas karena berada di luar siklus proses yang valid, semua eksekusi yang terlewat akan segera dijalankan saat aplikasi kembali ke siklus proses yang valid.

Saat menargetkan Android 16, maksimal satu eksekusi yang terlewat dari scheduleAtFixedRate akan langsung dieksekusi saat aplikasi kembali ke siklus proses yang valid. Perubahan perilaku ini diharapkan dapat meningkatkan performa aplikasi. Uji perilaku ini di aplikasi Anda untuk memeriksa apakah aplikasi Anda terpengaruh. Anda juga dapat menguji dengan menggunakan framework kompatibilitas aplikasi dan mengaktifkan flag kompatibilitas STPE_SKIP_MULTIPLE_MISSED_PERIODIC_TASKS.

Faktor bentuk perangkat

Android 16 (API level 36) menyertakan perubahan berikut untuk aplikasi saat ditampilkan di perangkat layar besar.

Tata letak adaptif

Dengan aplikasi Android yang kini berjalan di berbagai perangkat (seperti ponsel, tablet, perangkat foldable, desktop, mobil, dan TV) dan mode jendela di layar besar (seperti layar terpisah dan jendela desktop), developer harus mem-build aplikasi Android yang beradaptasi dengan ukuran layar dan jendela apa pun, terlepas dari orientasi perangkat. Paradigma seperti membatasi orientasi dan kemampuan untuk diubah ukurannya terlalu membatasi di dunia multiperangkat saat ini.

Mengabaikan batasan orientasi, kemampuan mengubah ukuran, dan rasio aspek

Untuk aplikasi yang menargetkan Android 16 (API level 36), Android 16 menyertakan perubahan pada cara sistem mengelola orientasi, kemampuan untuk diubah ukurannya, dan batasan rasio lebar tinggi. Pada layar dengan lebar terkecil >= 600 dp, pembatasan tidak lagi berlaku. Aplikasi juga mengisi seluruh jendela tampilan, terlepas dari rasio aspek atau orientasi pilihan pengguna, dan pillarboxing tidak digunakan.

Perubahan ini memperkenalkan perilaku platform standar baru. Android beralih ke model yang diharapkan dapat beradaptasi dengan berbagai orientasi, ukuran layar, dan rasio aspek. Batasan seperti orientasi tetap atau kemampuan pengubahan ukuran yang terbatas akan menghambat kemampuan adaptasi aplikasi, jadi sebaiknya buat aplikasi Anda adaptif untuk memberikan pengalaman pengguna terbaik.

Anda juga dapat menguji perilaku ini menggunakan framework kompatibilitas aplikasi dan mengaktifkan tanda kompatibilitas UNIVERSAL_RESIZABLE_BY_DEFAULT.

Perubahan yang dapat menyebabkan gangguan umum

Mengabaikan batasan orientasi, kemampuan untuk diubah ukurannya, dan rasio aspek dapat memengaruhi UI aplikasi Anda di beberapa perangkat, terutama elemen yang dirancang untuk tata letak kecil yang terkunci dalam orientasi potret: misalnya, masalah seperti tata letak yang diregangkan serta animasi dan komponen di luar layar. Setiap asumsi tentang rasio aspek atau orientasi dapat menyebabkan masalah visual pada aplikasi Anda. Pelajari lebih lanjut cara menghindarinya dan meningkatkan perilaku adaptif aplikasi Anda.

Mengizinkan rotasi perangkat akan menghasilkan lebih banyak pembuatan ulang aktivitas, yang dapat menyebabkan hilangnya status pengguna jika tidak dipertahankan dengan benar. Pelajari cara menyimpan status UI dengan benar di Menyimpan status UI.

Detail implementasi

Atribut manifes dan API runtime berikut diabaikan di seluruh perangkat layar besar dalam mode layar penuh dan multi-aplikasi:

Nilai berikut untuk screenOrientation, setRequestedOrientation(), dan getRequestedOrientation() diabaikan:

  • portrait
  • reversePortrait
  • sensorPortrait
  • userPortrait
  • landscape
  • reverseLandscape
  • sensorLandscape
  • userLandscape

Terkait kemampuan mengubah ukuran layar, android:resizeableActivity="false", android:minAspectRatio, dan android:maxAspectRatio tidak memiliki efek.

Untuk aplikasi yang menargetkan Android 16 (API level 36), batasan orientasi, perubahan ukuran, dan rasio aspek aplikasi diabaikan di layar besar secara default, tetapi setiap aplikasi yang belum sepenuhnya siap dapat mengganti perilaku ini untuk sementara dengan memilih tidak ikut (yang menyebabkan perilaku sebelumnya ditempatkan dalam mode kompatibilitas).

Pengecualian

Batasan orientasi, perubahan ukuran, dan rasio aspek Android 16 tidak berlaku dalam situasi berikut:

  • Game (berdasarkan flag android:appCategory)
  • Pengguna secara eksplisit memilih untuk menggunakan perilaku default aplikasi di setelan rasio aspek perangkat
  • Layar yang lebih kecil dari sw600dp

Memilih tidak ikut sementara

Untuk memilih tidak ikut aktivitas tertentu, deklarasikan properti manifes PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY:

<activity ...>
  <property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY" android:value="true" />
  ...
</activity>

Jika terlalu banyak bagian aplikasi Anda yang belum siap untuk Android 16, Anda dapat memilih untuk tidak ikut sepenuhnya dengan menerapkan properti yang sama di tingkat aplikasi:

<application ...>
  <property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY" android:value="true" />
</application>

Kesehatan dan kebugaran

Android 16 (API level 36) menyertakan perubahan berikut yang terkait dengan data kesehatan dan kebugaran.

Izin kesehatan dan kebugaran

Untuk aplikasi yang menargetkan Android 16 (API level 36) atau yang lebih tinggi, izin BODY_SENSORS akan bertransisi ke izin terperinci di bagian android.permissions.health yang juga digunakan oleh Health Connect. Setiap API yang sebelumnya memerlukan BODY_SENSORS atau BODY_SENSORS_BACKGROUND kini memerlukan izin android.permissions.health yang sesuai. Hal ini memengaruhi jenis data, API, dan jenis layanan latar depan berikut:

Jika aplikasi Anda menggunakan API ini, aplikasi tersebut kini harus meminta izin terperinci masing-masing:

Izin ini sama dengan izin yang menjaga akses untuk membaca data dari Health Connect, datastore Android untuk data kesehatan, kebugaran, dan kesehatan.

Aplikasi seluler

Aplikasi seluler yang bermigrasi untuk menggunakan READ_HEART_RATE dan izin terperinci lainnya juga harus mendeklarasikan aktivitas untuk menampilkan kebijakan privasi aplikasi. Persyaratan ini sama dengan Health Connect.

Konektivitas

Android 16 (level API 36) menyertakan perubahan berikut dalam stack Bluetooth untuk meningkatkan konektivitas dengan perangkat periferal.

Intent baru untuk menangani perubahan enkripsi dan hilangnya obligasi

Sebagai bagian dari Peningkatan penanganan kehilangan ikatan, Android 16 juga memperkenalkan 2 intent baru untuk memberi aplikasi kesadaran yang lebih besar tentang kehilangan ikatan dan perubahan enkripsi.

Aplikasi yang menargetkan Android 16 kini dapat:

  • Menerima intent ACTION_KEY_MISSING saat hilangnya ikatan jarak jauh terdeteksi, sehingga memungkinkannya memberikan masukan pengguna yang lebih informatif dan mengambil tindakan yang sesuai.
  • Menerima intent ACTION_ENCRYPTION_CHANGE setiap kali status enkripsi link berubah. Hal ini mencakup perubahan status enkripsi, perubahan algoritma enkripsi, dan perubahan ukuran kunci enkripsi. Aplikasi harus mempertimbangkan pengikatan yang dipulihkan jika link berhasil dienkripsi setelah menerima intent ACTION_ENCRYPTION_CHANGE nanti.

Jika aplikasi Anda saat ini menggunakan mekanisme kustom untuk penanganan kehilangan ikatan, bermigrasilah ke intent baru ACTION_KEY_MISSING untuk mendeteksi dan mengelola peristiwa kehilangan ikatan. Sebaiknya aplikasi Anda memandu pengguna untuk mengonfirmasi bahwa perangkat jarak jauh berada dalam jangkauan sebelum memulai penghapusan perangkat dan penyambungan ulang.

Selain itu, jika perangkat terputus setelah intent ACTION_KEY_MISSING diterima, aplikasi Anda harus berhati-hati saat terhubung kembali ke perangkat karena perangkat tersebut mungkin tidak lagi terikat dengan sistem.

Keamanan

Android 16 (API level 36) menyertakan perubahan keamanan berikut.

Penguncian versi MediaStore

Untuk aplikasi yang menargetkan Android 16 atau yang lebih tinggi, MediaStore#getVersion() kini akan unik untuk setiap aplikasi. Hal ini menghilangkan properti identifikasi dari string versi untuk mencegah penyalahgunaan dan penggunaan untuk teknik sidik jari. Aplikasi tidak boleh membuat asumsi apa pun terkait format versi ini. Aplikasi seharusnya sudah menangani perubahan versi saat menggunakan API ini dan dalam sebagian besar kasus tidak perlu mengubah perilakunya saat ini, kecuali jika developer telah mencoba menyimpulkan informasi tambahan yang berada di luar cakupan API ini yang dimaksudkan.

Privasi

Android 16 (API level 36) menyertakan perubahan privasi berikut.

Izin Jaringan Lokal

Perangkat di LAN dapat diakses oleh aplikasi apa pun yang memiliki izin INTERNET. Hal ini memudahkan aplikasi untuk terhubung ke perangkat lokal, tetapi juga memiliki implikasi privasi seperti membentuk sidik jari pengguna, dan menjadi proxy untuk lokasi.

Project Perlindungan Jaringan Lokal bertujuan untuk melindungi privasi pengguna dengan mengontrol akses ke jaringan lokal di balik izin runtime baru.

Rencana rilis

Perubahan ini akan di-deploy antara dua rilis, yaitu 25Q2 dan TBD. Developer harus mengikuti panduan ini untuk 25Q2 dan memberikan masukan karena perlindungan ini akan diterapkan pada rilis Android berikutnya. Selain itu, mereka harus memperbarui skenario yang bergantung pada akses jaringan lokal implisit dengan menggunakan panduan berikut dan bersiap untuk penolakan pengguna dan pencabutan izin baru.

Dampak

Pada tahap saat ini, LNP adalah fitur keikutsertaan yang berarti hanya aplikasi yang memilih ikut serta yang akan terpengaruh. Tujuan fase keikutsertaan adalah agar developer aplikasi memahami bagian aplikasi mana yang bergantung pada akses jaringan lokal implisit sehingga mereka dapat bersiap untuk melindunginya dengan izin untuk rilis berikutnya.

Aplikasi akan terpengaruh jika mengakses jaringan lokal pengguna menggunakan:

  • Penggunaan langsung atau library soket mentah pada alamat jaringan lokal (misalnya, protokol penemuan layanan mDNS atau SSDP)
  • Penggunaan class tingkat framework yang mengakses jaringan lokal (misalnya, NsdManager)

Traffic ke dan dari alamat jaringan lokal memerlukan izin akses jaringan lokal. Tabel berikut mencantumkan beberapa kasus umum:

Operasi Jaringan Tingkat Rendah Aplikasi Izin Jaringan Lokal Diperlukan
Membuat koneksi TCP keluar ya
Menerima koneksi TCP masuk ya
Mengirim unicast, multicast, siaran UDP ya
Menerima unicast, multicast, siaran UDP yang masuk ya

Pembatasan ini diterapkan jauh di dalam stack jaringan, sehingga berlaku untuk semua API jaringan. Hal ini mencakup soket yang dibuat dalam kode native atau terkelola, library jaringan seperti Cronet dan OkHttp, dan API apa pun yang diterapkan di atasnya. Mencoba me-resolve layanan di jaringan lokal (yaitu layanan dengan akhiran .local) akan memerlukan izin jaringan lokal.

Pengecualian untuk aturan di atas:

  • Jika server DNS perangkat berada di jaringan lokal, traffic ke atau dari server tersebut (di port 53) tidak memerlukan izin akses jaringan lokal.
  • Aplikasi yang menggunakan Output Switcher sebagai pemilih dalam aplikasi tidak akan memerlukan izin jaringan lokal (panduan selengkapnya akan hadir pada Kuartal 4 2025).

Panduan Developer (Keikutsertaan)

Untuk memilih ikut serta dalam pembatasan jaringan lokal, lakukan langkah berikut:

  1. Flash perangkat ke build dengan 25Q2 Beta 3 atau yang lebih baru.
  2. Instal aplikasi yang akan diuji.

  3. Alihkan flag Appcompat di adb:

    adb shell am compat enable RESTRICT_LOCAL_NETWORK <package_name>

  4. Memulai ulang perangkat

Sekarang akses aplikasi Anda ke jaringan lokal dibatasi dan setiap upaya untuk mengakses jaringan lokal akan menyebabkan error soket. Jika Anda menggunakan API yang melakukan operasi jaringan lokal di luar proses aplikasi (misalnya: NsdManager), API tersebut tidak akan terpengaruh selama fase keikutsertaan.

Untuk memulihkan akses, Anda harus memberikan izin aplikasi ke NEARBY_WIFI_DEVICES.

  1. Pastikan aplikasi mendeklarasikan izin NEARBY_WIFI_DEVICES dalam manifesnya.
  2. Buka Setelan > Aplikasi > [Nama Aplikasi] > Izin > Perangkat di sekitar > Izinkan.

Sekarang, akses aplikasi Anda ke jaringan lokal akan dipulihkan dan semua skenario akan berfungsi seperti sebelum mengaktifkan aplikasi.

Setelah penerapan perlindungan jaringan lokal dimulai, berikut adalah dampak traffic jaringan aplikasi.

Izin Permintaan LAN Keluar Permintaan Internet Keluar/Masuk Permintaan LAN Masuk
Diberikan Works Works Works
Tidak Diberikan Gagal Works Gagal

Gunakan perintah berikut untuk menonaktifkan flag App-Compat

adb shell am compat disable RESTRICT_LOCAL_NETWORK <package_name>

Error

Error yang timbul dari batasan ini akan ditampilkan ke soket panggilan setiap kali memanggil send atau varian send ke alamat jaringan lokal.

Contoh error:

sendto failed: EPERM (Operation not permitted)

sendto failed: ECONNABORTED (Operation not permitted)

Definisi Jaringan Lokal

Jaringan lokal dalam project ini mengacu pada jaringan IP yang menggunakan antarmuka jaringan yang mampu melakukan siaran, seperti Wi-Fi atau Ethernet, tetapi tidak mencakup koneksi seluler (WWAN) atau VPN.

Berikut ini dianggap sebagai jaringan lokal:

IPv4:

  • 169.254.0.0/16 // Link Lokal
  • 100.64.0.0/10 // CGNAT
  • 10.0.0.0/8 // RFC1918
  • 172.16.0.0/12 // RFC1918
  • 192.168.0.0/16 // RFC1918

IPv6:

  • Link-local
  • Rute yang terhubung langsung
  • Jaringan stub seperti Thread
  • Beberapa subnet (TBD)

Selain itu, alamat multicast (224.0.0.0/4, ff00::/8) dan alamat siaran IPv4 (255.255.255.255) diklasifikasikan sebagai alamat jaringan lokal.