¡Te damos la bienvenida a la Vista previa para desarrolladores de Android 13! Envíanos tus comentarios y ayúdanos a hacer de Android 13 la mejor versión hasta el momento.

Cambios en el marco de compatibilidad (Android 13)

Figura 1: La pantalla Cambios de compatibilidad con apps de las opciones para desarrolladores muestra los cambios que puedes activar o desactivar.

En esta página, se describen los cambios que se pueden activar o desactivar y que forman parte del marco de compatibilidad de Android 13. Usa esta lista, junto con las opciones para desarrolladores y los comandos de ADB, para probar y depurar tu app mientras te preparas para la compatibilidad y la orientación a Android 13.

A continuación, te mostramos algunas de las acciones que puedes realizar con las herramientas del marco de compatibilidad:

  • Probar los cambios orientados sin cambiar realmente la targetSdkVersion de la app. Puedes usar los botones de activación y desactivación para forzar cambios de comportamiento orientados específicos a fin de evaluar el impacto en tu app existente.
  • Enfocar tus pruebas solo a cambios específicos. En lugar de tener que abordar todos los cambios orientados a la vez, los botones de activación y desactivación te permiten inhabilitar todos los cambios orientados, excepto los que deseas probar.
  • Administrar los cambios que se pueden activar y desactivar mediante adb. Puedes usar comandos ADB para habilitar o inhabilitar los cambios que se pueden activar o desactivar en tu entorno de prueba automatizado.
  • Depurar más rápido con los ID de cambio estándar. Cada cambio que se puede activar y desactivar tiene un ID y un nombre únicos que puedes usar para depurar rápidamente la causa raíz en el resultado del registro.

Si quieres obtener más información sobre cómo usar las herramientas para cada uno de estos casos de uso, consulta Herramientas del marco de compatibilidad.

Cambios de comportamiento incluidos en el marco de compatibilidad

En la lista de esta sección, se describen los cambios que se pueden activar o desactivar y que se incluyen en el marco de compatibilidad de Android 13.

Puedes filtrar la lista de cambios por Estado predeterminado.

Cambios que se pueden activar o desactivar en el marco de compatibilidad de Android 13

ALWAYS_SANDBOX_DISPLAY_APIS

ID del cambio: 185004937
Estado predeterminado: Inhabilitado para todas las apps.

Fuerza los paquetes a los que se aplica, de modo que siempre se aplique la zona de pruebas de la API de Display, independientemente del modo de renderización en ventanas. Las API de Display siempre proporcionarán los límites de la app.

Si deseas obtener más información sobre este cambio, consulta Display#getRealSize y getRealMetrics: baja y zona de pruebas.

CAMERA_MIC_INDICATORS_NOT_PRESENT

ID del cambio: 162547999
Estado predeterminado: Inhabilitado para todas las apps.

Determina que este dispositivo admite indicadores de cámara y micrófono. Será false si está presente porque el método CompatChanges#isChangeEnabled muestra true si el ID de cambio no está presente.

DEFER_BOOT_COMPLETED_BROADCAST_CHANGE_ID

ID del cambio: 203704822
Estado predeterminado: Habilitado para apps que se orientan a Android 13 o versiones posteriores.

En el caso de las apps orientadas a Android 13 y versiones posteriores, aplaza las transmisiones LOCKED_BOOT_COMPLETED y BOOT_COMPLETED hasta la primera vez que se inicie un proceso en el UID.

DOWNSCALED

ID del cambio: 168419799
Estado predeterminado: Inhabilitado para todas las apps.

Este cambio es el guardián de todos los cambios de escalamiento descendente de búfer por app. Inhabilitar este cambio evita que funcionen los siguientes factores de escala:

Cuando se habilita este cambio para un paquete de app, se fuerza el cambio de tamaño de la app al factor de escala más alto habilitado. Por ejemplo, se usará 80% si tanto 80% como 70% están habilitados.

DOWNSCALE_30

ID del cambio: 189970040
Estado predeterminado: Inhabilitado para todas las apps.

Cuando el estado de DOWNSCALEDtambién es habilitado, habilitar este cambio para un paquete fuerza a la app a asumir que se está ejecutando en una pantalla con una resolución vertical y horizontal del 30% de la pantalla real.

