Cambios en el comportamiento: apps orientadas a Android 15 o versiones posteriores

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á orientada a 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 de comportamiento que afectan a todas las apps que se ejecutan en Android 15, independientemente de targetSdkVersion de la app.

Funcionalidad principal

Android 15 modifica o amplía varias funciones principales del sistema Android.

Cambios en los servicios en primer plano

We are making the following changes to foreground services with Android 15.

• Data sync foreground service timeout behavior
• New media processing foreground service type
• Restrictions on BOOT_COMPLETED broadcast receivers launching foreground services
• Restrictions on starting foreground services while an app holds the SYSTEM_ALERT_WINDOW permission

Data sync foreground service timeout behavior

Android 15 introduce un nuevo comportamiento de tiempo de espera en dataSync para las apps orientadas 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:

1. 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 a stopSelf() en unos pocos segundos. (Si no detienes la app de inmediato, el sistema genera una falla).
2. Asegúrate de que los servicios dataSync de 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).
3. Solo inicia los servicios en primer plano de dataSync como resultado de la interacción directa del usuario. Dado que tu app está en primer plano cuando se inicia el servicio, el servicio tiene seis horas completas después de que la app pasa a segundo plano.
4. 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

New media processing foreground service type

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:

1. 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 a stopSelf() en unos pocos segundos. (Si no detienes la app de inmediato, el sistema genera una falla).
2. Asegúrate de que los servicios mediaProcessing de 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).
3. Inicia servicios en primer plano de mediaProcessing solo 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.
4. 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

Restrictions on BOOT_COMPLETED broadcast receivers launching foreground services

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:

