Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

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

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

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

Pengalaman pengguna dan UI sistem

Android 17 menyertakan perubahan berikut yang dimaksudkan untuk menciptakan pengalaman pengguna yang lebih konsisten dan intuitif.

Mulai Android 17, untuk aplikasi yang menargetkan Android 17 (level API 37) atau yang lebih tinggi, sistem menerapkan batas memori yang ketat (1,5 * lebar layar * tinggi layar * 4) terhadap penggunaan memori gabungan Bitmap dan Ikon yang ada dalam paket RemoteViews. Jika batas ini terlampaui, IllegalArgumentException fatal akan muncul dan proses aplikasi akan error.

Untuk mengetahui informasi selengkapnya, lihat UpdateAppWidget.

Fungsi inti

Android 17 menyertakan perubahan berikut yang mengubah atau memperluas berbagai kemampuan inti sistem Android.

Implementasi MessageQueue baru yang bebas kunci

Mulai Android 17, aplikasi yang menargetkan Android 17 (level API 37) atau yang lebih tinggi akan menerima implementasi android.os.MessageQueue baru yang bebas kunci. Implementasi baru ini meningkatkan performa dan mengurangi frame yang terlewat, tetapi dapat merusak klien yang merefleksikan kolom dan metode pribadi MessageQueue.

Untuk mengetahui informasi selengkapnya, termasuk strategi mitigasi, lihat Panduan perubahan perilaku MessageQueue.

Kolom final statis kini tidak dapat diubah

Aplikasi yang berjalan di Android 17 atau yang lebih tinggi yang menargetkan Android 17 (level API 37) atau yang lebih tinggi tidak dapat mengubah kolom static final. Jika aplikasi mencoba mengubah kolom static final menggunakan refleksi, hal ini akan menyebabkan IllegalAccessException. Mencoba mengubah salah satu kolom ini melalui JNI API (seperti SetStaticLongField()) akan menyebabkan aplikasi error.

Aksesibilitas

Android 17 melakukan perubahan berikut untuk meningkatkan aksesibilitas.

Fitur ini memperkenalkan API AccessibilityEvent dan TextAttribute baru untuk meningkatkan respons lisan pembaca layar untuk input bahasa CJKV. Aplikasi IME CJKV kini dapat memberi sinyal apakah kandidat konversi teks telah dipilih selama komposisi teks. Aplikasi dengan kolom edit dapat menentukan jenis perubahan teks saat mengirim peristiwa aksesibilitas teks yang diubah. Misalnya, aplikasi dapat menentukan bahwa perubahan teks terjadi selama komposisi teks, atau bahwa perubahan teks dihasilkan dari commit. Tindakan ini memungkinkan layanan aksesibilitas seperti pembaca layar memberikan masukan yang lebih akurat berdasarkan sifat modifikasi teks.

Adopsi aplikasi

Aplikasi IME: Saat menyetel teks penulisan di kolom edit, IME dapat menggunakan TextAttribute.Builder.setTextSuggestionSelected() untuk menunjukkan apakah kandidat konversi tertentu dipilih.
Aplikasi dengan Kolom Edit: Aplikasi yang mengelola InputConnection kustom dapat mengambil data pilihan kandidat dengan memanggil TextAttribute.isTextSuggestionSelected(). Aplikasi ini kemudian harus memanggil AccessibilityEvent.setTextChangeTypes() saat mengirim peristiwa TYPE_VIEW_TEXT_CHANGED. Aplikasi yang menargetkan Android 17 (API level 37) yang menggunakan TextView standar akan mengaktifkan fitur ini secara default. (Artinya, TextView akan menangani pengambilan data dari IME dan menyetel jenis perubahan teks saat mengirim peristiwa ke layanan aksesibilitas).
Layanan Aksesibilitas: Layanan aksesibilitas yang memproses peristiwa TYPE_VIEW_TEXT_CHANGED dapat memanggil AccessibilityEvent.getTextChangeTypes() untuk mengidentifikasi sifat modifikasi dan menyesuaikan strategi masukan mereka.

Privasi

Android 17 menyertakan perubahan berikut untuk meningkatkan privasi pengguna.

ECH (Encrypted Client Hello) diaktifkan

