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 en el 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 expande varias funciones 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_COMPLETED que 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（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]"

注意 ：6 小时的时间限制由应用的所有 dataSync 前台服务共享。例如，如果应用运行 dataSync 服务四小时，然后启动其他 dataSync 服务，则第二个服务将只能运行两小时。不过，如果用户将应用调到前台，计时器会重置，并且应用将有 6 小时的可用时间。

为避免因行为变更而导致问题，您可以执行以下一项或多项操作：

1. 让您的服务实现新的 Service.onTimeout(int, int) 方法。当您的应用收到回调时，请务必在几秒钟内调用 stopSelf()。（如果您不立即停止应用，系统会生成故障。）
2. 确保应用的 dataSync 服务在任何 24 小时内总运行时间不超过 6 小时（除非用户与应用互动，重置计时器）。
3. 仅通过直接的用户互动来启动 dataSync 前台服务；由于您的应用在服务启动时位于前台，因此服务会在应用进入后台后的 6 小时内完整运行。
4. 请改用替代 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

Nuevo tipo de servicio en primer plano de procesamiento de contenido multimedia

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]"

注意 ：6 小时的时间限制由应用的所有mediaProcessing前台服务共享。例如，如果应用运行 mediaProcessing 服务四小时，然后启动其他 mediaProcessing 服务，则第二个服务将只能运行两小时。不过，如果用户将应用调到前台，计时器会重置，并且应用将有 6 小时的可用时间。

为避免出现此异常，您可以执行以下任一操作：

1. 让您的服务实现新的 Service.onTimeout(int, int) 方法。当您的应用收到回调时，请务必在几秒钟内调用 stopSelf()。（如果您未立即停止应用，系统会生成失败情况。）
2. 确保应用的 mediaProcessing 服务在任何 24 小时内总运行时间不超过 6 小时（除非用户与应用互动，重置计时器）。
3. 仅在有直接用户互动时启动 mediaProcessing 前台服务；由于服务启动时应用位于前台，因此您的服务在应用进入后台后有完整的 6 小时时间。
4. 请改用 替代 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

Restricciones para los receptores de emisión BOOT_COMPLETED que inician servicios en primer plano

在启动 BOOT_COMPLETED 广播接收器方面存在新限制 前台服务。BOOT_COMPLETED 接收器不能启动 以下类型的前台服务：

• dataSync
• camera
• mediaPlayback
• phoneCall
• mediaProjection
• microphone（自 Android 14 起，microphone 就受到此限制）

如果 BOOT_COMPLETED 接收器尝试启动任何上述类型的前台 服务，系统会抛出 ForegroundServiceStartNotAllowedException。

测试

如需测试应用的行为，您可以启用这些新限制，即使您的应用并未以 Android 15 为目标平台（只要应用在 Android 15 设备上运行）也是如此。运行以下 adb 命令：

adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name

如需在不重启设备的情况下发送 BOOT_COMPLETED 广播，请运行以下 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 将继续更新 Android 的核心库，以与最新 OpenJDK LTS 版本中的功能保持一致。

其中一些变更可能会影响以 Android 15（API 级别 35）为目标平台的应用兼容性：

• 对字符串格式化 API 进行了更改：现在，在使用以下 String.format() 和 Formatter.format() API 时，对参数索引、标志、宽度和精度的验证要求变得更加严格：

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

  例如，如果使用参数索引 0（格式字符串中的 %0），则会抛出以下异常：

  IllegalFormatArgumentIndexException: Illegal format argument index = 0
  

  在这种情况下，可以通过使用实参索引 1（格式字符串中的 %1）来解决此问题。

• Arrays.asList(...).toArray() 的组件类型发生变化：使用 Arrays.asList(...).toArray() 时，生成的数组的组件类型现在是 Object，而不是底层数组元素的类型。因此，以下代码会抛出 ClassCastException：

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

  在这种情况下，为了在生成的数组中保留 String 作为组件类型，您可以改用 Collection.toArray(Object[])：

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

• 语言代码处理方式变更：使用 Locale API 时，希伯来语、意第绪语和印度尼西亚语的语言代码不再转换为其过时形式（希伯来语：iw，意第绪语：ji，印度尼西亚语：in）。为这些语言区域之一指定语言代码时，请改用 ISO 639-1 中的代码（希伯来语：he，意第绪语：yi，印度尼西亚语：id）。

• 对随机 int 序列的更改：在 https://bugs.openjdk.org/browse/JDK-8301574 中做出更改后，以下 Random.ints() 方法现在返回的数字序列与 Random.nextInt() 方法不同：

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

  通常，此更改不会导致应用行为异常，但您的代码不应期望从 Random.ints() 方法生成的序列与 Random.nextInt() 匹配。

当您在应用的 build 配置中将 compileSdk 更新为使用 Android 15（API 级别 35）后，新的 SequencedCollection API 可能会影响应用的兼容性：

