Perubahan framework kompatibilitas (Android–15)

Gambar 1. Layar Perubahan Kompatibilitas Aplikasi di opsi developer mencantumkan perubahan yang dapat Anda ubah.

Halaman ini menjelaskan perubahan yang dapat diganti statusnya sebagai bagian dari framework kompatibilitas di Android 15. Gunakan daftar ini bersama dengan opsi developer dan perintah ADB untuk menguji dan men-debug aplikasi saat Anda bersiap untuk mendukung dan menargetkan Android 15.

Beberapa hal yang dapat Anda lakukan menggunakan alat framework kompatibilitas:

  • Menguji perubahan yang ditargetkan tanpa benar-benar mengubah targetSdkVersion aplikasi. Anda dapat menggunakan tombol alih untuk mengaktifkan paksa setiap perubahan perilaku yang ditargetkan, guna mengevaluasi dampaknya terhadap aplikasi yang ada.
  • Memfokuskan pengujian pada perubahan tertentu. Dengan tombol alih ini, Anda dapat menonaktifkan beberapa perubahan yang ditargetkan, sehingga dapat melakukan pengujian sesuai kebutuhan tanpa perlu menangani semua perubahan yang ditargetkan sekaligus.
  • Mengelola tombol alih melalui adb. Anda dapat menggunakan perintah adb untuk mengaktifkan atau menonaktifkan perubahan yang dapat diganti statusnya di lingkungan pengujian otomatis.
  • Men-debug lebih cepat menggunakan ID perubahan standar. Setiap perubahan yang dapat diganti statusnya memiliki ID dan nama unik yang dapat Anda gunakan untuk men-debug root masalah dalam output log dengan cepat.

Untuk mengetahui detail lengkap penggunaan fitur untuk setiap kasus penggunaan tersebut, lihat Alat framework kompatibilitas.

Perubahan perilaku yang disertakan dalam framework kompatibilitas

Daftar di bagian ini menjelaskan perubahan yang dapat diganti statusnya dan disertakan dalam framework kompatibilitas untuk perubahan terkait Android 15 dan perubahan yang dapat diganti statusnya yang dapat membantu pengujian aplikasi umum.

Anda dapat memfilter daftar perubahan menurut Status Defaultnya.

Perubahan yang dapat dialihkan dalam framework kompatibilitas di Android 15

CAMERA_MIC_INDICATORS_NOT_PRESENT

ID Perubahan: 162547999
Status Default: Dinonaktifkan untuk semua aplikasi.

Menunjukkan bahwa perangkat ini mendukung indikator kamera dan mikrofon. Nilainya adalah false jika ada, karena metode CompatChanges#isChangeEnabled menampilkan true jika ID Perubahan tidak ada.

DOWNSCALED

ID Perubahan: 168419799
Status Default: Dinonaktifkan untuk semua aplikasi.

Perubahan ini adalah penyeleksi semua perubahan pengurangan skala buffering per aplikasi. Jika perubahan ini diaktifkan, faktor penskalaan berikut dapat diterapkan:

Jika perubahan ini diaktifkan untuk paket aplikasi, ukuran aplikasi akan diubah secara paksa ke faktor penskalaan tertinggi yang diaktifkan. Misalnya, 80% digunakan jika 80% dan 70% (DOWNSCALE_80 dan DOWNSCALE_70) diaktifkan. Jika perubahan ini dan DOWNSCALED_INVERSE diaktifkan, DOWNSCALED_INVERSE akan diprioritaskan dan faktor penskalaan akan diterapkan secara terbalik.

DOWNSCALED_INVERSE

ID Perubahan: 273564678
Status Default: Dinonaktifkan untuk semua aplikasi.

Perubahan ini adalah penyeleksi semua perubahan pengurangan skala terbalik buffering per aplikasi. Jika perubahan ini diaktifkan, faktor penskalaan berikut dapat diterapkan secara terbalik (artinya, resolusi ditingkatkan):

