Al igual que las versiones anteriores, Android 15 incluye cambios de comportamiento que podrían afectar tu app. Los siguientes cambios se aplican exclusivamente a las apps orientadas a Android 15 o versiones posteriores. Si tu app está segmentada para Android 15 o versiones posteriores, debes modificarla para que admita estos comportamientos correctamente, cuando corresponda.
Asegúrate de revisar también la lista de cambios en el comportamiento que afectan a todas las apps que se ejecutan en Android 15, independientemente de targetSdkVersion de tu app.
Funcionalidad principal
Android 15 modifica o expande varias capacidades principales del sistema Android.
Cambios en los servicios en primer plano
Realizaremos los siguientes cambios en los servicios en primer plano con Android 15.
- Comportamiento de tiempo de espera del servicio en primer plano de sincronización de datos
- Nuevo tipo de servicio en primer plano de procesamiento de contenido multimedia
- Restricciones para los receptores de emisión
BOOT_COMPLETEDque inician servicios en primer plano - Restricciones para iniciar servicios en primer plano mientras una app tiene el permiso
SYSTEM_ALERT_WINDOW
Comportamiento del tiempo de espera del servicio en primer plano de sincronización de datos
Android 15 presenta un nuevo comportamiento de tiempo de espera para dataSync en el caso de las apps que se orientan a Android 15 (nivel de API 35) o versiones posteriores. Este comportamiento también se aplica al nuevo tipo de servicio en primer plano mediaProcessing.
El sistema permite que los servicios dataSync de una app se ejecuten durante un total de 6 horas en un período de 24 horas, después de lo cual el sistema llama al método Service.onTimeout(int, int) del servicio en ejecución (presentado en Android 15). En este momento, el servicio tiene unos segundos para llamar a Service.stopSelf(). Cuando se llama a Service.onTimeout(), el servicio ya no se considera un servicio en primer plano. Si el servicio no llama a Service.stopSelf(), el sistema arroja una excepción interna. La excepción se registra en Logcat con el siguiente mensaje:
Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type dataSync did not stop within its timeout: [component name]"
Para evitar problemas con este cambio de comportamiento, puedes realizar una o más de las siguientes acciones:
- Haz que tu servicio implemente el nuevo método
Service.onTimeout(int, int). Cuando tu app reciba la devolución de llamada, asegúrate de llamar astopSelf()en unos pocos segundos. (Si no detienes la app de inmediato, el sistema genera una falla). - Asegúrate de que los servicios
dataSyncde tu app no se ejecuten durante más de un total de 6 horas en cualquier período de 24 horas (a menos que el usuario interactúe con la app y restablezca el temporizador). - Inicia servicios en primer plano de
dataSyncsolo como resultado de la interacción directa del usuario. Como tu app está en primer plano cuando se inicia el servicio, este tiene las seis horas completas después de que la app pasa a segundo plano. - En lugar de usar un servicio en primer plano de
dataSync, usa una API alternativa.
Si los servicios en primer plano dataSync de tu app se ejecutaron durante 6 horas en las últimas 24, no puedes iniciar otro servicio en primer plano dataSync a menos que el usuario haya llevado tu app al primer plano (lo que restablece el temporizador). Si intentas iniciar otro servicio en primer plano dataSync, el sistema arrojará una ForegroundServiceStartNotAllowedException con un mensaje de error como "El límite de tiempo ya se agotó para el tipo de servicio en primer plano dataSync".
Prueba
Para probar el comportamiento de tu app, puedes habilitar los tiempos de espera de sincronización de datos, incluso si tu app no se orienta a Android 15 (siempre que la app se ejecute en un dispositivo Android 15). Para habilitar los tiempos de espera, ejecuta el siguiente comando adb:
adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name
También puedes ajustar el tiempo de espera para facilitar la prueba del comportamiento de tu app cuando se alcanza el límite. Para establecer un nuevo período de tiempo de espera, ejecuta el siguiente comando adb:
adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds
Nuevo tipo de servicio en primer plano de procesamiento de contenido multimedia
Android 15 presenta un nuevo tipo de servicio en primer plano: mediaProcessing. Este tipo de servicio es adecuado para operaciones como la transcodificación de archivos multimedia. Por ejemplo, una app de música puede descargar un archivo de audio y necesitar convertirlo a un formato diferente antes de reproducirlo. Puedes usar un servicio en primer plano mediaProcessing para asegurarte de que la conversión continúe incluso mientras la app está en segundo plano.
El sistema permite que los servicios mediaProcessing de una app se ejecuten durante un total de 6 horas en un período de 24 horas, después del cual el sistema llama al método Service.onTimeout(int, int) del servicio en ejecución (presentado en Android 15). En este momento, el servicio tiene unos segundos para llamar a Service.stopSelf(). Si el servicio no llama a Service.stopSelf(), el sistema arroja una excepción interna. La excepción se registra en Logcat con el siguiente mensaje:
Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type mediaProcessing did not stop within its timeout: [component name]"
Para evitar tener la excepción, puedes realizar una de las siguientes acciones:
- Haz que tu servicio implemente el nuevo método
Service.onTimeout(int, int). Cuando tu app reciba la devolución de llamada, asegúrate de llamar astopSelf()en unos pocos segundos. (Si no detienes la app de inmediato, el sistema genera una falla). - Asegúrate de que los servicios
mediaProcessingde tu app no se ejecuten durante más de un total de 6 horas en cualquier período de 24 horas (a menos que el usuario interactúe con la app y restablezca el temporizador). - Inicia servicios en primer plano de
mediaProcessingsolo como resultado de la interacción directa del usuario. Como tu app está en primer plano cuando se inicia el servicio, este tiene las seis horas completas después de que la app pasa a segundo plano. - En lugar de usar un servicio en primer plano de
mediaProcessing, usa una API alternativa, como WorkManager.
Si los servicios en primer plano de mediaProcessing de tu app se ejecutaron durante 6 horas durante las últimas 24, no puedes iniciar otro servicio mediaProcessing en primer plano, a menos que el usuario haya llevado la app al primer plano (lo que restablece el temporizador). Si intentas iniciar otro servicio en primer plano mediaProcessing, el sistema arroja ForegroundServiceStartNotAllowedException con un mensaje de error como "Se agotó el tiempo límite para el tipo de servicio en primer plano mediaProcessing".
Para obtener más información sobre el tipo de servicio mediaProcessing, consulta Cambios en los tipos de servicios en primer plano para Android 15: Procesamiento de contenido multimedia.
Prueba
Para probar el comportamiento de tu app, puedes habilitar los tiempos de espera de procesamiento de contenido multimedia, incluso si tu app no está orientada a Android 15 (siempre que se ejecute en un dispositivo con Android 15). Para habilitar los tiempos de espera, ejecuta el siguiente comando adb:
adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name
También puedes ajustar el tiempo de espera para facilitar la prueba del comportamiento de tu app cuando se alcanza el límite. Para establecer un nuevo tiempo de espera, ejecuta el siguiente comando adb:
adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds
Restricciones para los receptores de emisión BOOT_COMPLETED que inician servicios en primer plano
Hay nuevas restricciones para los receptores de emisión de BOOT_COMPLETED que se lanzan
servicios en primer plano. Los receptores BOOT_COMPLETED no pueden iniciar los siguientes tipos de servicios en primer plano:
dataSynccameramediaPlaybackphoneCallmediaProjectionmicrophone(esta restricción se aplicó pormicrophonedesde el Android 14)
Si un receptor BOOT_COMPLETED intenta iniciar cualquiera de esos tipos de primer plano.
servicios, el sistema arroja una ForegroundServiceStartNotAllowedException.
Prueba
Para probar el comportamiento de tu app, puedes habilitar estas nuevas restricciones, incluso si tu app no está segmentada para Android 15 (siempre que la app se ejecute en un dispositivo con Android 15). Ejecuta el siguiente comando adb:
adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name
Para enviar una transmisión de BOOT_COMPLETED sin reiniciar el dispositivo, haz lo siguiente:
Ejecuta el siguiente comando adb:
adb shell am broadcast -a android.intent.action.BOOT_COMPLETED your-package-name
Restricciones para iniciar servicios en primer plano mientras una app tiene el permiso SYSTEM_ALERT_WINDOW
Anteriormente, si una app tenía el permiso SYSTEM_ALERT_WINDOW, podía iniciar un servicio en primer plano, incluso si la app estaba en segundo plano (como se explica en exenciones de las restricciones de inicio en segundo plano).
Si una app está orientada a Android 15, esta exención ahora es más limitada. Ahora, la app debe tener el permiso SYSTEM_ALERT_WINDOW y también tener una ventana superpuesta visible. Es decir, la app primero debe iniciar una ventana TYPE_APPLICATION_OVERLAY y la ventana debe ser visible antes de iniciar un servicio en primer plano.
Si tu app intenta iniciar un servicio en primer plano desde segundo plano sin cumplir con estos nuevos requisitos (y no tiene otra exención), el sistema arroja ForegroundServiceStartNotAllowedException.
Si tu app declara el permiso SYSTEM_ALERT_WINDOW y, luego, inicia servicios en primer plano desde el segundo plano, es posible que se vea afectada por este cambio. Si tu app obtiene una ForegroundServiceStartNotAllowedException, verifica el orden de operaciones de tu app y asegúrate de que ya tenga una ventana de superposición activa antes de intentar iniciar un servicio en primer plano desde el segundo plano. Puedes verificar si tu ventana de superposición es visible actualmente llamando a View.getWindowVisibility() o puedes anular View.onWindowVisibilityChanged() para recibir notificaciones cada vez que cambie la visibilidad.
Prueba
Para probar el comportamiento de tu app, puedes habilitar estas nuevas restricciones, incluso si tu app no está segmentada para Android 15 (siempre que la app se ejecute en un dispositivo con Android 15). Para habilitar estas nuevas restricciones para iniciar servicios en primer plano desde segundo plano, ejecuta el siguiente comando adb:
adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name
Cambios en el momento en que las apps pueden modificar el estado global del modo No interrumpir
Las apps que se orientan a Android 15 (nivel de API 35) y versiones posteriores ya no pueden cambiar el estado o la política globales de No interrumpir (ND) en un dispositivo (ya sea modificando la configuración del usuario o desactivando el modo ND). En su lugar, las apps deben contribuir con un AutomaticZenRule, que el sistema combina en una política global con el esquema existente de política más restrictiva. Las llamadas a las APIs existentes que antes afectaban el estado global (setInterruptionFilter, setNotificationPolicy) generan la creación o actualización de un AutomaticZenRule implícito, que se activa o desactiva según el ciclo de llamadas de esas llamadas a la API.
Ten en cuenta que este cambio solo afecta el comportamiento observable si la app llama a setInterruptionFilter(INTERRUPTION_FILTER_ALL) y espera que esa llamada desactive un AutomaticZenRule que sus propietarios activaron anteriormente.
Cambios en la API de OpenJDK
Android 15 continúa la tarea de actualizar las bibliotecas principales de Android para alinearlas con las funciones de las versiones más recientes de LTS de OpenJDK.
Algunos de estos cambios pueden afectar la compatibilidad de las apps que segmentan Android 15 (nivel de API 35):
Cambios en las APIs de formato de cadenas: La validación del índice de argumentos, las marcas, el ancho y la precisión ahora son más estrictos cuando se usan las siguientes APIs de
String.format()yFormatter.format():String.format(String, Object[])String.format(Locale, String, Object[])Formatter.format(String, Object[])Formatter.format(Locale, String, Object[])
Por ejemplo, se arroja la siguiente excepción cuando se usa un índice de argumento de 0 (
%0en la cadena de formato):IllegalFormatArgumentIndexException: Illegal format argument index = 0En este caso, el problema se puede solucionar usando un índice de argumento de 1 (
%1en la cadena de formato).Cambios en el tipo de componente de
Arrays.asList(...).toArray(): Cuando se usaArrays.asList(...).toArray(), el tipo de componente del array resultante ahora esObject, no el tipo de los elementos del array subyacente. Por lo tanto, el siguiente código arroja unClassCastException:String[] elements = (String[]) Arrays.asList("one", "two").toArray();En este caso, para conservar
Stringcomo el tipo de componente en el array resultante, puedes usarCollection.toArray(Object[]):String[] elements = Arrays.asList("two", "one").toArray(new String[0]);Cambios en el manejo de códigos de idioma: Cuando se usa la API de
Locale, los códigos de idioma para hebreo, yidis e indonesio ya no se convierten a sus formas obsoletas (hebreo:iw, yidis:jie indonesio:in). Cuando especifiques el código de idioma para una de estas configuraciones regionales, usa los códigos de ISO 639-1 (hebreo:he, yidis:yie indonesio:id).Cambios en las secuencias de números enteros aleatorios: Después de los cambios realizados en https://bugs.openjdk.org/browse/JDK-8301574, los siguientes métodos
Random.ints()ahora devuelven una secuencia de números diferente a la que devuelven los métodosRandom.nextInt():En general, este cambio no debería generar un comportamiento que interrumpa la app, pero tu código no debería esperar que la secuencia generada a partir de los métodos
Random.ints()coincida conRandom.nextInt().
La nueva API de SequencedCollection puede afectar la compatibilidad de tu app después de que actualices compileSdk en la configuración de compilación de tu app para usar Android 15 (nivel de API 35):
Colisión con las funciones de extensión
MutableList.removeFirst()yMutableList.removeLast()enkotlin-stdlibEl tipo
Listen Java se asigna al tipoMutableListen Kotlin. Debido a que las APIs deList.removeFirst()yList.removeLast()se introdujeron en Android 15 (nivel de API 35), el compilador de Kotlin resuelve las llamadas a funciones, por ejemplo,list.removeFirst(), de forma estática a las nuevas APIs deListen lugar de a las funciones de extensión enkotlin-stdlib.Si una app se vuelve a compilar con
compileSdkestablecido en35yminSdkestablecido en34o inferior, y luego se ejecuta en Android 14 y versiones anteriores, se arroja un error de tiempo de ejecución:java.lang.NoSuchMethodError: No virtual method removeFirst()Ljava/lang/Object; in class Ljava/util/ArrayList;La opción
NewApilint existente en el complemento de Android para Gradle puede detectar estos nuevos usos de la API../gradlew lintMainActivity.kt:41: Error: Call requires API level 35 (current min is 34): java.util.List#removeFirst [NewApi] list.removeFirst()Para corregir la excepción de tiempo de ejecución y los errores de lint, las llamadas a las funciones
removeFirst()yremoveLast()se pueden reemplazar porremoveAt(0)yremoveAt(list.lastIndex), respectivamente, en Kotlin. Si usas Android Studio Ladybug | 2024.1.3 o una versión posterior, también se proporciona una opción de corrección rápida para estos errores.Considera quitar
@SuppressLint("NewApi")ylintOptions { disable 'NewApi' }si se inhabilitó la opción de lint.Colisión con otros métodos en Java
Se agregaron métodos nuevos a los tipos existentes, por ejemplo,
ListyDeque. Es posible que estos métodos nuevos no sean compatibles con los métodos que tienen el mismo nombre y los mismos tipos de argumentos en otras interfaces y clases. En el caso de una colisión de firmas de métodos con incompatibilidad, el compilador dejavacgenera un error en el tiempo de compilación. Por ejemplo:Ejemplo de error 1:
javac MyList.javaMyList.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 ListEjemplo de error 2:
javac MyList.javaMyList.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 errorEjemplo de error 3:
javac MyList.javaMyList.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 errorPara corregir estos errores de compilación, la clase que implementa estas interfaces debe anular el método con un tipo de devolución compatible. Por ejemplo:
@Override public Object getFirst() { return List.super.getFirst(); }
Seguridad
Android 15 incluye cambios que promueven la seguridad del sistema para ayudar a proteger las apps y los usuarios de las apps maliciosas.
Versiones de TLS restringidas
Android 15 限制了对 TLS 版本 1.0 和 1.1 的使用。这些版本之前已在 Android 中被弃用，但现在不允许面向 Android 15 的应用使用。
Inicio seguro de actividades en segundo plano
Android 15 protege a los usuarios de apps maliciosas y les da más control sobre sus dispositivos agregando cambios que eviten que las apps llevar otras apps al primer plano, elevar sus privilegios y fomentar el abuso la interacción del usuario. Los inicios de actividades en segundo plano se restringieron desde Android 10 (nivel de API 29).
Otros cambios
Además de la restricción para la coincidencia de UID, estos otros cambios también se incluidos:
- Cambia los creadores de
PendingIntentpara que bloqueen los inicios de actividades en segundo plano de forma predeterminada. Esto ayuda a evitar que las apps creen accidentalmente unPendingIntentque personas malintencionadas podrían aprovechar. - No lleves una app al primer plano, a menos que el remitente de
PendingIntentlo permita. El objetivo de este cambio es evitar que las apps maliciosas abusen de la capacidad de iniciar actividades en segundo plano. De forma predeterminada, las apps no pueden llevar la pila de actividades al primer plano, a menos que el creador permita privilegios de inicio de actividad en segundo plano o que el remitente tenga privilegios de inicio de actividad en segundo plano. - Controla cómo la actividad principal de una pila de tareas puede finalizar su tarea. Si el botón una actividad principal finaliza una tarea, Android regresará a la tarea que se haya la última vez que estuvo activo. Además, si una actividad que no es de primer nivel finaliza su tarea, Android volverá a la pantalla principal y no bloqueará el final de esta actividad que no es de primer nivel.
- Evita iniciar actividades arbitrarias de otras apps en la tuya tarea. Este cambio evita que las apps maliciosas creen ataques de phishing a través de la creación actividades que parecen ser de otras aplicaciones.
- Bloquea las ventanas no visibles para que no se consideren en los inicios de la actividad en segundo plano. Esto ayuda a evitar que las apps maliciosas abusen de los inicios de actividad en segundo plano para mostrar contenido no deseado o malicioso a los usuarios.
Intents más seguros
Android 15 introduce nuevas medidas de seguridad opcionales para aumentar la seguridad de los intents y son más sólidos. El objetivo de estos cambios es evitar posibles vulnerabilidades y el uso inadecuado de intents que pueden aprovechar las apps maliciosas. Existen dos mejoras principales en la seguridad de los intents en Android 15:
- Coincidir con los filtros de intents de destino: Los intents que se orientan a componentes específicos deben coincidir con precisión con las especificaciones del filtro de intents del destino. Si envías un para iniciar la actividad de otra app, el componente del intent objetivo debe Se alinean con los filtros de intents declarados de la actividad receptora.
- Los intents deben tener acciones: Los intents sin una acción ya no coincidirán con ningún filtro de intents. Esto significa que los intents usados para iniciar actividades o servicios deben tener una acción claramente definida.
Para comprobar cómo responde tu app a estos cambios, usa
StrictMode en tu app. Para ver información
registros sobre infracciones de uso de Intent, agrega el siguiente método:
Kotlin
fun onCreate() { StrictMode.setVmPolicy(VmPolicy.Builder() .detectUnsafeIntentLaunch() .build() ) }
Java
public void onCreate() { StrictMode.setVmPolicy(new VmPolicy.Builder() .detectUnsafeIntentLaunch() .build()); }
Experiencia del usuario y la IU del sistema
Android 15 incluye algunos cambios que tienen como objetivo crear una experiencia del usuario más coherente e intuitiva.
Cambios en la inserción de ventana
Hay dos cambios relacionados con los insertos de ventana en Android 15: el modo de pantalla completa se aplica de forma predeterminada y también hay cambios de configuración, como la configuración predeterminada de las barras del sistema.
Aplicación de borde a borde
如果应用以 Android 15（API 级别 35）为目标平台，则在搭载 Android 15 的设备上默认以无边框显示。
这是一项重大变更，可能会对应用的界面产生负面影响。这些更改会影响以下界面区域：
- 手势柄导航栏
- 默认透明。
- 底部偏移量处于停用状态，因此内容会绘制在系统导航栏后面，除非应用了边衬区。
setNavigationBarColor和R.attr#navigationBarColor已被弃用，不会影响手势导航。setNavigationBarContrastEnforced和R.attr#navigationBarContrastEnforced继续对使用手势进行导航没有任何影响。
- “三按钮”导航
- 默认情况下，不透明度设置为 80%，颜色可能与窗口背景颜色一致。
- 底部偏移量处于停用状态，因此内容会绘制在系统导航栏后面，除非应用了边衬区。
- 默认情况下，
setNavigationBarColor和R.attr#navigationBarColor设置为与窗口背景相匹配。窗口背景必须是颜色可绘制对象，才能应用此默认值。此 API 已弃用，但仍会影响三按钮导航。 setNavigationBarContrastEnforced和R.attr#navigationBarContrastEnforced默认情况下为 true，这会在三按钮导航栏中添加 80% 不透明度的背景。
- 状态栏
- 默认透明。
- 顶部偏移量处于停用状态，因此内容会绘制在状态栏后面，除非应用了边衬区。
setStatusBarColor和R.attr#statusBarColor已被废弃，在 Android 15 上不起作用。setStatusBarContrastEnforced和R.attr#statusBarContrastEnforced已废弃，但仍会对 Android 15 产生影响。
- 刘海屏
- 非浮动窗口的
layoutInDisplayCutoutMode必须为LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS。SHORT_EDGES、NEVER和DEFAULT会被解读为ALWAYS，这样用户就不会看到因刘海屏而产生的黑条，并且应用会显示在屏幕边缘。
- 非浮动窗口的
以下示例展示了应用在以 Android 15（API 级别 35）为目标平台之前和之后，以及在应用边衬区之前和之后的效果。此示例并不全面，在 Android Auto 上可能会显示不同的内容。
如果应用已实现全屏显示，需要检查哪些方面
如果您的应用已实现全屏显示并应用边衬区，则除了以下情形外，您基本上不会受到影响。不过，即使您认为自己不受影响，我们仍建议您测试应用。
- 您有一个非浮动窗口，例如使用
SHORT_EDGES、NEVER或DEFAULT而不是LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS的Activity。如果您的应用在启动时崩溃，这可能是由启动画面引起的。您可以将核心启动画面依赖项升级到 1.2.0-alpha01 或更高版本，也可以设置window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always。 - 可能存在流量较低且界面被遮挡的屏幕。验证这些访问频率较低的界面是否没有被遮挡的界面。低流量界面包括：
- 初始配置或登录界面
- “设置”页面
如果您的应用尚未实现全屏显示，需要检查哪些方面
如果您的应用尚未实现全屏显示，则很可能会受到影响。除了已经实现全屏显示的 app 的场景之外，您还应考虑以下事项：
- 如果您的应用在 Compose 中使用 Material 3 组件 (
androidx.compose.material3)，例如TopAppBar、BottomAppBar和NavigationBar，这些组件很可能不会受到影响，因为它们会自动处理边衬区。 - 如果您的应用使用的是 Compose 中的 Material 2 组件 (
androidx.compose.material)，这些组件不会自动处理边衬区。不过，您可以获得边衬区的访问权限，然后手动应用边衬区。在 androidx.compose.material 1.6.0 及更高版本中，使用windowInsets参数可为BottomAppBar、TopAppBar、BottomNavigation和NavigationRail手动应用边衬区。 同样，请为Scaffold使用contentWindowInsets参数。 - 如果您的应用使用视图和 Material 组件 (
com.google.android.material)，则大多数基于视图的 Material 组件（例如BottomNavigationView、BottomAppBar、NavigationRailView或NavigationView）都会处理边衬区，因此不需要执行额外的操作。不过，如果使用的是AppBarLayout，则需要添加android:fitsSystemWindows="true"。 - 对于自定义可组合项，请手动应用边衬区作为内边距。如果您的内容位于
Scaffold内，则可以使用Scaffold内边距值来使用边衬区。否则，请使用WindowInsets之一应用内边距。 - 如果应用使用的是视图和
BottomSheet、SideSheet或自定义容器，请使用ViewCompat.setOnApplyWindowInsetsListener应用内边距。对于RecyclerView，请使用此监听器应用内边距，同时添加clipToPadding="false"。
如果您的应用必须提供自定义后台保护，您需要检查哪些方面
如果您的应用必须为三按钮导航或状态栏提供自定义背景保护，则应使用 WindowInsets.Type#tappableElement() 或 WindowInsets.Type#statusBars 将可组合项或视图放置在系统栏后面，以获取三按钮导航栏高度。
其他全屏显示资源
如需了解有关应用边衬区的其他注意事项，请参阅全屏视图和全屏 Compose 指南。
已弃用的 API
以下 API 已弃用，但未停用：
R.attr#enforceStatusBarContrastR.attr#navigationBarColor（适用于三按钮导航，透明度为 80%）Window#isStatusBarContrastEnforcedWindow#setNavigationBarColor（适用于三按钮导航，透明度为 80%）Window#setStatusBarContrastEnforced
以下 API 已弃用并停用：
R.attr#navigationBarColor（适用于手势导航）R.attr#navigationBarDividerColorR.attr#statusBarColorWindow#setDecorFitsSystemWindowsWindow#getNavigationBarColorWindow#getNavigationBarDividerColorWindow#getStatusBarColorWindow#setNavigationBarColor（适用于手势导航）Window#setNavigationBarDividerColorWindow#setStatusBarColor
Configuración estable
如果您的应用以 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()一直以这种方式运行。
El atributo elegantTextHeight tiene el valor predeterminado establecido en verdadero.
En el caso de las apps orientadas a Android 15 (nivel de API 35), el atributo elegantTextHeight TextView se convierte en true de forma predeterminada, lo que reemplaza la fuente compacta que se usa de forma predeterminada con algunas secuencias de comandos que tienen métricas verticales grandes por una que es mucho más legible.
La fuente compacta se introdujo para evitar que se rompan los diseños. Android 13 (nivel de API 33) evita muchos de estos daños, ya que permite que el diseño de texto estire la altura vertical con el atributo fallbackLineSpacing.
En Android 15, la fuente compacta aún permanece en el sistema, por lo que tu app puede establecer elegantTextHeight en false para obtener el mismo comportamiento que antes, pero es probable que no sea compatible con las próximas versiones. Por lo tanto, si tu app admite las siguientes secuencias de comandos: árabe, lao, birmano, tamil, guyaratí, canarés, malabar, odía, telugu o tailandés, configura elegantTextHeight como true para probarla.
elegantTextHeight para apps orientadas a Android 14 (nivel de API 34) y versiones anteriores.
elegantTextHeight para apps orientadas a Android 15.El ancho de TextView cambia para formas de letras complejas
En versiones anteriores de Android, algunas fuentes o idiomas en cursiva que tienen formas complejas podrían dibujar las letras en el área del carácter anterior o siguiente.
En algunos casos, esas letras se cortaron al principio o al final.
A partir de Android 15, un TextView asigna ancho para dibujar suficiente espacio para esas letras y permite que las apps soliciten paddings adicionales a la izquierda para evitar los recortes.
Como este cambio afecta la forma en que un TextView decide el ancho, TextView asigna más ancho de forma predeterminada si la app se orienta a Android 15 (nivel de API 35) o versiones posteriores. Para habilitar o inhabilitar este comportamiento, llama a la API de setUseBoundsForWidth en TextView.
Como agregar padding izquierdo puede causar un desajuste en los diseños existentes, el padding no se agrega de forma predeterminada, incluso en el caso de las apps orientadas a Android 15 o versiones posteriores.
Sin embargo, puedes agregar padding adicional para evitar el recorte llamando a setShiftDrawingOffsetForStartOverhang.
En los siguientes ejemplos, se muestra cómo estos cambios pueden mejorar el diseño de texto para algunas fuentes y algunos idiomas.
<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" />
Altura de línea predeterminada compatible con la configuración regional para EditText
En versiones anteriores de Android, el diseño de texto estiraba la altura del texto para que coincida con la altura de línea de la fuente que coincidía con la configuración regional actual. Por ejemplo, si el contenido estaba en japonés, la altura de la línea de la fuente japonesa es ligeramente mayor que la de una fuente latina, por lo que la altura del texto se hizo un poco más grande. Sin embargo, a pesar de estas diferencias en las alturas de las líneas, el elemento EditText tenía un tamaño uniforme, independientemente de la configuración regional que se usara, como se ilustra en la siguiente imagen:
EditText que pueden contener texto en inglés (en), japonés (ja) y birmano (my). La altura de EditText es la misma, a pesar de que estos lenguajes tienen alturas de línea diferentes entre sí.En el caso de las apps que se orientan a Android 15 (nivel de API 35), ahora se reserva una altura de línea mínima para EditText para que coincida con la fuente de referencia de la configuración regional especificada, como se muestra en la siguiente imagen:
EditText que pueden contener texto en inglés (en), japonés (ja) y birmano (my). La altura de EditText ahora incluye espacio para adaptarse a la altura de línea predeterminada de las fuentes de estos idiomas.Si es necesario, tu app puede restablecer el comportamiento anterior especificando el atributo useLocalePreferredLineHeightForMinimum en false, y puede establecer métricas verticales mínimas personalizadas con la API de setMinimumFontMetrics en Kotlin y Java.
Cámara y contenido multimedia
Android 15 realiza los siguientes cambios en el comportamiento de la cámara y los medios para las apps que se segmentan para Android 15 o versiones posteriores.
Restricciones para solicitar el foco de audio
Las apps que se orientan a Android 15 (nivel de API 35) deben ser la app principal o ejecutar un servicio en primer plano para solicitar el enfoque de audio. Si una app intenta solicitar el enfoque cuando no cumple con uno de estos requisitos, la llamada muestra AUDIOFOCUS_REQUEST_FAILED.
Puedes obtener más información sobre el enfoque de audio en Administra el enfoque de audio.
Actualización de restricciones que no pertenecen al SDK
Android 15 incluye listas actualizadas de este tipo de interfaces que están basadas en la colaboración con desarrolladores de Android y las pruebas internas más recientes. Siempre que sea posible, nos aseguramos de que las alternativas públicas estén disponibles antes de restringir las interfaces que no pertenecen al SDK.
Si tu app no está segmentada para Android 15, es posible que algunos de estos cambios no te afecten de inmediato. Sin embargo, si bien tu app puede acceder a algunas interfaces que no pertenecen al SDK según el nivel de API objetivo de tu app, usar cualquier método o campo que no pertenezca al SDK siempre implica un gran riesgo de error para tu app.
Si no sabes con seguridad si tu app usa este tipo de interfaces, puedes probarla para verificarlo. Si tu app depende de interfaces que no pertenecen al SDK, deberías planificar una migración hacia otras alternativas SDK. Sin embargo, sabemos que algunas apps tienen casos de uso válidos para usar interfaces que no pertenecen al SDK. Si no encuentras una alternativa al uso de una interfaz que no pertenece al SDK para una función de tu app, deberías solicitar una nueva API pública.
Para obtener más información sobre los cambios implementados en esta versión de Android, consulta Actualizaciones a las restricciones de interfaces que no pertenecen al SDK en Android 15. Para obtener más información sobre interfaces que no pertenecen al SDK en general, consulta Restricciones en interfaces que no pertenecen al SDK.