• 与 kotlin-stdlib 中的 MutableList.removeFirst() 和 MutableList.removeLast() 扩展函数冲突

  Java 中的 List 类型会映射到 Kotlin 中的 MutableList 类型。 由于 List.removeFirst() 和 List.removeLast() API 已在 Android 15（API 级别 35）中引入，因此 Kotlin 编译器会将函数调用（例如 list.removeFirst()）静态解析为新的 List API，而不是 kotlin-stdlib 中的扩展函数。

  如果应用在重新编译时将 compileSdk 设为 35，将 minSdk 设为 34 或更低，然后在 Android 14 及更低版本上运行，则会抛出运行时错误：

  java.lang.NoSuchMethodError: No virtual method
  removeFirst()Ljava/lang/Object; in class Ljava/util/ArrayList;
  

  Android Gradle 插件中的现有 NewApi lint 选项可以捕获这些新的 API 用法。

  ./gradlew lint
  
  MainActivity.kt:41: Error: Call requires API level 35 (current min is 34): java.util.List#removeFirst [NewApi]
        list.removeFirst()
  

  如需修复运行时异常和 lint 错误，可以在 Kotlin 中分别将 removeFirst() 和 removeLast() 函数调用替换为 removeAt(0) 和 removeAt(list.lastIndex)。如果您使用的是 Android Studio Ladybug | 2024.1.3 或更高版本，它还提供了针对这些错误的快速修复选项。

  如果 lint 选项已被停用，请考虑移除 @SuppressLint("NewApi") 和 lintOptions { disable 'NewApi' }。

• 与 Java 中的其他方法冲突

  现有类型中添加了新方法，例如 List 和 Deque。这些新方法可能与其他接口和类中具有相同名称和参数类型的方法不兼容。如果方法签名冲突且不兼容，javac 编译器会输出构建时错误。例如：

  错误示例 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
  

  错误示例 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
  

  错误示例 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
  

  如需修复这些构建错误，实现这些接口的类应使用兼容的返回值类型替换该方法。例如：

  @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 a los usuarios de apps maliciosas.

Versiones de TLS restringidas

Android 15 restringe el uso de las versiones 1.0 y 1.1 de TLS. Estas versiones ya habían dejado de estar disponibles en Android, pero ahora no se permiten para las apps que se orientan a Android 15.

Lanzamientos de actividades en segundo plano protegidos

Android 15 protege a los usuarios de las apps maliciosas y les brinda más control sobre sus dispositivos, ya que agrega cambios que impiden que las apps maliciosas en segundo plano lleven otras apps al primer plano, eleven sus privilegios y abusen de la interacción del usuario. Los inicios de actividad en segundo plano están restringidos desde Android 10 (nivel de API 29).

Otros cambios

• Cambia los creadores de PendingIntent para bloquear los inicios de actividad en segundo plano de forma predeterminada. Esto ayuda a evitar que las apps creen accidentalmente un objeto PendingIntent que podría ser utilizado de forma abusiva por agentes maliciosos.
• No pases una app al primer plano, a menos que el remitente PendingIntent lo 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 tareas a primer plano, a menos que el creador permita privilegios de inicio de actividad en segundo plano o el remitente tenga privilegios de inicio de actividad en segundo plano.
• Controla cómo la actividad superior de una pila de tareas puede finalizar su tarea. Si la actividad superior finaliza una tarea, Android volverá a la tarea que estuvo activa por última vez. Además, si una actividad que no está en primer plano finaliza su tarea, Android volverá a la pantalla principal y no bloqueará la finalización de esta actividad que no está en primer plano.
• Evita iniciar actividades arbitrarias desde otras apps en tu propia tarea. Este cambio evita que las apps maliciosas realicen phishing a los usuarios creando actividades que parecen ser de otras apps.
• Bloquea las ventanas no visibles para que no se consideren para los inicios de 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 StrictMode para intents.

Para ver registros detallados sobre los incumplimientos del uso de Intent, usa 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

Android 15 中与窗口内边距相关的两项变更：默认强制执行边到边，此外还有配置变更，例如系统栏的默认配置。

Aplicación de borde a borde

Las apps se muestran de borde a borde de forma predeterminada en los dispositivos que ejecutan Android 15 si la app se orienta a Android 15 (nivel de API 35).

Importante: Si tu app aún no es de borde a borde, es posible que algunas partes de ella queden ocultas y debas controlar las inserciones. Según la app, este trabajo puede ser significativo o no. El componente Scaffold de Material 3 puede reducir el trabajo necesario para que sea compatible con la aplicación de la función de borde a borde de Android 15.

Una app que se orienta a Android 14 y no es de borde a borde en un dispositivo con Android 15.

Una app que se orienta a Android 15 (nivel de API 35) y se muestra de borde a borde en un dispositivo con Android 15. Esta app usa principalmente componentes de Compose de Material 3 que aplican inserciones automáticamente. Esta pantalla no se ve afectada de forma negativa por la aplicación de medidas de borde a borde de Android 15.

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 controlador 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 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 se establece 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 está obsoleta, pero sigue afectando la navegación con 3 botones.
  • setNavigationBarContrastEnforced y R.attr#navigationBarContrastEnforced es verdadero 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, por lo que el contenido se dibuja 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 efecto en Android 15.
  • setStatusBarContrastEnforced y R.attr#statusBarContrastEnforced dejaron de estar disponibles, pero aún tienen efecto en Android 15.