Jika perubahan ini diaktifkan untuk paket aplikasi, ukuran aplikasi akan diubah secara paksa ke faktor penskalaan terendah yang diaktifkan. Misalnya, 80% digunakan jika 80% dan 70% (DOWNSCALE_80 dan DOWNSCALE_70) diaktifkan karena saat diterapkan secara terbalik, faktor penskalaan 80% sama dengan 125%, yang lebih kecil dari penskalaan 142,86% yang diterapkan saat menerapkan faktor penskalaan 70% secara terbalik. Jika perubahan ini dan DOWNSCALED diaktifkan, DOWNSCALED_INVERSE akan diprioritaskan dan faktor penskalaan akan diterapkan secara terbalik.

DOWNSCALE_30

ID Perubahan: 189970040
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika DOWNSCALED juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan resolusi vertikal dan horizontal 30% dari tampilan sebenarnya. Jika DOWNSCALED_INVERSE juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan 333,33% dari resolusi vertikal dan horizontal dari tampilan sebenarnya.

DOWNSCALE_35

ID Perubahan: 189969749
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika DOWNSCALED juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan resolusi vertikal dan horizontal 35% dari tampilan sebenarnya. Jika DOWNSCALED_INVERSE juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan 285,71% dari resolusi vertikal dan horizontal dari tampilan sebenarnya.

DOWNSCALE_40

ID Perubahan: 189970038
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika DOWNSCALED juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan resolusi vertikal dan horizontal sebesar 40% dari tampilan sebenarnya. Jika DOWNSCALED_INVERSE juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan resolusi vertikal dan horizontal 250% dari tampilan sebenarnya.

DOWNSCALE_45

ID Perubahan: 189969782
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika DOWNSCALED juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan resolusi vertikal dan horizontal sebesar 45% dari tampilan sebenarnya. Jika DOWNSCALED_INVERSE juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan 222,22% dari resolusi vertikal dan horizontal dari tampilan sebenarnya.

DOWNSCALE_50

ID Perubahan: 176926741
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika DOWNSCALED juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan 50% resolusi vertikal dan horizontal dari tampilan sebenarnya. Jika DOWNSCALED_INVERSE juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan resolusi vertikal dan horizontal 200% dari tampilan sebenarnya.

DOWNSCALE_55

ID Perubahan: 189970036
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika DOWNSCALED juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan resolusi vertikal dan horizontal sebesar 55% dari tampilan sebenarnya. Jika DOWNSCALED_INVERSE juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan 181,82% dari resolusi vertikal dan horizontal dari tampilan sebenarnya.

DOWNSCALE_60

ID Perubahan: 176926771
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika DOWNSCALED juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan 60% resolusi vertikal dan horizontal dari tampilan sebenarnya. Jika DOWNSCALED_INVERSE juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan 166,67% dari resolusi vertikal dan horizontal dari tampilan sebenarnya.

DOWNSCALE_65

ID Perubahan: 189969744
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika DOWNSCALED juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan resolusi vertikal dan horizontal sebesar 65% dari tampilan sebenarnya. Jika DOWNSCALED_INVERSE juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan 153,85% dari resolusi vertikal dan horizontal dari tampilan sebenarnya.

DOWNSCALE_70

ID Perubahan: 176926829
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika DOWNSCALED juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan 70% resolusi vertikal dan horizontal dari tampilan sebenarnya. Jika DOWNSCALED_INVERSE juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan 142,86% dari resolusi vertikal dan horizontal dari tampilan sebenarnya.

DOWNSCALE_75

ID Perubahan: 189969779
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika DOWNSCALED juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan resolusi vertikal dan horizontal 75% dari tampilan sebenarnya. Jika DOWNSCALED_INVERSE juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan 133,33% dari resolusi vertikal dan horizontal dari tampilan sebenarnya.

DOWNSCALE_80

ID Perubahan: 176926753
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika DOWNSCALED juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan resolusi vertikal dan horizontal 80% dari tampilan sebenarnya. Jika DOWNSCALED_INVERSE juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan resolusi vertikal dan horizontal 125% dari tampilan sebenarnya.