Android 17 memperkenalkan dukungan platform untuk Encrypted Client Hello (ECH), ekstensi TLS yang meningkatkan privasi pengguna dengan mengenkripsi Server Name Indication (SNI) dalam TLS handshake. Enkripsi ini membantu mencegah pengamat jaringan mengidentifikasi dengan mudah domain tertentu yang terhubung dengan aplikasi Anda.

Untuk aplikasi yang menargetkan Android 17 (level API 37) atau yang lebih tinggi, ECH digunakan untuk koneksi TLS. ECH hanya aktif jika library jaringan yang digunakan oleh aplikasi (misalnya, HttpEngine, WebView, atau OkHttp) telah mengintegrasikan dukungan ECH dan server jarak jauh juga mendukung protokol ECH. Jika ECH tidak dapat dinegosiasikan, klien akan mengirim ekstensi ECH dengan konten acak (mekanisme yang disebut ECH GREASE). Lihat RFC 9849 untuk mengetahui detail selengkapnya tentang cara kerja ECH GREASE.

Untuk memungkinkan aplikasi menyesuaikan perilaku ini, Android 17 menambahkan elemen <domainEncryption> baru ke file Konfigurasi Keamanan Jaringan. Developer dapat menggunakan <domainEncryption> dalam tag <base-config> atau <domain-config> untuk memilih mode ECH (misalnya, "enabled" atau "disabled") secara global atau per domain.

Untuk mengetahui informasi selengkapnya, lihat dokumentasi Encrypted Client Hello.

Izin jaringan lokal diperlukan untuk aplikasi yang menargetkan Android 17

Android 17 memperkenalkan izin runtime ACCESS_LOCAL_NETWORK untuk melindungi pengguna dari akses jaringan lokal yang tidak sah. Karena ini termasuk dalam grup izin NEARBY_DEVICES yang ada, pengguna yang telah memberikan izin NEARBY_DEVICES lainnya tidak akan diminta lagi. Persyaratan baru ini mencegah aplikasi berbahaya mengeksploitasi akses jaringan lokal tanpa batas untuk pelacakan dan pembuatan sidik jari pengguna secara terselubung. Dengan mendeklarasikan dan meminta izin ini, aplikasi Anda dapat menemukan dan terhubung ke perangkat di jaringan area lokal (LAN), seperti perangkat smart home atau penerima transmisi.

Aplikasi yang menargetkan Android 17 (level API 37) atau yang lebih tinggi kini memiliki dua jalur untuk mempertahankan komunikasi dengan perangkat LAN: Mengadopsi pemilih perangkat yang dimediasi sistem dan menjaga privasi untuk melewati dialog izin, atau secara eksplisit meminta izin baru ini saat runtime untuk mempertahankan komunikasi jaringan lokal.

Untuk mengetahui informasi selengkapnya, lihat dokumentasi Izin jaringan lokal.

Menyembunyikan sandi dari perangkat fisik

If an app targets Android 17 (API level 37) or higher and the user is using a physical input device (for example, an external keyboard), the Android operating system applies the new show_passwords_physical setting to all characters in the password field. By default, that setting hides all password characters.

The Android system shows the last-typed password character to help the user see if they mistyped the password. However, this is much less necessary with larger external keyboards. In addition, devices with external keyboards often have larger displays, which increases the danger of someone seeing the typed password.

If the user is using the device's touchscreen, the system applies the new show_passwords_touch setting.

Perlindungan OTP untuk pesan SMS standar

Mulai Android 17, Android memperluas perlindungan OTP SMS-nya untuk diterapkan ke pesan SMS standar (pesan SMS yang berisi OTP yang tidak menggunakan format WebOTP atau SMS Retriever). Untuk sebagian besar aplikasi yang menargetkan Android 17 (level API 37) atau yang lebih tinggi, pesan SMS ini tidak akan tersedia hingga tiga jam setelah diterima. Penundaan ini dimaksudkan untuk membantu mencegah pembajakan OTP. Selama penundaan tiga jam ini, siaran SMS_RECEIVED_ACTION ditahan dan kueri database penyedia SMS difilter. Pesan SMS tersedia untuk aplikasi ini setelah penundaan.

Aplikasi tertentu seperti aplikasi bantuan SMS default, aplikasi pendamping perangkat terhubung, dll., dikecualikan dari penundaan ini. Semua aplikasi yang mengandalkan pembacaan pesan SMS untuk ekstraksi OTP harus beralih menggunakan API SMS Retriever atau SMS Izin Pengguna untuk memastikan fungsi yang berkelanjutan.