• Corte de pantalla
  • El 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 pantalla y aparezcan de borde a borde.

En el siguiente ejemplo, se muestra una app antes y después de orientarse a Android 15 (nivel de API 35), y antes y después de aplicar inserciones. Este ejemplo no es exhaustivo, por lo que podría aparecer de manera diferente en Android Auto.

Una app orientada a Android 14 que no se muestra de borde a borde en un dispositivo con Android 15.

Una app que se orienta a Android 15 (nivel de API 35) y se muestra de borde a borde en un dispositivo con Android 15. Sin embargo, muchos elementos ahora están ocultos por la barra de estado, la barra de navegación de 3 botones o el corte de pantalla debido a las aplicaciones de medidas por incumplimiento de borde a borde de Android 15. La IU oculta incluye la barra superior de la app de Material 2, los botones de acción flotantes y los elementos de lista.

Una app que se orienta a Android 15 (nivel de API 35) se muestra de borde a borde en un dispositivo con Android 15 y aplica inserciones para que no se oculte la IU.

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

Si tu app ya es de borde a borde y aplica inserciones, en su mayoría no se verá afectada, excepto en las siguientes situaciones. Sin embargo, incluso si crees que no te afecta, 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 cuando se inicia, es posible que se deba a la pantalla de presentación. Puedes actualizar la dependencia core splashscreen a 1.2.0-alpha01 o una versión posterior, o bien establecer window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always.
• Es posible que haya pantallas con menos tráfico y con la IU bloqueada. Verifica que estas pantallas menos visitadas no tengan una IU ocluida. Las pantallas con menos tráfico incluyen las siguientes:
  • Pantallas de incorporació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 muy probable que se vea afectada. Además de las situaciones para 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, ya que controlan las inserciones automáticamente.
• Si tu app usa componentes de Material 2 (androidx.compose.material) en Compose, estos no controlan las inserciones de forma automática. 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, tendrás que agregar android:fitsSystemWindows="true" si se usa AppBarLayout.
• En el caso de los elementos componibles personalizados, aplica las inserciones de forma manual como padding. Si tu contenido está dentro de un Scaffold, puedes consumir inserciones con los valores de padding de Scaffold. De lo contrario, aplica 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 relleno con este objeto de escucha y también agrega clipToPadding="false".

Qué verificar si tu app debe ofrecer protección personalizada en segundo plano

Si tu app debe ofrecer protección personalizada en segundo plano para la navegación con 3 botones o la barra de estado, debe 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 con 3 botones o WindowInsets.Type#statusBars.

Recursos adicionales de borde a borde

Consulta las guías Vistas de borde a borde y Compose de borde a borde para obtener consideraciones adicionales sobre la aplicación de inserciones.

API obsoletas

Las siguientes APIs dejaron de estar disponibles, pero no se inhabilitaron:

• 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 están obsoletas y se inhabilitaron:

• 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 se orienta a Android 15 (nivel de API 35) o versiones posteriores, Configuration ya no excluye las barras del sistema. Si usas el tamaño de la pantalla en la clase Configuration para el cálculo del diseño, debes reemplazarlo por mejores alternativas, como un ViewGroup, WindowInsets o WindowMetricsCalculator apropiado, 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, la orientación y los tamaños de la ventana. Una característica importante de los tamaños de ventana que devuelve Configuration es que antes excluía las barras del sistema.

El tamaño de la configuración se suele usar 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í, deberías alejarte de ella 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 afectados por este cambio:

• Los tamaños Configuration.screenWidthDp y screenHeightDp ya no excluyen las barras del sistema.
• Configuration.smallestScreenWidthDp se ve afectado de forma indirecta por los cambios en screenWidthDp y screenHeightDp.
• Configuration.orientation se ve afectado de forma indirecta por los cambios en screenWidthDp y screenHeightDp en dispositivos casi cuadrados.
• Display.getSize(Point) se ve afectado de forma indirecta por los cambios en Configuration. Este atributo 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 elegantTextHeight se establece de forma predeterminada 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.

Comportamiento de elegantTextHeight para apps orientadas a Android 14 (nivel de API 34) y versiones anteriores.

Comportamiento de elegantTextHeight para apps orientadas a Android 15.

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 con reconocimiento de 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:

Tres cuadros que representan elementos 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:

Tres cuadros que representan elementos 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 el contenido multimedia para las apps que se orientan a 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 interfaces no SDK restringidas 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á orientada a Android 15, es posible que algunos de estos cambios no te afecten de inmediato. Sin embargo, aunque es posible que tu app acceda a algunas interfaces que no pertenecen al SDK según el nivel de API objetivo de la app, usar cualquier método o campo que no pertenezca al SDK siempre implica un gran riesgo de error para la app.

En caso de no saber con certeza si tu app usa este tipo de interfaces, puedes probarla para verificarlo. Si tu app depende de interfaces que no pertenezcan al SDK, deberías planificar una migración hacia otras alternativas que sí lo hagan. Sin embargo, sabemos que algunas apps tienen casos de uso válidos para usarlas. 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.