Seperti rilis sebelumnya, Android 15 menyertakan perubahan perilaku yang dapat memengaruhi aplikasi Anda. Perubahan perilaku berikut ini berlaku khusus bagi aplikasi yang menargetkan Android 15 atau yang lebih tinggi. Jika aplikasi Anda menargetkan Android 15 atau yang lebih tinggi, Anda harus memodifikasi aplikasi untuk mendukung perilaku ini dengan benar, jika berlaku.
Pastikan Anda meninjau daftar perubahan perilaku yang memengaruhi semua aplikasi
yang berjalan di Android 15, terlepas dari targetSdkVersion
aplikasi Anda.
Fungsi inti
Android 15 mengubah atau memperluas berbagai kemampuan inti sistem Android.
Perubahan pada layanan latar depan
我们将对 Android 15 中的前台服务进行以下更改。
数据同步前台服务超时行为
对于以 Android 15(API 级别 35)或更高版本为目标平台的应用,Android 15 为 dataSync
引入了新的超时行为。此行为也适用于新的 mediaProcessing
前台服务类型。
系统允许应用的 dataSync
服务在 24 小时内共运行 6 小时,之后系统会调用正在运行的服务的 Service.onTimeout(int, int)
方法(在 Android 15 中引入)。此时,服务有几秒钟的时间来调用 Service.stopSelf()
。调用 Service.onTimeout()
后,该服务将不再被视为前台服务。如果服务未调用 Service.stopSelf()
,系统会抛出内部异常。系统会在 Logcat 中记录此异常,并显示以下消息:
Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type dataSync did not stop within its timeout: [component name]"
为避免此行为变更出现问题,您可以执行以下一项或多项操作:
- 让您的服务实现新的
Service.onTimeout(int, int)
方法。当应用收到回调时,请务必在几秒钟内调用stopSelf()
。(如果您不立即停止应用,系统会生成故障。) - 确保应用的
dataSync
服务在任何 24 小时内总运行时间不超过 6 小时(除非用户与应用互动,重置计时器)。 - 仅在有直接用户互动时启动
dataSync
前台服务;由于服务启动时应用位于前台,因此您的服务在应用进入后台后有完整的 6 小时时间。 - 请使用替代 API,而不是使用
dataSync
前台服务。
如果您的应用的 dataSync
前台服务在过去 24 小时内运行了 6 小时,则您无法启动其他 dataSync
前台服务,除非用户已将您的应用切换到前台(这会重置计时器)。如果您尝试启动其他 dataSync
前台服务,系统会抛出 ForegroundServiceStartNotAllowedException
,并显示类似“前台服务类型 dataSync 的时间限制已用尽”的错误消息。
测试
如需测试应用的行为,即使您的应用并非以 Android 15 为目标平台(只要该应用在 Android 15 设备上运行),您也可以启用数据同步超时。如需启用超时,请运行以下 adb
命令:
adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name
您还可以调整超时期限,以便更轻松地测试应用在达到上限时的行为方式。如需设置新的超时期限,请运行以下 adb
命令:
adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds
新的媒体处理前台服务类型
Android 15 引入了一种新的前台服务类型 mediaProcessing
。此服务类型适用于转码媒体文件等操作。例如,媒体应用可能会下载音频文件,并需要先将其转换为其他格式,然后才能播放。您可以使用 mediaProcessing
前台服务,确保即使应用在后台运行时转换也会继续。
系统允许应用的 mediaProcessing
服务在 24 小时内总共运行 6 小时,之后系统会调用正在运行的服务的 Service.onTimeout(int, int)
方法(在 Android 15 中引入)。此时,服务有几秒钟的时间来调用 Service.stopSelf()
。如果服务未调用 Service.stopSelf()
,系统会抛出内部异常。系统会在 Logcat 中记录此异常,并显示以下消息:
Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type mediaProcessing did not stop within its timeout: [component name]"
为避免出现此异常,您可以执行以下任一操作:
- 让您的服务实现新的
Service.onTimeout(int, int)
方法。当您的应用收到回调时,请务必在几秒钟内调用stopSelf()
。(如果您未立即停止应用,系统会生成失败情况。) - 确保应用的
mediaProcessing
服务在任何 24 小时内总运行时间不超过 6 小时(除非用户与应用互动,重置计时器)。 - 仅在有直接用户互动时启动
mediaProcessing
前台服务;由于服务启动时应用位于前台,因此您的服务在应用进入后台后有完整的 6 小时时间。 - 请改用 替代 API(例如 WorkManager),而不是使用
mediaProcessing
前台服务。
如果您的应用的 mediaProcessing
前台服务在过去 24 小时内运行了 6 小时,则您无法启动其他 mediaProcessing
前台服务,除非用户将您的应用切换到前台(这会重置计时器)。如果您尝试启动另一个 mediaProcessing
前台服务,系统会抛出 ForegroundServiceStartNotAllowedException
,并显示类似于“前台服务类型 mediaProcessing 的时间限制已用尽”的错误消息。
如需详细了解 mediaProcessing
服务类型,请参阅 Android 15 前台服务类型变更:媒体处理。
测试
如需测试应用的行为,您可以启用媒体处理超时,即使您的应用并非以 Android 15 为目标平台也是如此(前提是应用在 Android 15 设备上运行)。如需启用超时,请运行以下 adb
命令:
adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name
您还可以调整超时期限,以便更轻松地测试应用在达到上限时的行为方式。如需设置新的超时期限,请运行以下 adb
命令:
adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds
对启动前台服务的 BOOT_COMPLETED
广播接收器的限制
Ada batasan baru pada penerima siaran BOOT_COMPLETED
yang meluncurkan
layanan latar depan. Penerima BOOT_COMPLETED
tidak diizinkan untuk meluncurkan
jenis layanan latar depan berikut:
dataSync
camera
mediaPlayback
phoneCall
mediaProjection
microphone
(pembatasan ini telah diterapkan selamamicrophone
sejak Android 14)
Jika penerima BOOT_COMPLETED
mencoba meluncurkan salah satu jenis layanan latar depan
tersebut, sistem akan menampilkan ForegroundServiceStartNotAllowedException
.
Pengujian
Untuk menguji perilaku aplikasi, Anda dapat mengaktifkan pembatasan baru ini bahkan jika
aplikasi tidak menargetkan Android 15 (selama aplikasi tersebut berjalan di Android 15
perangkat). Jalankan perintah adb
berikut:
adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name
Untuk mengirim siaran BOOT_COMPLETED
tanpa memulai ulang perangkat,
jalankan perintah adb
berikut:
adb shell am broadcast -a android.intent.action.BOOT_COMPLETED your-package-name
在应用拥有 SYSTEM_ALERT_WINDOW
权限时启动前台服务的限制
Sebelumnya, jika memiliki izin SYSTEM_ALERT_WINDOW
, aplikasi dapat meluncurkan
layanan latar depan meskipun aplikasi saat ini berada di latar belakang (seperti
yang dibahas dalam pengecualian dari pembatasan mulai latar belakang).
Jika aplikasi menargetkan Android 15, pengecualian ini kini lebih sempit. Aplikasi kini harus
memiliki izin SYSTEM_ALERT_WINDOW
dan juga memiliki jendela overlay
yang terlihat. Artinya, aplikasi harus meluncurkan
jendela TYPE_APPLICATION_OVERLAY
terlebih dahulu dan jendela
harus terlihat sebelum Anda memulai layanan latar depan.
Jika aplikasi Anda mencoba memulai layanan latar depan dari latar belakang tanpa
memenuhi persyaratan baru ini (dan tidak memiliki pengecualian lain), sistem
akan menampilkan ForegroundServiceStartNotAllowedException
.
Jika aplikasi Anda mendeklarasikan izin SYSTEM_ALERT_WINDOW
dan meluncurkan layanan latar depan dari latar belakang, aplikasi tersebut mungkin akan terpengaruh oleh
perubahan ini. Jika aplikasi Anda mendapatkan ForegroundServiceStartNotAllowedException
, periksa
urutan operasi aplikasi dan pastikan aplikasi Anda sudah memiliki jendela
overlay yang aktif sebelum mencoba memulai layanan latar depan dari
latar belakang. Anda dapat memeriksa apakah jendela overlay saat ini terlihat
dengan memanggil View.getWindowVisibility()
, atau Anda
dapat mengganti View.onWindowVisibilityChanged()
untuk mendapatkan notifikasi setiap kali visibilitas berubah.
Pengujian
Untuk menguji perilaku aplikasi, Anda dapat mengaktifkan pembatasan baru ini meskipun
aplikasi tidak menargetkan Android 15 (selama aplikasi berjalan di perangkat
Android 15). Untuk mengaktifkan pembatasan baru ini saat memulai layanan latar depan
dari latar belakang, jalankan perintah adb
berikut:
adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name
Perubahan pada waktu aplikasi dapat mengubah status global mode Jangan Ganggu
以 Android 15(API 级别 35)及更高版本为目标平台的应用无法再更改设备上的勿扰 (DND) 功能的全局状态或政策(无论是通过修改用户设置还是关闭勿扰模式)。相反,应用必须提供 AutomaticZenRule
,系统会将其与现有的“最严格的政策优先”方案合并为一个全局政策。对之前会影响全局状态的现有 API 的调用(setInterruptionFilter
、setNotificationPolicy
)会导致创建或更新隐式 AutomaticZenRule
,该 AutomaticZenRule
会根据这些 API 调用的调用周期开启和关闭。
请注意,只有当应用调用 setInterruptionFilter(INTERRUPTION_FILTER_ALL)
并希望该调用停用之前由其所有者激活的 AutomaticZenRule
时,此更改才会影响可观察到的行为。
Perubahan OpenJDK API
Android 15 melanjutkan pekerjaan memuat ulang library inti Android agar selaras dengan fitur dalam rilis OpenJDK LTS terbaru.
Beberapa perubahan ini dapat memengaruhi kompatibilitas aplikasi untuk aplikasi yang menargetkan Android 15 (API level 35):
Perubahan pada API pemformatan string: Validasi indeks argumen, tanda, lebar, dan presisi kini lebih ketat saat menggunakan API
String.format()
danFormatter.format()
berikut:String.format(String, Object[])
String.format(Locale, String, Object[])
Formatter.format(String, Object[])
Formatter.format(Locale, String, Object[])
Misalnya, pengecualian berikut ditampilkan saat indeks argumen 0 digunakan (
%0
dalam string format):IllegalFormatArgumentIndexException: Illegal format argument index = 0
Dalam hal ini, masalah dapat diperbaiki dengan menggunakan indeks argumen 1 (
%1
dalam string format).Perubahan pada jenis komponen
Arrays.asList(...).toArray()
: Saat menggunakanArrays.asList(...).toArray()
, jenis komponen array yang dihasilkan kini menjadiObject
—bukan jenis elemen array yang mendasarinya. Jadi, kode berikut akan menampilkanClassCastException
:String[] elements = (String[]) Arrays.asList("one", "two").toArray();
Untuk kasus ini, guna mempertahankan
String
sebagai jenis komponen dalam array yang dihasilkan, Anda dapat menggunakanCollection.toArray(Object[])
:String[] elements = Arrays.asList("two", "one").toArray(new String[0]);
Perubahan pada penanganan kode bahasa: Saat menggunakan
Locale
API, kode bahasa untuk bahasa Ibrani, Yiddish, dan Indonesia tidak lagi dikonversi ke bentuk yang sudah tidak digunakan lagi (Ibrani:iw
, Yiddish:ji
, dan Indonesia:in
). Saat menentukan kode bahasa untuk salah satu lokalitas ini, gunakan kode dari ISO 639-1 (Ibrani:he
, Yiddish:yi
, dan Indonesia:id
).Perubahan pada urutan int acak: Setelah perubahan yang dilakukan di https://bugs.openjdk.org/browse/JDK-8301574, metode
Random.ints()
berikut kini menampilkan urutan angka yang berbeda dengan metodeRandom.nextInt()
:Umumnya, perubahan ini tidak akan menyebabkan perilaku yang merusak aplikasi, tetapi kode Anda tidak boleh mengharapkan urutan yang dihasilkan dari metode
Random.ints()
untuk cocok denganRandom.nextInt()
.
API SequencedCollection
baru dapat memengaruhi kompatibilitas aplikasi
setelah Anda mengupdate compileSdk
di konfigurasi build aplikasi untuk menggunakan
Android 15 (API level 35):
Tabrakan dengan fungsi ekstensi
MutableList.removeFirst()
danMutableList.removeLast()
dikotlin-stdlib
Jenis
List
di Java dipetakan ke jenisMutableList
di Kotlin. Karena APIList.removeFirst()
danList.removeLast()
telah diperkenalkan di Android 15 (API level 35), compiler Kotlin akan me-resolve panggilan fungsi, misalnyalist.removeFirst()
, secara statis keList
API baru, bukan ke fungsi ekstensi dikotlin-stdlib
.Jika aplikasi dikompilasi ulang dengan
compileSdk
ditetapkan ke35
danminSdk
ditetapkan ke34
atau yang lebih rendah, lalu aplikasi dijalankan di Android 14 dan yang lebih rendah, error runtime akan ditampilkan:java.lang.NoSuchMethodError: No virtual method removeFirst()Ljava/lang/Object; in class Ljava/util/ArrayList;
Opsi lint
NewApi
yang ada di Plugin Android Gradle dapat menangkap penggunaan API baru ini../gradlew lint
MainActivity.kt:41: Error: Call requires API level 35 (current min is 34): java.util.List#removeFirst [NewApi] list.removeFirst()Untuk memperbaiki pengecualian runtime dan error lint, panggilan fungsi
removeFirst()
danremoveLast()
dapat diganti denganremoveAt(0)
danremoveAt(list.lastIndex)
di Kotlin. Jika Anda menggunakan Android Studio Ladybug | 2024.1.3 atau yang lebih tinggi, IDE ini juga menyediakan opsi perbaikan cepat untuk error ini.Pertimbangkan untuk menghapus
@SuppressLint("NewApi")
danlintOptions { disable 'NewApi' }
jika opsi lint telah dinonaktifkan.Tabrakan dengan metode lain di Java
Metode baru telah ditambahkan ke jenis yang ada, misalnya,
List
danDeque
. Metode baru ini mungkin tidak kompatibel dengan metode dengan nama dan jenis argumen yang sama di antarmuka dan class lain. Jika terjadi konflik tanda tangan metode dengan inkompatibilitas, compilerjavac
akan menghasilkan error waktu build. Contoh:Contoh error 1:
javac MyList.java
MyList.java:135: error: removeLast() in MyList cannot implement removeLast() in List public void removeLast() { ^ return type void is not compatible with Object where E is a type-variable: E extends Object declared in interface ListContoh error 2:
javac MyList.java
MyList.java:7: error: types Deque<Object> and List<Object> are incompatible; public class MyList implements List<Object>, Deque<Object> { both define reversed(), but with unrelated return types 1 errorContoh error 3:
javac MyList.java
MyList.java:43: error: types List<E#1> and MyInterface<E#2> are incompatible; public static class MyList implements List<Object>, MyInterface<Object> { class MyList inherits unrelated defaults for getFirst() from types List and MyInterface where E#1,E#2 are type-variables: E#1 extends Object declared in interface List E#2 extends Object declared in interface MyInterface 1 errorUntuk memperbaiki error build ini, class yang mengimplementasikan antarmuka ini harus mengganti metode dengan jenis nilai yang kompatibel. Contoh:
@Override public Object getFirst() { return List.super.getFirst(); }
Keamanan
Android 15 menyertakan perubahan yang meningkatkan keamanan sistem untuk membantu melindungi aplikasi dan pengguna dari aplikasi berbahaya.
Versi TLS yang dibatasi
Android 15 限制了对 TLS 版本 1.0 和 1.1 的使用。这些版本之前已在 Android 中被弃用,但现在不允许面向 Android 15 的应用使用。
Peluncuran aktivitas latar belakang yang aman
Android 15 可保护用户免受恶意应用的侵害,并让用户更好地控制 来防止恶意后台应用 将其他应用置于前台、提升其权限以及滥用 用户互动自以下时间以来,后台活动启动一直受到限制 Android 10(API 级别 29)。
禁止与堆栈中的顶部 UID 不匹配的应用启动 activity
恶意应用可以在同一任务中启动另一个应用的 activity,然后
叠加在上面,营造出像该应用一样的错觉。这个“任务”
劫持"攻击绕过了当前的后台启动限制,
会发生在同一个可见任务中。为了降低这种风险,Android 15 新增了
用于阻止与堆栈中的顶层 UID 不匹配的应用启动的标志
活动。如需选择启用应用的所有活动,请更新
allowCrossUidActivitySwitchFromBelow
属性:AndroidManifest.xml
<application android:allowCrossUidActivitySwitchFromBelow="false" >
如果满足以下所有条件,则启用新的安全措施:
- 执行启动的应用以 Android 15 为目标平台。
- 任务堆栈顶部的应用以 Android 15 为目标平台。
- 所有可见活动都已选择启用新保护措施
如果启用了安全措施,应用可能会返回主屏幕,而不是返回 最后一个可见应用(如果他们自行完成任务)。
其他变更
除了限制 UID 匹配之外,这些其他变更也 包括:
- 更改
PendingIntent
创作者,以阻止后台活动启动,具体方法是: 默认。这有助于防止应用意外创建 可能被恶意操作者滥用的PendingIntent
。 - 请勿将应用调到前台,除非
PendingIntent
发送者 允许它。此变更旨在防止恶意应用滥用 在后台启动 activity 的功能。默认情况下,应用 允许将任务堆栈转到前台,除非创建者允许 后台活动启动权限或发送者有后台活动 启动权限 - 控制任务堆栈的顶层 activity 完成其任务的方式。如果 顶层 activity 完成一项任务后,Android 会返回到之前执行的 上次活动时间。此外,如果非顶层 activity 完成其任务,Android 将 返回主屏幕;因此不会阻碍这个非顶层的 活动。
- 防止将其他应用中的任意 activity 启动到您自己的 activity 任务。这项变更旨在防止恶意应用 看起来像是来自其他应用的活动
- 禁止将不可见窗口视为后台活动 发布。这有助于防止恶意应用滥用后台 activity 来向用户显示不需要或恶意的内容。
Intent yang lebih aman
Android 15 引入了新的可选安全措施,以提高 intent 的安全性和稳健性。这些变更旨在防止潜在的漏洞以及恶意应用可能利用的 intent 滥用行为。Android 15 对 intent 的安全性进行了两项主要改进:
- 与目标 intent 过滤器匹配:定位到特定组件的 intent 必须与目标的 intent 过滤器规范完全匹配。如果您发送 intent 来启动其他应用的 activity,目标 intent 组件需要与接收 activity 声明的 intent 过滤器保持一致。
- intent 必须具有操作:没有操作的 intent 将不再与任何 intent 过滤器匹配。这意味着,用于启动 activity 或服务的 intent 必须具有明确定义的操作。
如需检查您的应用对这些更改的响应方式,请在应用中使用 StrictMode
。如需查看有关 Intent
使用违规行为的详细日志,请添加以下方法:
Kotlin
fun onCreate() { StrictMode.setVmPolicy(VmPolicy.Builder() .detectUnsafeIntentLaunch() .build() ) }
Java
public void onCreate() { StrictMode.setVmPolicy(new VmPolicy.Builder() .detectUnsafeIntentLaunch() .build()); }
Pengalaman pengguna dan UI sistem
Android 15 menyertakan beberapa perubahan yang dimaksudkan untuk menciptakan pengalaman pengguna yang lebih konsisten dan intuitif.
Perubahan inset jendela
Ada dua perubahan yang terkait dengan inset jendela di Android 15: edge-to-edge diberlakukan secara default, dan ada juga perubahan konfigurasi, seperti konfigurasi default panel sistem.
全面实施政策
Aplikasi secara default memiliki tampilan dari tepi ke tepi di perangkat yang menjalankan Android 15 jika aplikasi menargetkan Android 15 (API level 35).

Ini adalah perubahan yang dapat menyebabkan gangguan yang mungkin berdampak negatif pada UI aplikasi Anda. Perubahan ini memengaruhi area UI berikut:
- Menu navigasi handle gestur
- Transparan secara default.
- Offset bawah dinonaktifkan sehingga konten digambar di belakang menu navigasi sistem, kecuali jika inset diterapkan.
setNavigationBarColor
danR.attr#navigationBarColor
tidak digunakan lagi dan tidak memengaruhi navigasi gestur.setNavigationBarContrastEnforced
danR.attr#navigationBarContrastEnforced
terus tidak berpengaruh pada navigasi gestur.
- Navigasi 3 tombol
- Opasitasnya ditetapkan ke 80% secara default, dengan warna yang mungkin cocok dengan latar belakang jendela.
- Offset bawah dinonaktifkan sehingga konten digambar di belakang menu navigasi sistem kecuali jika inset diterapkan.
setNavigationBarColor
danR.attr#navigationBarColor
ditetapkan agar cocok dengan latar belakang jendela secara default. Latar belakang jendela harus berupa drawable warna agar default ini diterapkan. API ini tidak digunakan lagi, tetapi terus memengaruhi navigasi 3 tombol.setNavigationBarContrastEnforced
danR.attr#navigationBarContrastEnforced
bernilai benar (true) secara default, yang menambahkan latar belakang buram 80% di seluruh navigasi 3 tombol.
- Status bar
- Transparan secara default.
- Offset atas dinonaktifkan sehingga konten digambar di belakang status bar, kecuali jika inset diterapkan.
setStatusBarColor
danR.attr#statusBarColor
tidak digunakan lagi dan tidak berpengaruh pada Android 15.setStatusBarContrastEnforced
danR.attr#statusBarContrastEnforced
tidak digunakan lagi, tetapi masih memiliki efek pada Android 15.
- Potongan layar
layoutInDisplayCutoutMode
jendela yang tidak mengambang harusLAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS
.SHORT_EDGES
,NEVER
, danDEFAULT
ditafsirkan sebagaiALWAYS
sehingga pengguna tidak melihat batang hitam yang disebabkan oleh potongan layar dan muncul dari tepi ke tepi.
Contoh berikut menunjukkan aplikasi sebelum dan sesudah menargetkan Android 15 (API level 35), serta sebelum dan sesudah menerapkan inset.



Hal yang perlu diperiksa jika aplikasi Anda sudah memenuhi seluruh layar
Jika aplikasi Anda sudah dari tepi ke tepi dan menerapkan inset, Anda sebagian besar tidak akan terpengaruh, kecuali dalam skenario berikut. Namun, meskipun Anda merasa tidak terpengaruh, sebaiknya uji aplikasi Anda.
- Anda memiliki jendela yang tidak mengambang, seperti
Activity
yang menggunakanSHORT_EDGES
,NEVER
, atauDEFAULT
, bukanLAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS
. Jika aplikasi Anda error saat diluncurkan, hal ini mungkin disebabkan oleh layar pembuka. Anda dapat mengupgrade dependensi layar utama ke 1.2.0-alpha01 atau yang lebih baru atau menetapkanwindow.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always
. - Mungkin ada layar dengan traffic lebih rendah yang memiliki UI yang terhalang. Pastikan
layar yang jarang dikunjungi ini tidak memiliki UI yang terhalang. Layar dengan traffic lebih rendah mencakup:
- Layar aktivasi atau login
- Halaman setelan
Yang harus diperiksa jika aplikasi Anda belum memenuhi syarat untuk layar penuh
Jika aplikasi Anda belum memenuhi seluruh layar, kemungkinan besar Anda akan terpengaruh. Selain skenario untuk aplikasi yang sudah memiliki tampilan layar penuh, Anda harus mempertimbangkan hal berikut:
- Jika aplikasi Anda menggunakan Komponen Material 3 (
androidx.compose.material3
) di compose, sepertiTopAppBar
,BottomAppBar
, danNavigationBar
, komponen ini kemungkinan tidak terpengaruh karena secara otomatis menangani inset. - Jika aplikasi Anda menggunakan Komponen Material 2 (
androidx.compose.material
) di Compose, komponen ini tidak otomatis menangani inset. Namun, Anda dapat memperoleh akses ke inset dan menerapkannya secara manual. Di androidx.compose.material 1.6.0 dan yang lebih baru, gunakan parameterwindowInsets
untuk menerapkan inset secara manual untukBottomAppBar
,TopAppBar
,BottomNavigation
, danNavigationRail
. Demikian pula, gunakan parametercontentWindowInsets
untukScaffold
. - Jika aplikasi Anda menggunakan tampilan dan Komponen Material
(
com.google.android.material
), sebagian besar Komponen Material berbasis tampilan sepertiBottomNavigationView
,BottomAppBar
,NavigationRailView
, atauNavigationView
, menangani inset dan tidak memerlukan tindakan tambahan. Namun, Anda perlu menambahkanandroid:fitsSystemWindows="true"
jika menggunakanAppBarLayout
. - Untuk composable kustom, terapkan inset secara manual sebagai padding. Jika
konten Anda berada dalam
Scaffold
, Anda dapat menggunakan inset menggunakan nilai paddingScaffold
. Jika tidak, terapkan padding menggunakan salah satuWindowInsets
. - Jika aplikasi Anda menggunakan tampilan dan
BottomSheet
,SideSheet
, atau kontainer kustom, terapkan padding menggunakanViewCompat.setOnApplyWindowInsetsListener
. UntukRecyclerView
, terapkan padding menggunakan pemroses ini dan juga tambahkanclipToPadding="false"
.
Hal yang harus diperiksa jika aplikasi Anda harus menawarkan perlindungan latar belakang kustom
Jika aplikasi Anda harus menawarkan perlindungan latar belakang kustom ke navigasi 3 tombol atau
status bar, aplikasi Anda harus menempatkan composable atau tampilan di belakang status bar
menggunakan WindowInsets.Type#tappableElement()
untuk mendapatkan tinggi menu navigasi
3 tombol atau WindowInsets.Type#statusBars
.
Referensi edge-to-edge tambahan
Lihat panduan Tampilan dari Tepi ke Tepi dan Compose dari Tepi ke Tepi untuk pertimbangan tambahan tentang penerapan inset.
API yang Tidak Digunakan Lagi
API berikut tidak digunakan lagi, tetapi tidak dinonaktifkan:
R.attr#enforceStatusBarContrast
R.attr#navigationBarColor
(untuk navigasi 3 tombol, dengan alfa 80%)Window#isStatusBarContrastEnforced
Window#setNavigationBarColor
(untuk navigasi 3 tombol, dengan alpha 80%)Window#setStatusBarContrastEnforced
API berikut tidak digunakan lagi dan dinonaktifkan:
R.attr#navigationBarColor
(untuk navigasi gestur)R.attr#navigationBarDividerColor
R.attr#statusBarColor
Window#setDecorFitsSystemWindows
Window#getNavigationBarColor
Window#getNavigationBarDividerColor
Window#getStatusBarColor
Window#setNavigationBarColor
(untuk navigasi gestur)Window#setNavigationBarDividerColor
Window#setStatusBarColor
稳定配置
如果您的应用以 Android 15(API 级别 35)或更高版本为目标平台,Configuration
否
不再包含系统栏。如果您使用
Configuration
类,您应将其替换为更好的
相应的 ViewGroup
、WindowInsets
或
WindowMetricsCalculator
,具体取决于您的需求。
Configuration
从 API 1 开始提供。它通常从 Activity.onConfigurationChanged
中获取。它提供窗口密度、屏幕方向和尺寸等信息。从 Configuration
返回的窗口大小的一个重要特征是,它之前会排除系统栏。
配置大小通常用于选择资源,例如
/res/layout-h500dp
,这仍然是一个有效的用例。不过,我们一直不建议将其用于布局计算。如果需要,您应该将
现在离它远去。您应该使用 Configuration
具体取决于您的应用场景。
如果使用它来计算布局,请使用适当的 ViewGroup
,例如
CoordinatorLayout
或 ConstraintLayout
。如果使用该属性确定高度
,请使用 WindowInsets
。如果您想知道应用窗口的当前大小,请使用 computeCurrentWindowMetrics
。
以下列表介绍了受此变更影响的字段:
Configuration.screenWidthDp
和screenHeightDp
尺寸不再排除系统栏。Configuration.smallestScreenWidthDp
受到更改的间接影响 发送给screenWidthDp
和screenHeightDp
。Configuration.orientation
受到以下项的更改间接影响:screenWidthDp
和screenHeightDp
,在近似方形设备上显示。Display.getSize(Point)
会间接受到Configuration
。从 API 级别 30 开始,此方法已被弃用。- 从 API 级别 33 开始,
Display.getMetrics()
就已经这样运作了。
Atribut elegantTextHeight ditetapkan secara default ke true
对于以 Android 15(API 级别 35)为目标平台的应用,elegantTextHeight
TextView
属性默认会变为 true
,将默认使用的紧凑字体替换为一些具有较大垂直测量的脚本,使其更易于阅读。紧凑字体旨在防止布局中断;Android 13(API 级别 33)允许文本布局利用 fallbackLineSpacing
属性拉伸垂直高度,从而防止许多此类中断。
在 Android 15 中,系统中仍保留了紧凑字体,因此您的应用可以将 elegantTextHeight
设置为 false
以获得与之前相同的行为,但即将发布的版本不太可能支持此字体。因此,如果您的应用支持以下脚本:阿拉伯语、老挝语、缅甸语、泰米尔语、古吉拉特语、卡纳达语、马拉雅拉姆语、奥里亚语、泰卢固语或泰语,请将 elegantTextHeight
设置为 true
以测试您的应用。

elegantTextHeight
行为。
elegantTextHeight
行为。Perubahan lebar TextView untuk bentuk huruf yang kompleks
在以前的 Android 版本中,某些具有复杂形状的手写字体或语言可能会在上一个或下一个字符的区域绘制字母。在某些情况下,此类字母会在开头或结尾处被剪裁。从 Android 15 开始,TextView
会分配宽度,以便为此类字母绘制足够的空间,并允许应用请求向左额外添加内边距以防止剪裁。
由于此更改会影响 TextView
确定宽度的方式,因此如果应用以 Android 15(API 级别 35)或更高版本为目标平台,TextView
会默认分配更多宽度。您可以通过对 TextView
调用 setUseBoundsForWidth
API 来启用或停用此行为。
由于添加左内边距可能会导致现有布局未对齐,因此默认情况下不会添加内边距,即使以 Android 15 或更高版本为目标平台的应用也是如此。不过,您可以通过调用 setShiftDrawingOffsetForStartOverhang
添加额外的内边距以防止剪裁。
以下示例展示了这些更改如何改进某些字体和语言的文本布局。

<TextView android:fontFamily="cursive" android:text="java" />

<TextView android:fontFamily="cursive" android:text="java" android:useBoundsForWidth="true" android:shiftDrawingOffsetForStartOverhang="true" />

<TextView android:text="คอมพิวเตอร์" />

<TextView android:text="คอมพิวเตอร์" android:useBoundsForWidth="true" android:shiftDrawingOffsetForStartOverhang="true" />
Tinggi baris default yang mempertimbangkan lokalitas untuk EditText
在较低版本的 Android 中,文本布局会拉伸文本的高度,以满足与当前语言区域匹配的字体的行高。例如,如果内容是日语,由于日语字体的行高略高于拉丁字体,因此文本的高度会略高。不过,尽管行高存在这些差异,但无论使用的是哪种语言区域,EditText
元素的大小都是统一的,如下图所示:

EditText
元素。EditText
的高度相同,即使这些语言的行高各不相同。对于以 Android 15(API 级别 35)为目标平台的应用,现在为 EditText
预留了最小行高,以匹配指定语言区域的参考字体,如下图所示:

EditText
元素。EditText
的高度现在包含足够的空间来容纳这些语言字体的默认行高。如有需要,您的应用可以将 useLocalePreferredLineHeightForMinimum
属性指定为 false
,以恢复之前的行为;您的应用还可以在 Kotlin 和 Java 中使用 setMinimumFontMetrics
API 设置自定义最小垂直指标。
Kamera dan media
Android 15 membuat perubahan berikut pada perilaku kamera dan media untuk aplikasi yang menargetkan Android 15 atau yang lebih tinggi.
Pembatasan dalam meminta fokus audio
Aplikasi yang menargetkan Android 15 (API level 35) harus menjadi aplikasi teratas atau menjalankan
layanan latar depan untuk meminta fokus audio. Jika aplikasi
mencoba meminta fokus saat tidak memenuhi salah satu persyaratan ini, panggilan akan menampilkan AUDIOFOCUS_REQUEST_FAILED
.
Anda dapat mempelajari fokus audio lebih lanjut di Mengelola fokus audio.
Pembatasan non-SDK yang diperbarui
Android 15 menyertakan daftar terbaru antarmuka non-SDK yang dibatasi berdasarkan kolaborasi dengan developer Android dan pengujian internal terbaru. Jika memungkinkan, kami akan memastikan ketersediaan alternatif publik sebelum membatasi antarmuka non-SDK.
Jika aplikasi Anda tidak menargetkan Android 15, beberapa perubahan ini mungkin tidak langsung memengaruhi Anda. Namun, meskipun aplikasi Anda dapat mengakses beberapa antarmuka non-SDK bergantung pada API level target aplikasi Anda, penggunaan metode atau kolom non-SDK selalu berisiko tinggi merusak aplikasi Anda.
Jika tidak yakin apakah aplikasi Anda menggunakan antarmuka non-SDK atau tidak, Anda dapat menguji aplikasi untuk mencari tahu. Jika aplikasi Anda mengandalkan antarmuka non-SDK, sebaiknya mulailah merencanakan migrasi ke alternatif SDK. Meskipun begitu, kami memahami bahwa beberapa aplikasi memiliki kasus penggunaan yang valid untuk menggunakan antarmuka non-SDK. Jika tidak dapat menemukan alternatif penggunaan antarmuka non-SDK untuk fitur dalam aplikasi Anda, sebaiknya minta API publik baru.
如需详细了解此 Android 版本中的变更,请参阅 Android 15 中有关限制非 SDK 接口的更新。如需全面了解有关非 SDK 接口的详细信息,请参阅对非 SDK 接口的限制。