DOWNSCALE_35

ID del cambio: 189969749
Estado predeterminado: Inhabilitado para todas las apps.

Cuando el estado de DOWNSCALEDtambién es habilitado, habilitar este cambio para un paquete fuerza a la app a asumir que se está ejecutando en una pantalla con una resolución vertical y horizontal del 35% de la pantalla real.

DOWNSCALE_40

ID del cambio: 189970038
Estado predeterminado: Inhabilitado para todas las apps.

Cuando el estado de DOWNSCALEDtambién es habilitado, habilitar este cambio para un paquete fuerza a la app a asumir que se está ejecutando en una pantalla con una resolución vertical y horizontal del 40% de la pantalla real.

DOWNSCALE_45

ID del cambio: 189969782
Estado predeterminado: Inhabilitado para todas las apps.

Cuando el estado de DOWNSCALEDtambién es habilitado, habilitar este cambio para un paquete fuerza a la app a asumir que se está ejecutando en una pantalla con una resolución vertical y horizontal del 45% de la pantalla real.

DOWNSCALE_50

ID del cambio: 176926741
Estado predeterminado: Inhabilitado para todas las apps.

Cuando el estado de DOWNSCALED también es habilitado, habilitar este cambio para un paquete fuerza a la app a asumir que se está ejecutando en una pantalla con una resolución vertical y horizontal del 50% de la pantalla real.

DOWNSCALE_55

ID del cambio: 189970036
Estado predeterminado: Inhabilitado para todas las apps.

Cuando el estado de DOWNSCALEDtambién es habilitado, habilitar este cambio para un paquete fuerza a la app a asumir que se está ejecutando en una pantalla con una resolución vertical y horizontal del 55% de la pantalla real.

DOWNSCALE_60

ID del cambio: 176926771
Estado predeterminado: Inhabilitado para todas las apps.

Cuando el estado de DOWNSCALED también es habilitado, habilitar este cambio para un paquete fuerza a la app a asumir que se está ejecutando en una pantalla con una resolución vertical y horizontal del 60% de la pantalla real.

DOWNSCALE_65

ID del cambio: 189969744
Estado predeterminado: Inhabilitado para todas las apps.

Cuando el estado de DOWNSCALEDtambién es habilitado, habilitar este cambio para un paquete fuerza a la app a asumir que se está ejecutando en una pantalla con una resolución vertical y horizontal del 65% de la pantalla real.

DOWNSCALE_70

ID del cambio: 176926829
Estado predeterminado: Inhabilitado para todas las apps.

Cuando el estado de DOWNSCALED también es habilitado, habilitar este cambio para un paquete fuerza a la app a asumir que se está ejecutando en una pantalla con una resolución vertical y horizontal del 70% de la pantalla real.

DOWNSCALE_75

ID del cambio: 189969779
Estado predeterminado: Inhabilitado para todas las apps.

Cuando el estado de DOWNSCALEDtambién es habilitado, habilitar este cambio para un paquete fuerza a la app a asumir que se está ejecutando en una pantalla con una resolución vertical y horizontal del 75% de la pantalla real.

DOWNSCALE_80

ID del cambio: 176926753
Estado predeterminado: Inhabilitado para todas las apps.

Cuando el estado de DOWNSCALED también es habilitado, habilitar este cambio para un paquete fuerza a la app a asumir que se está ejecutando en una pantalla con una resolución vertical y horizontal del 80% de la pantalla real.

DOWNSCALE_85

ID del cambio: 189969734
Estado predeterminado: Inhabilitado para todas las apps.

Cuando el estado de DOWNSCALEDtambién es habilitado, habilitar este cambio para un paquete fuerza a la app a asumir que se está ejecutando en una pantalla con una resolución vertical y horizontal del 85% de la pantalla real.

DOWNSCALE_90

ID del cambio: 182811243
Estado predeterminado: Inhabilitado para todas las apps.

Cuando el estado de DOWNSCALEDtambién es habilitado, habilitar este cambio para un paquete fuerza a la app a asumir que se está ejecutando en una pantalla con una resolución vertical y horizontal del 90% de la pantalla real.

DYNAMIC_RECEIVER_EXPLICIT_EXPORT_REQUIRED