Keamanan

Android 17 melakukan peningkatan berikut pada keamanan perangkat dan aplikasi.

Keamanan Aktivitas

Di Android 17, platform ini melanjutkan peralihannya ke arsitektur "aman secara default", dengan memperkenalkan serangkaian peningkatan yang dirancang untuk memitigasi eksploitasi tingkat keparahan tinggi seperti phishing, pembajakan interaksi, dan serangan confused deputy. Update ini mengharuskan developer untuk secara eksplisit memilih ikut serta dalam standar keamanan baru guna mempertahankan kompatibilitas aplikasi dan perlindungan pengguna.

Dampak utama bagi developer meliputi:

Penguatan BAL & peningkatan keikutsertaan: Kami menyempurnakan batasan Peluncuran Aktivitas Latar Belakang (BAL) dengan memperluas perlindungan ke IntentSender. Developer harus bermigrasi dari konstanta MODE_BACKGROUND_ACTIVITY_START_ALLOWED lama. Sebagai gantinya, Anda harus menggunakan kontrol terperinci seperti MODE_BACKGROUND_ACTIVITY_START_ALLOW_IF_VISIBLE, yang membatasi mulainya aktivitas ke skenario saat aplikasi panggilan terlihat, sehingga mengurangi permukaan serangan secara signifikan.
Alat adopsi: Developer harus menggunakan mode ketat dan pemeriksaan lint yang diperbarui untuk mengidentifikasi pola lama dan memastikan kesiapan untuk persyaratan SDK target pada masa mendatang.

Mengaktifkan CT secara default

Jika aplikasi menargetkan Android 17 (API level 37) atau yang lebih tinggi, transparansi sertifikat (CT) diaktifkan secara default. (Di Android 16, CT tersedia, tetapi aplikasi harus mengaktifkannya.)

DCL Native yang Lebih Aman—C

Jika aplikasi Anda menargetkan Android 17 (level API 37) atau yang lebih tinggi, perlindungan Pemuatan Kode Dinamis (DCL) yang Lebih Aman yang diperkenalkan di Android 14 untuk file DEX dan JAR kini diperluas ke library native.

Semua file native yang dimuat menggunakan System.load() harus ditandai sebagai hanya baca. Jika tidak, sistem akan menampilkan UnsatisfiedLinkError.

Sebaiknya aplikasi menghindari pemuatan kode secara dinamis jika memungkinkan, karena hal itu akan sangat meningkatkan risiko aplikasi disusupi oleh injeksi kode atau modifikasi kode.

Membatasi kolom PII dalam tampilan data CP2

Untuk aplikasi yang menargetkan Android 17 (level API 37) dan yang lebih tinggi, Penyedia Kontak 2 (CP2) membatasi kolom tertentu yang berisi Informasi Identitas Pribadi (PII) dari tampilan data. Jika perubahan ini diaktifkan, kolom ini akan dihapus dari tampilan data untuk meningkatkan privasi pengguna. Kolom yang dibatasi mencakup:

Aplikasi yang menggunakan kolom ini dari ContactsContract.Data dapat mengekstraknya dari ContactsContract.RawContacts dengan menggabungkannya dengan RAW_CONTACT_ID.

Menerapkan pemeriksaan SQL yang ketat di CP2

Untuk aplikasi yang menargetkan Android 17 (level API 37) dan yang lebih tinggi, Penyedia Kontak 2 (CP2) menerapkan validasi kueri SQL yang ketat saat tabel ContactsContract.Data diakses tanpa izin READ_CONTACTS.

Dengan perubahan ini, jika aplikasi tidak memiliki izin READ_CONTACTS, opsi StrictColumns dan StrictGrammar akan ditetapkan saat membuat kueri tabel ContactsContract.Data. Jika kueri menggunakan pola yang tidak kompatibel dengan pola ini, kueri tersebut akan ditolak dan menyebabkan pengecualian ditampilkan.

Kecerdasan

Android 17 menyertakan perubahan berikut pada kecerdasan sistem.

Penghentian penggunaan setContentCaptureEnabled

Content Capture diaktifkan secara default di perangkat tertentu untuk memungkinkan fitur AI di perangkat menganalisis konten layar untuk memberikan pengalaman cerdas.