DOWNSCALE_85

ID Perubahan: 189969734
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika DOWNSCALED juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan resolusi vertikal dan horizontal sebesar 85% dari tampilan sebenarnya. Jika DOWNSCALED_INVERSE juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan 117,65% dari resolusi vertikal dan horizontal dari tampilan sebenarnya.

DOWNSCALE_90

ID Perubahan: 182811243
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika DOWNSCALED juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan 90% resolusi vertikal dan horizontal dari tampilan sebenarnya. Jika DOWNSCALED_INVERSE juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan memaksa aplikasi menganggapnya berjalan pada layar dengan 111,11% dari resolusi vertikal dan horizontal dari tampilan sebenarnya.

ENFORCE_STRICT_QUERY_BUILDER

ID Perubahan: 143231523
Status Default: Dinonaktifkan untuk semua aplikasi.

Saat dinonaktifkan, SQLiteQueryBuilder akan memverifikasi semua pilihan kueri CalendarProvider2 terhadap argumen berbahaya.

FGS_BOOT_COMPLETED_RESTRICTIONS

ID Perubahan: 296558535
Status Default: Diaktifkan untuk aplikasi yang menargetkan Android 15 atau yang lebih tinggi.

Jika diaktifkan, nonaktifkan siaran latar depan layanan latar depan yang dimulai dari siaran BOOT_COMPLETED untuk semua jenis kecuali:

Untuk mempelajari perubahan ini lebih lanjut, lihat bagian di halaman perubahan perilaku Android 15 tentang Pembatasan pada penerima siaran BOOT_COMPLETED yang meluncurkan layanan latar depan.

FORCE_DISABLE_HEVC_SUPPORT

ID Perubahan: 174227820
Status Default: Dinonaktifkan untuk semua aplikasi.

Menonaktifkan aplikasi secara paksa agar tidak mendukung kemampuan media HEVC. Aplikasi harus menyatakan kemampuan media yang didukung dalam manifesnya, tetapi tanda ini dapat digunakan untuk memaksa aplikasi agar tidak mendukung HEVC sehingga memaksa transcoding saat mengakses media yang dienkode di HEVC. Menyetel tanda ini akan mengganti setelan default tingkat OS apa pun untuk aplikasi. Fitur ini dinonaktifkan secara default, yang berarti setelan default OS lebih diutamakan. Jika tanda ini dan FORCE_ENABLE_HEVC_SUPPORT diaktifkan, OS akan mengabaikan kedua tanda.

FORCE_ENABLE_HEVC_SUPPORT

ID Perubahan: 174228127
Status Default: Dinonaktifkan untuk semua aplikasi.

Mengaktifkan paksa aplikasi untuk mendukung kemampuan media HEVC harus menyatakan kemampuan media yang didukung dalam manifesnya, tetapi tanda ini dapat digunakan untuk memaksa aplikasi agar mendukung HEVC sehingga dapat menghindari transcoding saat mengakses media yang dienkode di HEVC. Menyetel tanda ini akan menggantikan setelan default tingkat OS apa pun untuk aplikasi. Fitur ini dinonaktifkan secara default, yang berarti setelan default OS akan lebih diutamakan. Jika tanda ini dan FORCE_DISABLE_HEVC_SUPPORT diaktifkan, OS akan mengabaikan kedua tanda.

FORCE_NON_RESIZE_APP

ID Perubahan: 181146395
Status Default: Dinonaktifkan untuk semua aplikasi.

Memaksa paket yang diterapkan agar ukurannya tidak dapat diubah.

FORCE_RESIZE_APP

ID Perubahan: 174042936
Status Default: Dinonaktifkan untuk semua aplikasi.

Memaksa paket yang diterapkan agar ukurannya dapat diubah. Pengubahan ukuran hanya diizinkan dalam mode jendela penuh layar, tetapi tidak memaksa aplikasi beralih ke mode multi-aplikasi yang dapat diubah ukurannya.