ID del cambio: 161145287
Estado predeterminado: Habilitado para apps que se orientan a Android 13 o versiones posteriores.

En el caso de las apps orientadas a Android 13 y versiones posteriores, ahora es necesario que las apps configuren explícitamente Context.RECEIVER_EXPORTED o Context.RECEIVER_NOT_EXPORTED cuando se registre un receptor para una transmisión sin protección en el código.

Si quieres obtener más información sobre este cambio, consulta la sección sobre exportación más segura de receptores registrados en el contexto.

FORCE_DISABLE_HEVC_SUPPORT

ID del cambio: 174227820
Estado predeterminado: Inhabilitado para todas las apps.

Fuerza la inhabilitación de una app para que no sea compatible con la capacidad de contenido multimedia HEVC. Las apps deben declarar las capacidades de contenido multimedia admitidas en su manifiesto, pero esta marca puede usarse para forzar el acceso de una app a HEVC, lo que fuerza la transcodificación mientras se accede al contenido multimedia codificado en HEVC. La configuración de esta marca anulará cualquier valor predeterminado en el nivel del SO para las apps. Está inhabilitado de forma predeterminada, lo que significa que los valores predeterminados del SO tienen prioridad. Configurar esta marca y FORCE_ENABLE_HEVC_SUPPORT es un estado indefinido y provocará que el SO ignore ambas marcas.

FORCE_ENABLE_HEVC_SUPPORT

ID del cambio: 174228127
Estado predeterminado: Inhabilitado para todas las apps.

Fuerza a una app a admitir la capacidad de contenido multimedia HEVC. Las apps deberían declarar las capacidades de contenido multimedia en su manifiesto, pero esta marca se puede usar para forzar a la app a admitir HEVC. Por lo tanto, se debe evitar la transcodificación mientras se accede al contenido multimedia codificado en HEVC. La configuración de esta marca anulará cualquier valor predeterminado en el nivel del SO para las apps. Está inhabilitado de forma predeterminada, lo que significa que los valores predeterminados del SO tendrán prioridad. Configurar esta marca y FORCE_DISABLE_HEVC_SUPPORT es un estado indefinido y provocará que el SO ignore ambas marcas.

FORCE_NON_RESIZE_APP

ID del cambio: 181136395
Estado predeterminado: Inhabilitado para todas las apps.

Fuerza los paquetes a los que se aplica de modo que no puedan cambiar el tamaño.

FORCE_RESIZE_APP

ID del cambio: 174042936
Estado predeterminado: Inhabilitado para todas las apps.

Fuerza los paquetes a los que se aplica para que puedan cambiar el tamaño. Solo permitimos cambiar el tamaño en el modo de renderización de ventanas de pantalla completa, pero no se fuerza a la app a cambiar el tamaño del modo multiventana.

KEYSTORE_OPERATION_CREATION_MAY_FAIL

ID del cambio: 169897160
Estado predeterminado: Inhabilitado para todas las apps.

Cuando está habilitada, la creación de la operaciones del almacén de claves puede fallar según la nueva estrategia de reducción. Los almacenes de claves solían trabajar bajo la suposición de que la creación de operaciones criptográficas siempre se realizaba correctamente. Sin embargo, el backend de KeyMint solo tiene un número limitado de ranuras de operación.

Para mantener la apariencia de las ranuras de las operaciones "infinitas", el daemon del almacén de claves reducía las operaciones usadas recientemente si no había una ranura de operación disponible. Como resultado, las operaciones buenas se podían finalizar de forma prematura. Esto llevaba a AndroidKeystore a la denegación del servicio (DoS) y un bloqueo activo no intencional. Por ejemplo, si varias aplicaciones se activaban al mismo tiempo debido a optimizaciones de administración de energía e intentaban realizar operaciones criptográficas, comenzaban a finalizar las operaciones entre sí sin ningún progreso.

A fin de eliminar los bloqueos activos y desalentar los intentos de DoS, cambiamos la estrategia de reducción para que prefiera clientes que usen pocas ranuras de operación. Como resultado, las operaciones individuales que no resultan inactivas por más de 5 segundos casi siempre concluirán sin problemas gracias a la estrategia de reducción. Aún existen algunas operaciones relacionadas con la encriptación del sistema de archivos que pueden reducir incluso estas operaciones, pero son casos poco frecuentes. Como efecto secundario de esta nueva operación de estrategia de reducción, ahora la creación puede fallar si el cliente tiene una potencia de reducción menor que todas las operaciones existentes.