Mulai Android 17, metode API ContentCaptureManager.setContentCaptureEnabled(boolean) tidak digunakan lagi. Untuk aplikasi yang menargetkan Android 17 (API level 37) atau yang lebih tinggi, memanggil setContentCaptureEnabled(false) tidak lagi menonaktifkan Content Capture.

Jika aplikasi Anda perlu terus menonaktifkan Content Capture atau membatasi konten layar agar tidak diambil oleh sistem, Anda harus beralih menggunakan parameter tata letak jendela FLAG_SECURE.

Untuk menonaktifkan Content Capture, tetapkan flag FLAG_SECURE di jendela Anda seperti yang ditunjukkan dalam contoh berikut:

Kotlin

window.setFlags(
    WindowManager.LayoutParams.FLAG_SECURE,
    WindowManager.LayoutParams.FLAG_SECURE
)

Java

getWindow().setFlags(
    WindowManager.LayoutParams.FLAG_SECURE,
    WindowManager.LayoutParams.FLAG_SECURE
);

Untuk mengetahui detail selengkapnya, lihat dokumentasi referensi WindowManager.LayoutParams.FLAG_SECURE.

Media

Android 17 menyertakan perubahan berikut pada perilaku media.

Penguatan audio latar belakang

Mulai Android 17, framework audio menerapkan batasan pada interaksi audio latar belakang, termasuk pemutaran audio, permintaan fokus audio, dan API perubahan volume untuk memastikan bahwa perubahan ini dimulai secara sengaja oleh pengguna.

Beberapa batasan audio berlaku untuk semua aplikasi. Namun, pembatasan akan lebih ketat jika aplikasi menargetkan Android 17 (level API 37). Jika salah satu aplikasi ini berinteraksi dengan audio saat berada di latar belakang, aplikasi tersebut harus memiliki layanan latar depan yang berjalan. Selain itu, aplikasi harus memenuhi salah satu atau kedua persyaratan berikut:

Layanan latar depan harus memiliki kemampuan saat digunakan (WIU).
Aplikasi harus memiliki izin alarm presisi dan berinteraksi dengan streaming audio USAGE_ALARM.

Untuk mengetahui informasi selengkapnya, termasuk strategi mitigasi, lihat Penguatan audio latar belakang.

Faktor bentuk perangkat

Android 17 menyertakan perubahan berikut untuk meningkatkan pengalaman pengguna di berbagai ukuran dan faktor bentuk perangkat.

Perubahan API platform untuk mengabaikan batasan orientasi, perubahan ukuran, dan rasio aspek di perangkat layar besar (sw>=600 dp)

Kami memperkenalkan perubahan API Platform di Android 16 untuk mengabaikan batasan orientasi, perubahan ukuran, dan rasio aspek di perangkat layar besar (sw >= 600 dp) bagi aplikasi yang menargetkan API level 36 atau yang lebih tinggi. Developer memiliki opsi untuk memilih tidak ikut perubahan ini dengan SDK 36, tetapi opsi tidak ikut ini tidak akan tersedia lagi untuk aplikasi yang menargetkan Android 17 (API level 37) atau yang lebih tinggi.

Untuk mengetahui informasi selengkapnya, lihat Pembatasan orientasi dan kemampuan pengubahan ukuran diabaikan.

Konektivitas

Android 17 memperkenalkan perubahan berikut untuk meningkatkan konsistensi dan menyelaraskan dengan perilaku InputStream Java standar untuk soket RFCOMM Bluetooth.

Perilaku read() BluetoothSocket yang konsisten untuk RFCOMM

Untuk aplikasi yang menarget Android 17 (API level 37), metode read() dari InputStream yang diperoleh dari BluetoothSocket berbasis RFCOMM kini menampilkan -1 saat soket ditutup atau koneksi terputus.

Perubahan ini membuat perilaku soket RFCOMM konsisten dengan soket LE CoC dan selaras dengan dokumentasi InputStream.read() standar, yang menyatakan bahwa -1 ditampilkan saat akhir aliran tercapai.

Aplikasi yang hanya mengandalkan penangkapan IOException untuk keluar dari loop baca mungkin terpengaruh oleh perubahan ini dan harus mengupdate loop baca BluetoothSocket untuk secara eksplisit memeriksa nilai yang ditampilkan -1. Hal ini memastikan loop berakhir dengan benar saat perangkat jarak jauh terputus atau soket ditutup. Untuk contoh penerapan yang direkomendasikan, lihat cuplikan kode dalam panduan Mentransfer data Bluetooth.