GWP_ASAN

ID Perubahan: 145634846
Status Default: Dinonaktifkan untuk semua aplikasi.

Mengaktifkan deteksi bug memori native yang diambil sampelnya dalam aplikasi.

Untuk mempelajari lebih lanjut cara menggunakan GWP-ASan, lihat panduan GWP-ASan.

NATIVE_HEAP_ZERO_INIT

ID Perubahan: 178038272
Status Default: Dinonaktifkan untuk semua aplikasi.

Aktifkan inisialisasi nol otomatis alokasi memori heap native.

NATIVE_MEMTAG_ASYNC

ID Perubahan: 145772972
Status Default: Dinonaktifkan untuk semua aplikasi.

Mengaktifkan pemeriksaan tag memori asinkron (ASYNC) dalam proses ini. Tanda ini hanya memengaruhi hardware yang mendukung ARM Memory Tagging Extension (MTE).

NATIVE_MEMTAG_SYNC

ID Perubahan: 177438394
Status Default: Dinonaktifkan untuk semua aplikasi.

Mengaktifkan pemeriksaan tag memori sinkron (SINKRONISASI) dalam proses ini. Tanda ini hanya memengaruhi hardware yang mendukung ARM Memory Tagging Extension (MTE). Jika NATIVE_MEMTAG_ASYNC dan opsi ini diaktifkan, opsi ini akan diprioritaskan dan MTE akan diaktifkan dalam mode SYNC.

OVERRIDE_ANY_ORIENTATION

ID Perubahan: 265464455
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika diaktifkan, perubahan ini memungkinkan penggantian orientasi berikut diterapkan, apa pun orientasi yang diminta oleh aktivitas:

OVERRIDE_ANY_ORIENTATION_TO_USER

ID Perubahan: 310816437
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika diaktifkan, SCREEN_ORIENTATION_USER akan diaktifkan, yang akan menggantikan orientasi apa pun yang diminta oleh aktivitas. Aplikasi orientasi tetap dapat diganti ke layar penuh di perangkat layar besar dengan ignoreOrientationRequest yang diaktifkan dengan penggantian ini.

OVERRIDE_CAMERA_RESIZABLE_AND_SDK_CHECK

ID Perubahan: 191514214
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika diaktifkan, perubahan ini akan memaksa paket yang diterapkan untuk mengabaikan nilai android:resizeableActivity saat ini serta SDK target yang sama dengan atau di bawah M dan menganggap aktivitas sebagai tidak dapat diubah ukurannya. Dalam hal ini, nilai putar dan pangkas kamera hanya bergantung pada kompensasi yang diperlukan, mengingat rotasi tampilan saat ini.

OVERRIDE_CAMERA_ROTATE_AND_CROP_DEFAULTS

ID Perubahan: 189229956
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika diaktifkan, perubahan ini akan memaksa paket yang diterapkan untuk mengganti perilaku putar dan pangkas kamera default serta selalu menampilkan CaptureRequest.SCALER_ROTATE_AND_CROP_NONE.

OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE

ID Perubahan: 266124927
Status Default: Dinonaktifkan untuk semua aplikasi.

Mengaktifkan SCREEN_ORIENTATION_REVERSE_LANDSCAPE untuk aplikasi tempat kode tersebut diterapkan. Kecuali OVERRIDE_ANY_ORIENTATION juga diaktifkan, SCREEN_ORIENTATION_REVERSE_LANDSCAPE hanya digunakan saat aktivitas menentukan orientasi lanskap. Mengaktifkan perubahan ini dapat membantu Anda menguji perilaku aplikasi untuk mengetahui perbedaan antara perangkat yang orientasi lanskapnya sesuai dengan Surface.ROTATION_90 dan perangkat yang sesuai dengan Surface.ROTATION_270.

OVERRIDE_MIN_ASPECT_RATIO

ID Perubahan: 174042980
Status Default: Dinonaktifkan untuk semua aplikasi.