Estrategia de reducción: A fin de encontrar un candidato adecuado, calculamos el malus para el emisor y cada operación existente. El malus es la inversa de la potencia de reducción (emisor) o la resistencia a la reducción (operación existente). Para que el emisor pueda reducir una operación, debe buscar una operación con un malus superior al suyo. Para obtener más información sobre la estrategia de reducción, consulta la implementación de operation.rs. En Android 11 (nivel de API 30) y versiones anteriores, KeyStore2 consultará el daemon del almacén de claves para obtener un espacio de operación libre. En el caso de las apps orientadas a Android 11 (nivel de API 30) y versiones anteriores, seguirá pareciendo que la inicialización del objeto de firma y el algoritmo de cifrado siempre es exitosa; sin embargo, obtener una operación podría demorar más tiempo. Todas las versiones de Android se benefician de la programación de ranuras de operación más justas y una mejor oportunidad para finalizar una operación con éxito.

NATIVE_HEAP_ZERO_INIT

ID del cambio: 178038272
Estado predeterminado: Inhabilitado para todas las apps.

Habilita la inicialización automática en cero de las asignaciones nativas de memoria del montón.

NATIVE_MEMTAG_ASYNC

ID del cambio: 135772972
Estado predeterminado: Inhabilitado para todas las apps.

Habilita la verificación de etiquetas de memoria asíncrona (ASYNC) en este proceso. Esta marca solo afecta el hardware que admite la extensión de etiquetado de memoria (MTE) de ARM.

NATIVE_MEMTAG_SYNC

ID del cambio: 177438394
Estado predeterminado: Inhabilitado para todas las apps.

Habilita la verificación de etiquetas de memoria síncrona (SYNC) en este proceso. Esta marca solo afecta el hardware que admite la extensión de etiquetado de memoria (MTE) de ARM. Si NATIVE_MEMTAG_ASYNC y esta opción están habilitadas, esta opción tiene prioridad y la MTE se habilita en modo SYNC.

NEVER_SANDBOX_DISPLAY_APIS

ID del cambio: 184838306
Estado predeterminado: Inhabilitado para todas las apps.

Fuerza los paquetes a los que se aplica de modo que nunca se aplique la zona de pruebas de la API de Display en letterbox ni en una actividad de SCM. Las API de Display continuarán proporcionando los límites DisplayArea.

Si deseas obtener más información sobre este cambio, consulta Display#getRealSize y getRealMetrics: baja y zona de pruebas.

NOTIFICATION_LOG_ASSISTANT_CANCEL

ID del cambio: 195579280
Estado predeterminado: Habilitado para apps que se orientan a Android 13 o versiones posteriores.

En el caso de las apps orientadas a Android 13 y versiones posteriores, permite que los objetos de escucha entiendan el motivo más específico proporcionado para las cancelaciones de notificaciones de un asistente, en lugar de usar el REASON_LISTENER_CANCEL más general.

NOTIFICATION_PERM_CHANGE_ID

ID del cambio: 194833441
Estado predeterminado: Habilitado para apps que se orientan a Android 13 o versiones posteriores.

En el caso de las apps orientadas a Android 13 y versiones posteriores, habilita los cambios de comportamiento relacionados con los permisos o las notificaciones de tiempo de ejecución.

Para obtener más información sobre este cambio, consulta la página sobre el nuevo permiso de tiempo de ejecución de notificaciones.

OVERRIDE_CAMERA_RESIZABLE_AND_SDK_CHECK

ID del cambio: 191513214
Estado predeterminado: Inhabilitado para todas las apps.

Cuando se habilita, este ID de cambio fuerza a los paquetes a los que se aplica y al SDK de destino igual o inferior a M a ignorar el valor actual de android:resizeableActivity y a considerar que la actividad no puede cambiar de tamaño. En este caso, el valor de la rotación y el recorte de la cámara solo dependerán de la compensación necesaria si se considera la rotación actual de la pantalla.