• dataSync
• camera
• mediaPlayback
• phoneCall
• mediaProjection
• microphone (esta restricción se aplicó por microphone desde 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

Restrictions on starting foreground services while an app holds the SYSTEM_ALERT_WINDOW permission

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

Se modificaron los momentos en que las apps pueden modificar el estado global del modo No interrumpir.

以 Android 15 为目标平台的应用无法再更改设备上的全局状态或勿扰 (DND) 政策（通过修改用户设置或关闭 DND 模式）。相反，应用必须提供一个 AutomaticZenRule，系统会将后者合并到一个具有现有最严格的政策胜出方案的全局政策中。调用之前影响全局状态的现有 API（setInterruptionFilter、setNotificationPolicy）会导致创建或更新隐式 AutomaticZenRule，该 AutomaticZenRule 根据这些 API 调用的调用周期而开启或关闭。

请注意，只有在应用调用 setInterruptionFilter(INTERRUPTION_FILTER_ALL) 且预期调用会停用之前由其所有者激活的 AutomaticZenRule 时，此变更才会影响可观察的行为。

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 orientadas a Android 15 (nivel de API 35):

• Cambios en las APIs de formato de cadenas: La validación del índice de argumentos, las marcas, la precisión y el ancho ahora es más estricta cuando se usan las siguientes APIs de String.format() y Formatter.format():

  • String.format(String, Object[])
  • String.format(Locale, String, Object[])
  • Formatter.format(String, Object[])
  • Formatter.format(Locale, String, Object[])

  Por ejemplo, se genera la siguiente excepción cuando se usa un índice de argumento de 0 (%0 en la cadena de formato):

  IllegalFormatArgumentIndexException: Illegal format argument index = 0
  

  En este caso, el problema se puede solucionar con un índice de argumento de 1 (%1 en la cadena de formato).

• Cambios en el tipo de componente de Arrays.asList(...).toArray(): Cuando se usa Arrays.asList(...).toArray(), el tipo de componente del array resultante ahora es Object, no el tipo de los elementos del array subyacente. Por lo tanto, el siguiente código arroja un ClassCastException:

  String[] elements = (String[]) Arrays.asList("one", "two").toArray();
  

  En este caso, para conservar String como el tipo de componente en el array resultante, puedes usar Collection.toArray(Object[]) en su lugar:

  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, yiddish e indonesio ya no se convierten a sus formas obsoletas (hebreo: iw, yiddish: ji e indonesio: in). Cuando especifiques el código de idioma de una de estas configuraciones regionales, usa los códigos de ISO 639-1 (hebreo: he, yiddish: yi e indonesio: id).

• Cambios en las secuencias de int aleatorias: Después de los cambios realizados en https://bugs.openjdk.org/browse/JDK-8301574, los siguientes métodos Random.ints() ahora muestran una secuencia de números diferente a la de los métodos Random.nextInt():

  • Random.ints(long)
  • Random.ints(long, int, int)
  • Random.ints(int, int)
  • Random.ints()

  Por lo general, este cambio no debería provocar 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 con Random.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() y MutableList.removeLast() en kotlin-stdlib

  El tipo List en Java se asigna al tipo MutableList en Kotlin. Debido a que las APIs de List.removeFirst() y List.removeLast() se introdujeron en Android 15 (nivel de API 35), el compilador de Kotlin resuelve las llamadas a función, por ejemplo, list.removeFirst(), de forma estática a las nuevas APIs de List en lugar de a las funciones de extensión en kotlin-stdlib.

  Si una app se vuelve a compilar con compileSdk establecido en 35 y minSdk establecido en 34 o una versión anterior, y luego se ejecuta en Android 14 y versiones anteriores, se genera 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 de lint NewApi existente en el complemento de Android para Gradle puede detectar estos nuevos usos de la API.

  ./gradlew lint
  
  MainActivity.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() y removeLast() se pueden reemplazar por removeAt(0) y removeAt(list.lastIndex), respectivamente, en Kotlin. Si usas Android Studio Ladybug | 2024.1.3 o versiones posteriores, también proporciona una opción de solución rápida para estos errores.

  Considera quitar @SuppressLint("NewApi") y lintOptions { disable 'NewApi' } si se inhabilitó la opción lint.

• Colisión con otros métodos en Java

  Se agregaron métodos nuevos a los tipos existentes, por ejemplo, List y Deque. 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 firma de método con incompatibilidad, el compilador javac muestra un error de tiempo de compilación. Por ejemplo:

  Ejemplo de 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 List
  

  Ejemplo de 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 error
  

  Ejemplo de 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 error
  

  Para corregir estos errores de compilación, la clase que implementa estas interfaces debe reemplazar 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 a las apps y a los usuarios de las apps maliciosas.

Inicios de actividades en segundo plano seguros

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. Se restringieron los inicios de actividades en segundo plano desde Android 10 (nivel de API 29)

Impedir que se inicien actividades las apps que no coincidan con el UID superior de la pila

Las apps maliciosas pueden iniciar la actividad de otra app dentro de la misma tarea y, luego, se superponen para crear la ilusión de ser esa aplicación. Esta "tarea usurpación" este ataque elude las restricciones actuales de inicio en segundo plano ocurre dentro de la misma tarea visible. Para mitigar este riesgo, Android 15 agrega un marca que impide que se inicien las apps que no coinciden con el UID superior de la pila de datos. Para aceptar todas las actividades de tu app, actualiza la allowCrossUidActivitySwitchFromBelow en el archivo AndroidManifest.xml de tu app:

<application android:allowCrossUidActivitySwitchFromBelow="false" >

Las nuevas medidas de seguridad estarán activas si se cumplen todas las condiciones que figuran a continuación:

• La app que realiza el lanzamiento está orientada a Android 15.
• La app que está sobre la pila de tareas se orienta a Android 15.
• Toda actividad visible se haya habilitado para las nuevas protecciones

Si las medidas de seguridad están habilitadas, las apps podrían regresar a la página principal, en lugar de la última app visible, si terminan sus propias tareas.

Otros cambios

Además de la restricción para la coincidencia de UID, estos otros cambios también incluidos:

• Cambia a PendingIntent creadores para que bloqueen los lanzamientos de actividades en segundo plano de la siguiente manera: predeterminada. Esto ayuda a evitar que las apps creen accidentalmente PendingIntent que podrían ser abusadas por agentes maliciosos.
• No lleves una app al primer plano, a menos que sea el remitente de PendingIntent. lo permite. El objetivo de este cambio es evitar que apps maliciosas abusen de los capacidad para iniciar actividades en segundo plano. De forma predeterminada, las apps no llevar la pila de tareas al primer plano, a menos que el creador permita privilegios de inicio de la actividad en segundo plano o si el remitente tiene actividad en segundo plano iniciar privilegios.
• 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 principal finaliza su tarea, Android vuelve a la pantalla de inicio, no bloqueará el acabado de este no superior actividad.
• 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.
• Bloquear ventanas no visibles para que no se consideren para la actividad en segundo plano inicio de sesión. Esto ayuda a evitar que apps maliciosas abusen de los recursos en segundo plano se inicia actividad para mostrar contenido malicioso o no deseado a los usuarios.

Intents más seguros

Android 15 引入了新的可选安全措施，以提高 intent 的安全性和稳健性。这些变更旨在防止潜在的漏洞以及恶意应用可能利用的 intent 滥用行为。Android 15 对 intent 的安全性进行了两项主要改进：

• 与目标 intent 过滤器匹配：定位到特定组件的 intent 必须与目标的 intent 过滤器规范完全匹配。如果您发送 intent 来启动其他应用的 activity，目标 intent 组件需要与接收 activity 声明的 intent 过滤器保持一致。
• intent 必须具有操作：没有操作的 intent 将不再与任何 intent 过滤器匹配。这意味着，用于启动 activity 或服务的 intent 必须具有明确定义的操作。

如需检查您的应用对这些更改的响应方式，请在应用中使用 StrictMode。如需查看有关 Intent 使用违规行为的详细日志，请添加以下方法：

fun onCreate() {
    StrictMode.setVmPolicy(VmPolicy.Builder()
        .detectUnsafeIntentLaunch()
        .build()
    )
}

public void onCreate() {
    StrictMode.setVmPolicy(new VmPolicy.Builder()
            .detectUnsafeIntentLaunch()
            .build());
}

Experiencia del usuario y IU del sistema

Android 15 incluye algunos cambios que tienen como objetivo crear una experiencia del usuario más intuitiva y coerente.

Cambios en la inserción de ventana

Hay dos cambios relacionados con las inserciones de ventana en Android 15: de borde a borde 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

Las apps son de borde a borde de forma predeterminada en dispositivos que ejecutan Android 15 si se orientan a Android 15 (nivel de API 35).

Este es un cambio rotundo que podría afectar de forma negativa la IU de tu app. Los cambios afectan las siguientes áreas de la IU:

• Barra de navegación con control de gestos
  • Es transparente de forma predeterminada.
  • El desplazamiento inferior está inhabilitado, por lo que el contenido se dibuja detrás de la barra de navegación del sistema, a menos que se apliquen las inserciones.
  • setNavigationBarColor y R.attr#navigationBarColor dejaron de estar disponibles y no afectan la navegación por gestos.
  • setNavigationBarContrastEnforced y R.attr#navigationBarContrastEnforced siguen sin tener efecto en la navegación por gestos.
• Navegación con 3 botones
  • La opacidad está configurada en un 80% de forma predeterminada, y el color puede coincidir con el fondo de la ventana.
  • Se inhabilitó el desplazamiento inferior para que el contenido se dibuje detrás de la barra de navegación del sistema, a menos que se apliquen inserciones.
  • setNavigationBarColor y R.attr#navigationBarColor se configuran para que coincidan con el fondo de la ventana de forma predeterminada. El fondo de la ventana debe ser un elemento de diseño de color para que se aplique este valor predeterminado. Esta API dejó de estar disponible, pero sigue afectando la navegación de 3 botones.
  • setNavigationBarContrastEnforced y R.attr#navigationBarContrastEnforced son verdaderos de forma predeterminada, lo que agrega un fondo opaco del 80% en la navegación con 3 botones.
• Barra de estado
  • Es transparente de forma predeterminada.
  • El desplazamiento superior está inhabilitado para que el contenido se dibuje detrás de la barra de estado, a menos que se apliquen inserciones.
  • setStatusBarColor y R.attr#statusBarColor dejaron de estar disponibles y no tienen ningún efecto en Android 15.
  • setStatusBarContrastEnforced y R.attr#statusBarContrastEnforced dejaron de estar disponibles, pero aún tienen un efecto en Android 15.
• Recorte de la pantalla
  • layoutInDisplayCutoutMode de las ventanas no flotantes debe ser LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. SHORT_EDGES, NEVER y DEFAULT se interpretan como ALWAYS para que los usuarios no vean una barra negra causada por el corte de la pantalla y se muestren de borde a borde.

En el siguiente ejemplo, se muestra una app antes y después de orientarla a Android 15 (nivel de API 35), así como antes y después de aplicar las inserciones.

Qué verificar si tu app ya es de borde a borde

Si tu app ya es de borde a borde y aplica inserciones, tu mayor parte no será afectada, excepto en las siguientes situaciones. Sin embargo, incluso si crees que no te afectará, te recomendamos que pruebes tu app.

• Tienes una ventana no flotante, como una Activity que usa SHORT_EDGES, NEVER o DEFAULT en lugar de LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. Si tu app falla durante el inicio, es posible que se deba a la pantalla de presentación. Puedes actualizar la dependencia de splashscreen principal a 1.2.0-alpha01 o una versión posterior, o bien establecer window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always.
• Puede haber pantallas con menos tráfico y una IU ocluida. Verifica que estas pantallas menos visitadas no tengan una IU ocluida. Entre las pantallas con menos tráfico, se incluyen las siguientes:
  • Pantallas de integración o acceso
  • Páginas de configuración

Qué verificar si tu app aún no es de borde a borde

Si tu app aún no es de borde a borde, es probable que se vea afectada. Además de las situaciones de las apps que ya son de borde a borde, debes tener en cuenta lo siguiente:

• Si tu app usa componentes de Material 3 (androidx.compose.material3) en Compose, como TopAppBar, BottomAppBar y NavigationBar, es probable que estos componentes no se vean afectados porque controlan automáticamente las inserciones.
• Si tu app usa componentes de Material 2 (androidx.compose.material) en Compose, estos no controlan las inserciones automáticamente. Sin embargo, puedes obtener acceso a las inserciones y aplicarlas manualmente. En androidx.compose.material 1.6.0 y versiones posteriores, usa el parámetro windowInsets para aplicar las inserciones de forma manual para BottomAppBar, TopAppBar, BottomNavigation y NavigationRail. De la misma manera, usa el parámetro contentWindowInsets para Scaffold.
• Si tu app usa vistas y componentes de Material (com.google.android.material), la mayoría de los componentes de Material basados en vistas, como BottomNavigationView, BottomAppBar, NavigationRailView o NavigationView, controlan las inserciones y no requieren trabajo adicional. Sin embargo, debes agregar android:fitsSystemWindows="true" si usas AppBarLayout.
• Para los elementos componibles personalizados, aplica las inserciones de forma manual como relleno. Si tu contenido está dentro de un Scaffold, puedes consumir inserciones con los valores de padding Scaffold. De lo contrario, aplica el padding con uno de los WindowInsets.
• Si tu app usa vistas y BottomSheet, SideSheet o contenedores personalizados, aplica relleno con ViewCompat.setOnApplyWindowInsetsListener. Para RecyclerView, aplica padding con este objeto de escucha y, además, agrega clipToPadding="false".

Qué verifica si tu app debe ofrecer protección personalizada de fondo

Si tu app debe ofrecer una protección personalizada en segundo plano para la navegación con 3 botones o la barra de estado, debería colocar un elemento componible o una vista detrás de la barra del sistema con WindowInsets.Type#tappableElement() para obtener la altura de la barra de navegación de 3 botones o WindowInsets.Type#statusBars.

Recursos adicionales de borde a borde

Consulta las guías Views de borde a borde y Compose de borde a borde para obtener más información sobre la aplicación de inserciones.

APIs obsoletas

Las siguientes APIs dejaron de estar disponibles, pero no están inhabilitadas:

• R.attr#enforceStatusBarContrast
• R.attr#navigationBarColor (para la navegación con 3 botones, con un 80% de alfa)
• Window#isStatusBarContrastEnforced
• Window#setNavigationBarColor (para la navegación con 3 botones, con un 80% de alfa)
• Window#setStatusBarContrastEnforced

Las siguientes APIs dejaron de estar disponibles y están inhabilitadas:

• R.attr#navigationBarColor (para la navegación por gestos)
• R.attr#navigationBarDividerColor
• R.attr#statusBarColor
• Window#setDecorFitsSystemWindows
• Window#getNavigationBarColor
• Window#getNavigationBarDividerColor
• Window#getStatusBarColor
• Window#setNavigationBarColor (para la navegación por gestos)
• Window#setNavigationBarDividerColor
• Window#setStatusBarColor

Configuración estable

Si tu app está orientada a Android 15 (nivel de API 35) o versiones posteriores, Configuration ya no excluye las barras del sistema. Si usas el tamaño de pantalla en la clase Configuration para el cálculo del diseño, debes reemplazarlo por mejores alternativas, como un ViewGroup, WindowInsets o WindowMetricsCalculator apropiados según tus necesidades.

Configuration está disponible desde la API 1. Por lo general, se obtiene de Activity.onConfigurationChanged. Proporciona información como la densidad, orientación y tamaño de la ventana. Una característica importante de los tamaños de ventana que se muestran desde Configuration es que anteriormente excluía las barras del sistema.

El tamaño de configuración suele usarse para la selección de recursos, como /res/layout-h500dp, y este sigue siendo un caso de uso válido. Sin embargo, siempre se desaconsejó su uso para el cálculo del diseño. Si es así, debes alejarte ahora. Debes reemplazar el uso de Configuration por algo más adecuado según tu caso de uso.

Si lo usas para calcular el diseño, usa un ViewGroup adecuado, como CoordinatorLayout o ConstraintLayout. Si lo usas para determinar la altura de la barra de navegación del sistema, usa WindowInsets. Si quieres conocer el tamaño actual de la ventana de tu app, usa computeCurrentWindowMetrics.

En la siguiente lista, se describen los campos que se verán afectados por este cambio:

• Los tamaños Configuration.screenWidthDp y screenHeightDp ya no excluyen las barras del sistema.
• Configuration.smallestScreenWidthDp se ve afectado indirectamente por los cambios en screenWidthDp y screenHeightDp.
• Configuration.orientation se ve afectado indirectamente por los cambios en screenWidthDp y screenHeightDp en dispositivos cercanos al cuadrado.
• Display.getSize(Point) se ve afectado indirectamente por los cambios en Configuration. Este elemento dejó de estar disponible a partir del nivel de API 30.
• Display.getMetrics() ya funciona de esta manera desde el nivel de API 33.

El atributo eleganteTextHeight se establece en verdadero de forma predeterminada

For apps targeting Android 15 (API level 35), the elegantTextHeight TextView attribute becomes true by default, replacing the compact font used by default with some scripts that have large vertical metrics with one that is much more readable. The compact font was introduced to prevent breaking layouts; Android 13 (API level 33) prevents many of these breakages by allowing the text layout to stretch the vertical height utilizing the fallbackLineSpacing attribute.

In Android 15, the compact font still remains in the system, so your app can set elegantTextHeight to false to get the same behavior as before, but it is unlikely to be supported in upcoming releases. So, if your app supports the following scripts: Arabic, Lao, Myanmar, Tamil, Gujarati, Kannada, Malayalam, Odia, Telugu or Thai, test your app by setting elegantTextHeight to true.

Cambios en el ancho de TextView 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.

Diseño estándar para texto en inglés en una fuente cursiva. Algunas de las letras están cortadas. Este es el XML correspondiente:

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

Diseño para el mismo texto en inglés con ancho y padding adicionales. Este es el XML correspondiente:

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

Diseño estándar para texto tailandés. Algunas de las letras están cortadas. Este es el XML correspondiente:

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

Diseño para el mismo texto tailandés con ancho y padding adicionales. Este es el XML correspondiente:

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

Altura de línea predeterminada de la configuración regional para EditText

在以前的 Android 版本中，文本布局拉伸了文本的高度，使其适应与当前语言区域匹配的字体的行高。例如，如果内容是日语，由于日语字体的行高比拉丁字体的行高略大，因此文本的高度就略大了。不过，尽管行高存在这些差异，但无论使用何种语言区域，EditText 元素的大小都是一致的，如下图所示：

对于以 Android 15 为目标平台的应用，系统现在会为 EditText 预留最小行高，以匹配指定语言区域的参考字体，如下图所示：

如果需要，您的应用可以通过将 useLocalePreferredLineHeightForMinimum 属性设置为 false 来恢复之前的行为，并且可以通过 Kotlin 和 Java 中的 setMinimumFontMetrics API 设置自定义最小行业指标。

Cámara y contenido multimedia

Android 15 realiza los siguientes cambios en el comportamiento de la cámara y el contenido multimedia para las apps orientadas a Android 15 o versiones posteriores.

Restricciones para solicitar el foco de audio

Las apps orientadas a Android 15 deben ser la app principal o que ejecuten un servicio en primer plano para solicitar foco de audio. Si una app intenta solicitar el foco cuando no cumple con uno de estos requisitos, la llamada mostrará AUDIOFOCUS_REQUEST_FAILED.

Puedes obtener más información sobre el foco de audio en Cómo administrar el foco de audio.

Actualización de restricciones que no pertenecen al SDK

Android 15 包含更新后的受限非 SDK 接口列表（基于与 Android 开发者之间的协作以及最新的内部测试）。在限制使用非 SDK 接口之前，我们会尽可能确保有可用的公开替代方案。

如果您的应用并非以 Android 15 为目标平台，其中一些变更可能不会立即对您产生影响。不过，尽管您的应用可能会根据应用的目标 API 级别访问某些非 SDK 接口，但只要您使用任何非 SDK 方法或字段，终归存在导致应用出问题的显著风险。

如果您不确定自己的应用是否使用了非 SDK 接口，则可以测试该应用，进行确认。如果您的应用依赖于非 SDK 接口，您应该开始计划迁移到 SDK 替代方案。不过，我们知道某些应用具有使用非 SDK 接口的有效用例。如果您无法为应用中的某项功能找到使用非 SDK 接口的替代方案，则应请求新的公共 API。

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.