Perubahan ini adalah penyeleksi semua perubahan yang memaksa rasio lebar tinggi minimum tertentu. Mengaktifkan perubahan ini memungkinkan rasio lebar tinggi minimum berikut diterapkan:

Jika perubahan ini diaktifkan untuk paket aplikasi, rasio aspek minimum yang diberikan dalam manifes aplikasi akan diganti ke rasio aspek terbesar yang diaktifkan kecuali nilai manifes aplikasi lebih tinggi.

OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN

ID Perubahan: 218959984
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika diaktifkan, setelan ini akan mengganti batasan rasio aspek minimum di layar penuh potret agar dapat menggunakan semua ruang layar yang tersedia.

OVERRIDE_MIN_ASPECT_RATIO_LARGE

ID Perubahan: 180326787
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika OVERRIDE_MIN_ASPECT_RATIO juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan menetapkan rasio aspek minimum aktivitas ke nilai besar seperti yang ditetapkan oleh OVERRIDE_MIN_ASPECT_RATIO_LARGE_VALUE.

OVERRIDE_MIN_ASPECT_RATIO_MEDIUM

ID Perubahan: 180326845
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika OVERRIDE_MIN_ASPECT_RATIO juga diaktifkan, mengaktifkan perubahan ini untuk sebuah paket akan menetapkan rasio aspek minimum aktivitas ke nilai sedang seperti yang ditetapkan oleh OVERRIDE_MIN_ASPECT_RATIO_MEDIUM_VALUE.

OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

ID Perubahan: 203647190
Status Default: Diaktifkan untuk semua aplikasi.

Jika OVERRIDE_MIN_ASPECT_RATIO juga diaktifkan, perubahan ini akan membatasi perubahan lain yang memaksa rasio aspek minimum aktivitas ke nilai tertentu—seperti OVERRIDE_MIN_ASPECT_RATIO_LARGE dan OVERRIDE_MIN_ASPECT_RATIO_MEDIUM—ke aktivitas yang juga memiliki orientasi potret.

OVERRIDE_RESPECT_REQUESTED_ORIENTATION

ID Perubahan: 236283604
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika diaktifkan, perubahan ini akan mengecualikan paket yang diterapkan ke dari batasan orientasi abaikan yang dapat ditetapkan oleh produsen perangkat.

OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR

ID Perubahan: 265451093
Status Default: Dinonaktifkan untuk semua aplikasi.

Mengaktifkan SCREEN_ORIENTATION_NOSENSOR untuk aplikasi tempat kode tersebut diterapkan. Kecuali OVERRIDE_ANY_ORIENTATION juga diaktifkan, SCREEN_ORIENTATION_NOSENSOR hanya digunakan saat aktivitas tidak menetapkan orientasi tetap lainnya.

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT

ID Perubahan: 265452344
Status Default: Dinonaktifkan untuk semua aplikasi.

Mengaktifkan SCREEN_ORIENTATION_PORTRAIT untuk aplikasi tempat kode tersebut diterapkan. Kecuali OVERRIDE_ANY_ORIENTATION juga diaktifkan, SCREEN_ORIENTATION_PORTRAIT hanya digunakan saat aktivitas tidak menetapkan orientasi tetap lainnya.

RATE_LIMIT_TOASTS

ID Perubahan: 174840628
Status Default: Perubahan ini tidak dapat dialihkan. Perubahan hanya dicatat ke dalam log oleh framework kompatibilitas.

Mengaktifkan pembatasan kapasitas jumlah panggilan Toast.show() untuk mencegah beban berlebih pada pengguna yang memiliki terlalu banyak toast dalam waktu terbatas. Setiap upaya untuk menampilkan jumlah toast yang terlalu banyak dari jumlah yang diizinkan dalam jangka waktu tertentu akan mengakibatkan toast dihapus.

USE_EXPERIMENTAL_COMPONENT_ALIAS

ID Perubahan: 196254758
Status Default: Dinonaktifkan untuk semua aplikasi.

Jika diaktifkan, sistem akan memungkinkan paket "android" menggunakan alias komponen.