OVERRIDE_CAMERA_ROTATE_AND_CROP_DEFAULTS

ID del cambio: 189229956
Estado predeterminado: Inhabilitado para todas las apps.

Cuando se habilita, este ID de cambio fuerza los paquetes a los que se aplican a anular el comportamiento predeterminado de rotación y recorte de la cámara, y a mostrar siempre CaptureRequest.SCALER_ROTATE_AND_CROP_NONE. En la siguiente tabla, se analizan el comportamiento predeterminado junto con todas las combinaciones de anulación posibles.

OVERRIDE_MIN_ASPECT_RATIO

ID del cambio: 174042980
Estado predeterminado: Inhabilitado para todas las apps.

Este cambio es el guardián de todos los cambios que fuercen una relación de aspecto mínima dada. Si se habilita este cambio, se podrán aplicar las siguientes relaciones de aspecto mínimas:

Cuando se habilita este cambio para un paquete de app, la relación de aspecto mínima proporcionada en el manifiesto de la app se anula con la relación de aspecto más grande habilitada, a menos que el valor del manifiesto de la app sea superior.

OVERRIDE_MIN_ASPECT_RATIO_LARGE

ID del cambio: 180326787
Estado predeterminado: Inhabilitado para todas las apps.

Cuando el estado de OVERRIDE_MIN_ASPECT_RATIO también es habilitado, habilitar este cambio para un paquete establece la relación de aspecto mínima de la actividad en un valor grande definido por OVERRIDE_MIN_ASPECT_RATIO_LARGE_VALUE.

OVERRIDE_MIN_ASPECT_RATIO_MEDIUM

ID del cambio: 180326845
Estado predeterminado: Inhabilitado para todas las apps.

Cuando también se habilita OVERRIDE_MIN_ASPECT_RATIO, habilitar este cambio para un paquete establece la relación de aspecto mínima de la actividad en un valor medio definido por OVERRIDE_MIN_ASPECT_RATIO_MEDIUM_VALUE.

OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

ID del cambio: 203647190
Estado predeterminado: Habilitado para todas las apps.

Cuando también se habilita OVERRIDE_MIN_ASPECT_RATIO, habilitar este cambio para un paquete limita cualquier cambio que fuerce la relación de aspecto mínima de una actividad a un valor determinado, como OVERRIDE_MIN_ASPECT_RATIO_LARGE y OVERRIDE_MIN_ASPECT_RATIO_MEDIUM, para actividades que también tienen una orientación vertical.

RATE_LIMIT_TOASTS

ID del cambio: 174840628
Estado predeterminado: Este cambio no se puede activar ni desactivar. Solo se registra en el marco de compatibilidad.

Habilita el límite de frecuencia en la cantidad de llamadas a Toast.show() para evitar que el usuario se sobrecargue con demasiados avisos en un tiempo limitado. Cualquier intento de mostrar más avisos de lo que se permite en un período determinado hará que se descarten los avisos.

SUPPORT_DEREGISTERING_LOSING_PDN_STATE

ID del cambio: 201522903
Estado predeterminado: Habilitado para apps que se orientan a Android 13 o versiones posteriores.

En el caso de las apps que se orientan a Android 13 y versiones posteriores, admite el estado DEREGISTERING_REASON_LOSING_PDN en las API, como DelegateRegistrationState#addDeregisteringFeatureTag y DelegateRegistrationState#getDeregisteringFeatureTags.

SUPPORT_PUBLISHING_STATE

ID del cambio: 202894742
Estado predeterminado: Habilitado para apps que se orientan a Android 13 o versiones posteriores.

En el caso de las apps que se orientan a Android 13 y versiones posteriores, se admite el estado de publicación en las API, como RcsUceAdapter#PUBLISH_STATE_PUBLISHINGsupport.

SUPPORT_REGISTERING_DELEGATE_STATE

ID del cambio: 205194548
Estado predeterminado: Habilitado para apps que se orientan a Android 13 o versiones posteriores.

En el caso de las apps que se orientan a Android 13 y versiones posteriores, se admite el estado REGISTERING en las API, como DelegateRegistrationState#addRegisteringFeatureTags y DelegateRegistrationState#getRegisteringFeatureTagssupport.