Descripción general de las funciones y API

Android 15 incluye excelentes funciones y APIs para desarrolladores. En las siguientes secciones, se resumen estas funciones para ayudarte a comenzar a usar las APIs relacionadas.

Para obtener una lista detallada de las APIs agregadas, modificadas y quitadas, consulta el informe de diferencias de la API. Para obtener detalles sobre las APIs agregadas, consulta la referencia de la API de Android. En Android 15, busca las APIs que se agregaron en el nivel de API 35. Para conocer las áreas en las que los cambios de la plataforma podrían afectar tus apps, asegúrate de revisar los cambios en el comportamiento de Android 15 para apps orientadas a Android 15 y para todas las apps.

Cámara y contenido multimedia

Android 15 incluye una variedad de funciones que mejoran la experiencia de la cámara y el contenido multimedia, y que te brindan acceso a herramientas y hardware para ayudar a los creadores a hacer realidad su visión en Android.

Para obtener más información sobre las funciones y soluciones para desarrolladores más recientes de la cámara y el contenido multimedia de Android, consulta la charla Building modern Android media and camera experiences de Google I/O.

Mejora con poca luz

Android 15 presenta Mejora de poca luz, un modo de exposición automática disponible para Camera 2 y la extensión de cámara del modo nocturno. La mejora con poca luz ajusta la exposición de la transmisión de vista previa en condiciones de poca luz. Esto es diferente de la forma en que la extensión de cámara del modo nocturno crea imágenes fijas, ya que el modo nocturno combina una ráfaga de fotos para crear una sola imagen mejorada. Si bien el modo nocturno funciona muy bien para crear una imagen fija, no puede crear una transmisión continua de fotogramas, pero el modo de mejora con poca luz sí puede hacerlo. Por lo tanto, el modo de poca luz habilita las siguientes funciones de la cámara:

Proporciona una vista previa de imagen mejorada para que los usuarios puedan encuadrar mejor sus fotos con poca luz.
Cómo escanear códigos QR con poca luz

Si habilitas la función de mejora de poca luz, esta se activa automáticamente cuando hay un nivel de luz bajo y se desactiva cuando hay más luz.

Las apps pueden grabar desde la transmisión de vista previa en condiciones de poca luz para guardar un video más brillante.

Para obtener más información, consulta Aumento de poca luz.

Controles de cámara integrados en la app

Android 15 agrega una extensión para tener más control sobre el hardware de la cámara y sus algoritmos en dispositivos compatibles:

Ajustes avanzados de la intensidad del flash que permiten un control preciso de la intensidad del flash en los modos SINGLE y TORCH mientras se capturan imágenes.

Control de margen de HDR

Android 15 chooses HDR headroom that is appropriate for the underlying device capabilities and bit-depth of the panel. For pages that have lots of SDR content, such as a messaging app displaying a single HDR thumbnail, this behavior can end up adversely influencing the perceived brightness of the SDR content. Android 15 lets you control the HDR headroom with setDesiredHdrHeadroom to strike a balance between SDR and HDR content.

The brightness of SDR UI elements on the left screen appears to be more uniform than the brightness on the right screen, which simulates possible headroom issues when HDR and SDR content are mixed. By adjusting the HDR headroom, you can achieve a better balance between the SDR and HDR content.

Control de volumen

Android 15 引入了对 CTA-2075 响度标准的支持，可帮助您避免音频响度不一致，并确保用户在切换内容时不必不断调整音量。系统利用输出设备（头戴式耳机和扬声器）的已知特性以及 AAC 音频内容中提供的响度元数据，智能调整音频响度和动态范围压缩级别。

如需启用此功能，您需要确保 AAC 内容中提供响度元数据，并在应用中启用平台功能。为此，您可以通过使用关联的 AudioTrack 中的音频会话 ID 调用其 create 工厂方法来实例化 LoudnessCodecController 对象；这会自动开始应用音频更新。您可以传递 OnLoudnessCodecUpdateListener 来修改或过滤响度参数，然后再将其应用于 MediaCodec。

// Media contains metadata of type MPEG_4 OR MPEG_D
val mediaCodec = …
val audioTrack = AudioTrack.Builder()
                                .setSessionId(sessionId)
                                .build()
...
// Create new loudness controller that applies the parameters to the MediaCodec
try {
   val lcController = LoudnessCodecController.create(mSessionId)
   // Starts applying audio updates for each added MediaCodec
}

AndroidX media3 ExoPlayer 也将更新，以使用 LoudnessCodecController API，可实现无缝应用集成。

Dispositivos MIDI 2.0 virtuales

Android 13 agregó compatibilidad para conectarse a dispositivos MIDI 2.0 a través de USB, que se comunican con paquetes MIDI universales (UMP). Android 15 extiende la compatibilidad con UMP a las apps de MIDI virtual, lo que permite que las apps de composición controlen las apps de sintetizador como un dispositivo MIDI 2.0 virtual, al igual que lo harían con un dispositivo MIDI 2.0 USB.

Decodificación de software AV1 más eficiente

dav1d 徽标

dav1d 是 VideoLAN 推出的热门 AV1 软件解码器，适用于不支持硬件 AV1 解码的 Android 设备。与旧版 AV1 软件解码器相比，dav1d 的性能最高可提升 3 倍，让更多用户（包括一些低端和中端设备）能够播放高清 AV1 视频。

您的应用需要选择启用 dav1d，方法是通过名称 "c2.android.av1-dav1d.decoder" 调用它。在后续更新中，dav1d 将成为默认的 AV1 软件解码器。此支持已标准化，并向后移植到收到 Google Play 系统更新的 Android 11 设备。

Productividad y herramientas para desarrolladores

Si bien la mayor parte de nuestro trabajo para mejorar tu productividad se centra en herramientas como Android Studio, Jetpack Compose y las bibliotecas de Android Jetpack, siempre buscamos formas de ayudarte a hacer realidad tu visión con mayor facilidad en la plataforma.

Actualizaciones de OpenJDK 17

Android 15 将继续更新 Android 的核心库，以与最新 OpenJDK LTS 版本中的功能保持一致。

其中包含以下主要功能和改进：

改进了 NIO 缓冲区的使用体验
数据流
其他 math 和 strictmath 方法
util 软件包更新，包括顺序的 collection、map 和 set
Deflater 中的 ByteBuffer 支持
安全更新，例如 X500PrivateCredential 和安全密钥更新

这些 API 会通过 Google Play 系统更新在搭载 Android 12（API 级别 31）及更高版本的 10 亿多部设备上更新，以便您以最新的编程功能为目标平台。

Mejoras en el PDF

Android 15 incluye mejoras sustanciales en las APIs de PdfRenderer. Las apps pueden incorporar funciones avanzadas, como la renderización de archivos protegidos por contraseña, las anotaciones, la edición de formularios, la búsqueda y la selección con copia. Se admiten optimizaciones de PDF linealizados para acelerar la visualización de PDF local y reducir el uso de recursos. La biblioteca de PDF de Jetpack usa estas APIs para simplificar la adición de funciones de visualización de PDF a tu app.

Las actualizaciones más recientes del procesamiento de PDF incluyen funciones como la búsqueda en un archivo PDF incorporado.

Se trasladó PdfRenderer a un módulo que se puede actualizar con Google. Las actualizaciones del sistema de Play son independientes de la versión de la plataforma, estos cambios a Android 11 (nivel de API 30) mediante la creación de una versión versión de la plataforma de API anterior a Android 15, llamada PdfRendererPreV

Mejoras en el cambio automático de idioma

Android 14 agregó el reconocimiento multilingüe integrado en el dispositivo en el audio con cambio automático entre idiomas, pero esto puede provocar que se omitan palabras, en especial cuando los idiomas cambian con menos pausa entre las dos oraciones. Android 15 agrega controles adicionales para ayudar a las apps a ajustar este cambio según su caso de uso. EXTRA_LANGUAGE_SWITCH_INITIAL_ACTIVE_DURATION_TIME_MILLIS limita el cambio automático al comienzo de la sesión de audio, mientras que EXTRA_LANGUAGE_SWITCH_MATCH_SWITCHES desactiva el cambio de idioma después de una cantidad definida de cambios. Estas opciones son particularmente útiles si esperas que se hable un solo idioma durante la sesión que se debe detectar automáticamente.

Se mejoró la API de fuentes variables de OpenType

Android 15 improves the usability of the OpenType variable font. You can create a FontFamily instance from a variable font without specifying weight axes with the buildVariableFamily API. The text renderer overrides the value of wght axis to match the displaying text.

Using the API simplifies the code for creating a Typeface considerably:

Kotlin

val newTypeface = Typeface.CustomFallbackBuilder(
            FontFamily.Builder(
                Font.Builder(assets, "RobotoFlex.ttf").build())
                    .buildVariableFamily())
    .build()

Java

Typeface newTypeface = Typeface.CustomFallbackBuilder(
            new FontFamily.Builder(
                new Font.Builder(assets, "RobotoFlex.ttf").build())
                    .buildVariableFamily())
    .build();

Previously, to create the same Typeface, you would need much more code:

Kotlin

val oldTypeface = Typeface.CustomFallbackBuilder(
            FontFamily.Builder(
                Font.Builder(assets, "RobotoFlex.ttf")
                    .setFontVariationSettings("'wght' 400")
                    .setWeight(400)
                    .build())
                .addFont(
                    Font.Builder(assets, "RobotoFlex.ttf")
                        .setFontVariationSettings("'wght' 100")
                        .setWeight(100)
                        .build()
                )
                .addFont(
                    Font.Builder(assets, "RobotoFlex.ttf")
                        .setFontVariationSettings("'wght' 200")
                        .setWeight(200)
                        .build()
                )
                .addFont(
                    Font.Builder(assets, "RobotoFlex.ttf")
                        .setFontVariationSettings("'wght' 300")
                        .setWeight(300)
                        .build()
                )
                .addFont(
                    Font.Builder(assets, "RobotoFlex.ttf")
                        .setFontVariationSettings("'wght' 500")
                        .setWeight(500)
                        .build()
                )
                .addFont(
                    Font.Builder(assets, "RobotoFlex.ttf")
                        .setFontVariationSettings("'wght' 600")
                        .setWeight(600)
                        .build()
                )
                .addFont(
                    Font.Builder(assets, "RobotoFlex.ttf")
                        .setFontVariationSettings("'wght' 700")
                        .setWeight(700)
                        .build()
                )
                .addFont(
                    Font.Builder(assets, "RobotoFlex.ttf")
                        .setFontVariationSettings("'wght' 800")
                        .setWeight(800)
                        .build()
                )
                .addFont(
                    Font.Builder(assets, "RobotoFlex.ttf")
                        .setFontVariationSettings("'wght' 900")
                        .setWeight(900)
                        .build()
                ).build()
        ).build()

Java

Typeface oldTypeface = new Typeface.CustomFallbackBuilder(
    new FontFamily.Builder(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 400")
            .setWeight(400)
            .build()
    )
    .addFont(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 100")
            .setWeight(100)
            .build()
    )
    .addFont(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 200")
            .setWeight(200)
            .build()
    )
    .addFont(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 300")
            .setWeight(300)
            .build()
    )
    .addFont(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 500")
            .setWeight(500)
            .build()
    )
    .addFont(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 600")
            .setWeight(600)
            .build()
    )
    .addFont(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 700")
            .setWeight(700)
            .build()
    )
    .addFont(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 800")
            .setWeight(800)
            .build()
    )
    .addFont(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 900")
            .setWeight(900)
            .build()
    )
    .build()
).build();

Here's an example of how a Typeface created with both the old and new APIs renders:

An example of how Typeface rendering differs using new and old
APIs

In this example, the Typeface created with the old API doesn't have the capability to create accurate font weights for the 350, 450, 550 and 650 Font instances, so the renderer falls back to the closest weight. So in this case, 300 is rendered instead of 350, 400 is rendered instead of 450, and so on. By contrast, the Typeface created with the new APIs dynamically creates a Font instance for a given weight, so accurate weights are rendered for 350, 450, 550, and 650 as well.

Controles detallados de saltos de línea

A partir de Android 15, un TextView y el separador de líneas subyacente pueden preservar la parte determinada de texto en la misma línea para mejorar la legibilidad. Puedes aprovechar esta personalización de salto de línea con la etiqueta <nobreak> en los recursos de cadenas o con createNoBreakSpan. De manera similar, puedes evitar que las palabras se dividan en sílabas con la etiqueta <nohyphen> o createNoHyphenationSpan.

Por ejemplo, el siguiente recurso de cadenas no incluye un salto de línea y se renderiza con el texto "Pixel 8 Pro" que se interrumpe en un lugar no deseado:

<resources>
    <string name="pixel8pro">The power and brains behind Pixel 8 Pro.</string>
</resources>

En cambio, este recurso de cadena incluye la etiqueta <nobreak>, que une la frase "Pixel 8 Pro" y evita los saltos de línea:

<resources>
    <string name="pixel8pro">The power and brains behind <nobreak>Pixel 8 Pro.</nobreak></string>
</resources>

La diferencia en la forma en que se renderizan estas strings se muestra en las siguientes imágenes:

El diseño de una línea de texto en la que la frase "Pixel 8 Pro" no se ajusta con una etiqueta <nobreak>.

Diseño para la misma línea de texto en la que la frase "Pixel 8 Pro" se une con una etiqueta <nobreak>.

Archivado de apps

Android and Google Play announced support for app archiving last year, allowing users to free up space by partially removing infrequently used apps from the device that were published using Android App Bundle on Google Play. Android 15 includes OS level support for app archiving and unarchiving, making it easier for all app stores to implement it.

Apps with the REQUEST_DELETE_PACKAGES permission can call the PackageInstaller requestArchive method to request archiving an installed app package, which removes the APK and any cached files, but persists user data. Archived apps are returned as displayable apps through the LauncherApps APIs; users will see a UI treatment to highlight that those apps are archived. If a user taps on an archived app, the responsible installer will get a request to unarchive it, and the restoration process can be monitored by the ACTION_PACKAGE_ADDED broadcast.

Habilita el modo de 16 KB en un dispositivo con las opciones para desarrolladores

Activa la opción para desarrolladores Iniciar con tamaño de página de 16 KB para iniciar un dispositivo en el modo de 16 KB.

En las versiones de QPR de Android 15, puedes usar la opción para desarrolladores disponible en ciertos dispositivos para iniciar el dispositivo en modo de 16 KB y realizar pruebas en el dispositivo. Antes de usar la opción para desarrolladores, ve a Configuración > Sistema > Actualizaciones de software y aplica las actualizaciones disponibles.

Esta opción para desarrolladores está disponible en los siguientes dispositivos:

Pixel 8 y 8 Pro (con Android 15 QPR1 o versiones posteriores)
Pixel 8a (con Android 15 QPR1 o versiones posteriores)
Pixel 9, 9 Pro y 9 Pro XL (con Android 15 QPR2 o versiones posteriores)
Pixel 9a (con Android 16 o versiones posteriores)

Gráficos

Android 15 incluye las mejoras gráficas más recientes, como ANGLE y adiciones al sistema de gráficos de Canvas.

Modernización del acceso a la GPU de Android

Logotipo de Vulkan

El hardware de Android evolucionó bastante desde los primeros días, en los que el SO principal se ejecutaba en una sola CPU y se accedía a las GPUs con APIs basadas en canalizaciones de funciones fijas. La API de gráficos de Vulkan® está disponible en el NDK desde Android 7.0 (nivel de API 24) con una abstracción de nivel inferior que refleja mejor el hardware de GPU moderno, se escala mejor para admitir varios núcleos de CPU y ofrece una sobrecarga reducida del controlador de CPU, lo que mejora el rendimiento de la app. Todos los motores de juego modernos son compatibles con Vulkan.

Vulkan es la interfaz preferida de Android para la GPU. Por lo tanto, Android 15 incluye ANGLE como una capa opcional para ejecutar OpenGL® ES sobre Vulkan. El cambio a ANGLE estandarizará la implementación de OpenGL de Android para mejorar la compatibilidad y, en algunos casos, el rendimiento. Para probar la estabilidad y el rendimiento de tu app de OpenGL ES con ANGLE, habilita la opción para desarrolladores en Configuración -> Sistema -> Opciones para desarrolladores -> Experimental: Habilita ANGLE en Android 15.

Plan de ruta de ANGLE para Android en Vulkan

Plan de acción de los próximos cambios en las APIs de la GPU de Android

Como parte de la optimización de nuestra pila de GPU, en el futuro, enviaremos ANGLE como el controlador del sistema GL en más dispositivos nuevos, con la expectativa de que OpenGL/ES solo esté disponible a través de ANGLE. Dicho esto, planeamos seguir admitiendo OpenGL ES en todos los dispositivos.

Próximos pasos recomendados

Usa las opciones para desarrolladores para seleccionar el controlador ANGLE para OpenGL ES y probar tu app. Para proyectos nuevos, te recomendamos que uses Vulkan para C/C++.

Mejoras en Canvas

Android 15 continúa con la modernización del sistema de gráficos Canvas de Android con las siguientes capacidades adicionales:

Matrix44 proporciona una matriz 4x4 para transformar las coordenadas que se deben usar cuando deseas manipular el lienzo en 3D.
clipShader interseca el clip actual con el sombreador especificado, mientras que clipOutShader establece el clip en la diferencia entre el clip actual y el sombreador, cada uno de los cuales trata el sombreador como una máscara alfa. Esto admite el dibujo de formas complejas de manera eficiente.

Rendimiento y batería

Android sigue enfocándose en ayudarte a mejorar el rendimiento y la calidad de tus apps. Android 15 introduce APIs que ayudan a que las tareas de tu app se ejecuten de manera más eficiente, optimizan el rendimiento de la app y recopilan estadísticas sobre tus apps.

Para conocer las prácticas recomendadas que permiten ahorrar batería, depurar el uso de la red y la energía, y obtener detalles sobre cómo mejoramos la eficiencia de la batería del trabajo en segundo plano en Android 15 y versiones recientes de Android, consulta la charla Improving battery efficiency of background work on Android (Cómo mejorar la eficiencia de la batería del trabajo en segundo plano en Android) de Google I/O.

API de ApplicationStartInfo

In previous versions of Android, app startup has been a bit of a mystery. It was challenging to determine within your app whether it started from a cold, warm, or hot state. It was also difficult to know how long your app spent during the various launch phases: forking the process, calling onCreate, drawing the first frame, and more. When your Application class was instantiated, you had no way of knowing whether the app started from a broadcast, a content provider, a job, a backup, boot complete, an alarm, or an Activity.

The ApplicationStartInfo API on Android 15 provides all of this and more. You can even choose to add your own timestamps into the flow to help collect timing data in one place. In addition to collecting metrics, you can use ApplicationStartInfo to help directly optimize app startup; for example, you can eliminate the costly instantiation of UI-related libraries within your Application class when your app is starting up due to a broadcast.

Información detallada sobre el tamaño de la app

Since Android 8.0 (API level 26), Android has included the StorageStats.getAppBytes API that summarizes the installed size of an app as a single number of bytes, which is a sum of the APK size, the size of files extracted from the APK, and files that were generated on the device such as ahead-of-time (AOT) compiled code. This number is not very insightful in terms of how your app is using storage.

Android 15 adds the StorageStats.getAppBytesByDataType([type]) API, which lets you get insight into how your app is using up all that space, including APK file splits, AOT and speedup related code, dex metadata, libraries, and guided profiles.

Creación de perfiles administrada por la app

Android 15 includes the ProfilingManager class, which lets you collect profiling information from within your app such as heap dumps, heap profiles, stack sampling, and more. It provides a callback to your app with a supplied tag to identify the output file, which is delivered to your app's files directory. The API does rate limiting to minimize the performance impact.

To simplify constructing profiling requests in your app, we recommend using the corresponding Profiling AndroidX API, available in Core 1.15.0-rc01 or higher.

Mejoras en la base de datos SQLite

Android 15 presenta las APIs de SQLite que exponen funciones avanzadas del un motor SQLite subyacente que se dirija a problemas de rendimiento específicos que pueden en las apps. Estas APIs se incluyen con la actualización de SQLite a la versión 3.44.3

Los desarrolladores deben consultar las prácticas recomendadas para el rendimiento de SQLite para aprovechar al máximo su base de datos, en especial cuando trabajan con bases de datos grandes o cuando ejecutan consultas sensibles a la latencia.

Transacciones diferidas de solo lectura: Cuando emitas transacciones de solo lectura (no incluyas instrucciones de escritura), usa beginTransactionReadOnly() y beginTransactionWithListenerReadOnly(SQLiteTransactionListener) para emitir transacciones DEFERRED de solo lectura. Estas transacciones se pueden ejecutar de forma simultánea entre sí y, si la base de datos está en modo WAL, se pueden ejecutar de forma simultánea con transacciones IMMEDIATE o EXCLUSIVE.
Recuento y IDs de filas: Se agregaron APIs para recuperar el recuento de filas modificadas o el ID de la última fila insertada sin emitir una consulta adicional. getLastChangedRowCount() muestra la cantidad de filas que se insertaron, actualizaron o borraron mediante la instrucción de SQL más reciente en la transacción actual, mientras que getTotalChangedRowCount() devuelve el recuento de la conexión actual. getLastInsertRowId() muestra el rowid de la última fila que se insertará en la conexión actual.
Sentencias sin procesar: Emite una sentencia SQlite sin procesar, omitiendo los wrappers de conveniencia y cualquier sobrecarga de procesamiento adicional que puedan generar.

Actualizaciones del framework de rendimiento dinámico de Android

Android 15 continúa nuestra inversión en el framework de rendimiento dinámico de Android (ADPF), un conjunto de APIs que permiten que los juegos y las apps de alto rendimiento interactúen de forma más directa con los sistemas térmicos y de alimentación de los dispositivos Android. En dispositivos compatibles, Android 15 agrega las siguientes funciones de ADPF:

Un modo de eficiencia energética para las sesiones de sugerencias que indique que sus subprocesos asociados deben preferir el ahorro de energía en lugar del rendimiento, lo que es ideal para cargas de trabajo en segundo plano de larga duración.
Las duraciones de trabajo de la GPU y la CPU se pueden informar en sesiones de sugerencias, lo que permite que el sistema ajuste las frecuencias de la CPU y la GPU en conjunto para satisfacer mejor las demandas de la carga de trabajo.
Umbrales de margen térmico para interpretar posibles estados de limitación térmica en función de la predicción del margen.

Para obtener más información sobre cómo usar ADPF en tus apps y juegos, consulta la documentación.

Privacidad

Android 15 incluye una variedad de funciones que ayudan a los desarrolladores de apps a proteger la privacidad del usuario.

Detección de grabación de pantalla

En Android 15, se agrega compatibilidad con apps para detectar estas fallas se están grabando. Se invoca una devolución de llamada cada vez que la app pasa de ser visible a invisible dentro de una grabación de pantalla. Una app se considera visible si se registran actividades que pertenecen al UID del proceso de registro. De esta manera, si tu app realiza una operación sensible, puede informar al usuario que se está grabando.

val mCallback = Consumer<Int> { state ->
  if (state == SCREEN_RECORDING_STATE_VISIBLE) {
    // We're being recorded
  } else {
    // We're not being recorded
  }
}

override fun onStart() {
   super.onStart()
   val initialState =
      windowManager.addScreenRecordingCallback(mainExecutor, mCallback)
   mCallback.accept(initialState)
}

override fun onStop() {
    super.onStop()
    windowManager.removeScreenRecordingCallback(mCallback)
}

Capacidades expandidas de IntentFilter

Android 15 incluye compatibilidad con una resolución Intent más precisa a través de UriRelativeFilterGroup, que contiene un conjunto de objetos UriRelativeFilter que forman un conjunto de reglas de coincidencia Intent que deben cumplirse, incluidos los parámetros de consulta de URL, los fragmentos de URL y las reglas de bloqueo o exclusión.

Estas reglas se pueden definir en el archivo en formato XML AndroidManifest con la etiqueta <uri-relative-filter-group>, que puede incluir, de manera opcional, una etiqueta android:allow. Estas etiquetas pueden contener etiquetas <data> que usan atributos de etiqueta de datos existentes, así como los atributos android:query y android:fragment.

Este es un ejemplo de la sintaxis de AndroidManifest:

<intent-filter android:autoVerify="true">
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.BROWSABLE" />
  <category android:name="android.intent.category.DEFAULT" />
  <data android:scheme="http" />
  <data android:scheme="https" />
  <data android:host="astore.com" />
  <uri-relative-filter-group>
    <data android:pathPrefix="/auth" />
    <data android:query="region=na" />
  </uri-relative-filter-group>
  <uri-relative-filter-group android:allow="false">
    <data android:pathPrefix="/auth" />
    <data android:query="mobileoptout=true" />
  </uri-relative-filter-group>
  <uri-relative-filter-group android:allow="false">
    <data android:pathPrefix="/auth" />
    <data android:fragmentPrefix="faq" />
  </uri-relative-filter-group>
</intent-filter>

Espacio privado

The private space can be unlocked and locked to show or hide sensitive apps on a device.

Private space lets users create a separate space on their device where they can keep sensitive apps away from prying eyes, under an additional layer of authentication. The private space uses a separate user profile. The user can choose to use the device lock or a separate lock factor for the private space.

Apps in the private space show up in a separate container in the launcher, and are hidden from the recents view, notifications, settings, and from other apps when the private space is locked. User-generated and downloaded content (such as media or files) and accounts are separated between the private space and the main space. The system sharesheet and the photo picker can be used to give apps access to content across spaces when the private space is unlocked.

Users can't move existing apps and their data into the private space. Instead, users select an install option in the private space to install an app using whichever app store they prefer. Apps in the private space are installed as separate copies from any apps in the main space (new copies of the same app).

When a user locks the private space, the profile is stopped. While the profile is stopped, apps in the private space are no longer active and can't perform foreground or background activities, including showing notifications.

We recommend that you test your app with private space to make sure your app works as expected, especially if your app falls into one of the following categories:

Apps with logic for work profiles that assumes that any installed copies of their app that aren't in the main profile are in the work profile.
Medical apps
Launcher apps
App store apps

Consulta la selección del usuario más reciente para el acceso a las fotos seleccionadas

Apps can now highlight only the most-recently-selected photos and videos when partial access to media permissions is granted. This feature can improve the user experience for apps that frequently request access to photos and videos. To use this feature in your app, enable the QUERY_ARG_LATEST_SELECTION_ONLY argument when querying MediaStore through ContentResolver.

Kotlin

val externalContentUri = MediaStore.Files.getContentUri("external")

val mediaColumns = arrayOf(
   FileColumns._ID,
   FileColumns.DISPLAY_NAME,
   FileColumns.MIME_TYPE,
)

val queryArgs = bundleOf(
   // Return only items from the last selection (selected photos access)
   QUERY_ARG_LATEST_SELECTION_ONLY to true,
   // Sort returned items chronologically based on when they were added to the device's storage
   QUERY_ARG_SQL_SORT_ORDER to "${FileColumns.DATE_ADDED} DESC",
   QUERY_ARG_SQL_SELECTION to "${FileColumns.MEDIA_TYPE} = ? OR ${FileColumns.MEDIA_TYPE} = ?",
   QUERY_ARG_SQL_SELECTION_ARGS to arrayOf(
       FileColumns.MEDIA_TYPE_IMAGE.toString(),
       FileColumns.MEDIA_TYPE_VIDEO.toString()
   )
)

Java

Uri externalContentUri = MediaStore.Files.getContentUri("external");

String[] mediaColumns = {
    FileColumns._ID,
    FileColumns.DISPLAY_NAME,
    FileColumns.MIME_TYPE
};

Bundle queryArgs = new Bundle();
queryArgs.putBoolean(MediaStore.QUERY_ARG_LATEST_SELECTION_ONLY, true);
queryArgs.putString(MediaStore.QUERY_ARG_SQL_SORT_ORDER, FileColumns.DATE_ADDED + " DESC");
queryArgs.putString(MediaStore.QUERY_ARG_SQL_SELECTION, FileColumns.MEDIA_TYPE + " = ? OR " + FileColumns.MEDIA_TYPE + " = ?");
queryArgs.putStringArray(MediaStore.QUERY_ARG_SQL_SELECTION_ARGS, new String[] {
    String.valueOf(FileColumns.MEDIA_TYPE_IMAGE),
    String.valueOf(FileColumns.MEDIA_TYPE_VIDEO)
});

Privacy Sandbox en Android

Android 15 incluye las extensiones más recientes de los servicios de anuncios de Android, que incorporan la versión más reciente de Privacy Sandbox en Android. Esta incorporación forma parte de nuestro trabajo para desarrollar tecnologías que mejoren la privacidad del usuario y permitan brindar experiencias de publicidad personalizadas y efectivas en apps para dispositivos móviles. En nuestra página de Privacy Sandbox, encontrarás más información sobre los programas de versión beta y de vista previa para desarrolladores de Privacy Sandbox en Android para ayudarte a comenzar.

Health Connect

Android 15 integra las extensiones más recientes de Health Connect de Android, una plataforma segura y centralizada para administrar y compartir datos de salud y fitness recopilados por la app. Esta actualización agrega compatibilidad con tipos de datos adicionales en estado físico, nutrición, temperatura cutánea, planes de entrenamiento y mucho más.

El seguimiento de la temperatura de la piel permite a los usuarios almacenar y compartir datos de temperatura más precisos desde un dispositivo wearable o algún otro dispositivo de seguimiento.

Los planes de entrenamiento son planes de entrenamiento estructurados para ayudar a un usuario a alcanzar sus objetivos de fitness. La compatibilidad con los planes de entrenamiento incluye una variedad de objetivos de finalización y rendimiento:

Objetivos de finalización relacionados con las calorías quemadas, la distancia, la duración, la repetición y los pasos.
Los objetivos de rendimiento muchas repeticiones como sea posible (AMRAP), cadencia, frecuencia cardíaca, alimentación, tasa percibida del esfuerzo y Velocidad.

Obtén más información sobre las actualizaciones más recientes de Health Connect en Android en la charla Cómo crear experiencias adaptables con Android Health de Google I/O.

Android 15 supports app screen sharing so users can share or record just an app window rather than the entire device screen. This feature, first enabled in Android 14 QPR2, includes MediaProjection callbacks that allow your app to customize the app screen sharing experience. Note that for apps targeting Android 14 (API level 34) or higher, user consent is required for each MediaProjection capture session.

Experiencia del usuario y la IU del sistema

Android 15 brinda a los desarrolladores de apps y a los usuarios más control y flexibilidad para configurar sus dispositivos según sus necesidades.

Para obtener más información sobre cómo usar las mejoras más recientes de Android 15 para mejorar la experiencia del usuario de tu app, consulta la charla Mejora la experiencia del usuario de tu app para Android de Google I/O.

Vistas previas de widgets más enriquecidas con la API de Generated Previews

Antes de Android 15, la única forma de proporcionar vistas previas del selector de widgets era especificar un recurso de imagen o diseño estático. Estas vistas previas suelen diferir significativamente del aspecto del widget real cuando se coloca en la pantalla principal. Además, no se pueden crear recursos estáticos con Jetpack Glance, por lo que un vistazo desarrollador tuvo que hacer una captura de pantalla de su widget o crear un diseño XML para tener una vista previa del widget.

Android 15 agrega compatibilidad con vistas previas generadas. Esto significa que el widget de la app los proveedores pueden generar RemoteViews para usar como vista previa del selector, en lugar de un recurso estático.

Las apps pueden proporcionar vistas remotas al selector de widgets para que puedan actualizar el contenido del selector para que sea más representativo de lo que verá el usuario.

API de Push

Las apps pueden proporcionar vistas previas generadas a través de una API de push. Las apps pueden proporcionar vistas previas en cualquier momento de su ciclo de vida y no reciben una solicitud explícita del host para proporcionarlas. Las vistas previas se conservan en AppWidgetService, y los hosts pueden solicitarlas a pedido. En el siguiente ejemplo, se carga un recurso de diseño de widget XML y se establece como la vista previa:

AppWidgetManager.getInstance(appContext).setWidgetPreview(
   ComponentName(
       appContext,
       SociaLiteAppWidgetReceiver::class.java
   ),
   AppWidgetProviderInfo.WIDGET_CATEGORY_HOME_SCREEN,
   RemoteViews("com.example", R.layout.widget_preview)
)

El flujo esperado es el siguiente:

En cualquier momento, el proveedor de widgets llama a setWidgetPreview. El valor proporcionado las vistas previas se conservan en AppWidgetService con otra información del proveedor
setWidgetPreview notifica a los hosts una vista previa actualizada a través de la devolución de llamada AppWidgetHost.onProvidersChanged. En respuesta, el host del widget vuelve a cargar toda la información del proveedor.
Cuando se muestra una vista previa del widget, el host verifica AppWidgetProviderInfo.generatedPreviewCategories y si el elemento elegido categoría está disponible, llama a AppWidgetManager.getWidgetPreview para mostrar la vista previa guardada para este proveedor.

Cuándo llamar a `setWidgetPreview`

Debido a que no hay devolución de llamada para proporcionar vistas previas, las apps pueden optar por enviar vistas previas en cualquier momento mientras se están ejecutando. La frecuencia con la que se actualiza la vista previa depende del caso de uso del widget.

En la siguiente lista, se describen las dos categorías principales de casos de uso de vista previa:

Los proveedores que muestran datos reales en las vistas previas de sus widgets, como los o información reciente. Estos proveedores pueden configurar la vista previa una vez que el usuario accede o realiza la configuración inicial en su app. Después de esto, pueden configurar una tarea periódica para actualizar las vistas previas en la cadencia que elijan. Algunos ejemplos de este tipo de widget son los de fotos, calendario, clima o noticias.
Proveedores que muestran información estática en vistas previas o widgets de acción rápida que no muestran ningún dato. Estos proveedores pueden establecer vistas previas una vez, cuando se inicia la app por primera vez. Algunos ejemplos de este tipo de widget son el widget de acciones rápidas de Drive o el widget de accesos directos de Chrome.

Algunos proveedores pueden mostrar vistas previas estáticas en el selector del modo Hub información del selector de la pantalla principal. Estos proveedores deben seguir las instrucciones para ambos casos de uso para configurar las vistas previas.

Pantalla en pantalla

Android 15 introduce cambios en la función pantalla en pantalla (PIP) que garantiza una transición más fluida cuando se ingresa al modo de PIP. Esto será beneficioso para apps con elementos de la IU superpuestos sobre su IU principal, que va en PIP.

Los desarrolladores usan la devolución de llamada onPictureInPictureModeChanged para definir la lógica que activa o desactiva la visibilidad de los elementos superpuestos de la IU. Esta devolución de llamada se activa cuando se completa la animación de entrada o salida de PiP. A partir de Android 15, la clase PictureInPictureUiState incluye otro estado.

Con este estado de la IU, las apps orientadas a Android 15 (nivel de API 35) observarán la Se invoca la devolución de llamada Activity#onPictureInPictureUiStateChanged con isTransitioningToPip() en cuanto comienza la animación de PIP. Existen muchos elementos de la IU que no son relevantes para la app cuando está en modo de PIP, por vistas o diseños de ejemplo que incluyen información como sugerencias, próximos videos, calificaciones y títulos. Cuando la app entre en modo de PIP, usa la Es la devolución de llamada onPictureInPictureUiStateChanged para ocultar estos elementos de la IU. Cuando la app cambia al modo de pantalla completa desde la ventana de PiP, usa la devolución de llamada onPictureInPictureModeChanged para mostrar estos elementos, como se muestra en los siguientes ejemplos:

override fun onPictureInPictureUiStateChanged(pipState: PictureInPictureUiState) {
        if (pipState.isTransitioningToPip()) {
          // Hide UI elements
        }
    }

override fun onPictureInPictureModeChanged(isInPictureInPictureMode: Boolean) {
        if (isInPictureInPictureMode) {
          // Unhide UI elements
        }
    }

Este botón de activación rápida de visibilidad de elementos irrelevantes de la IU (para una ventana de PIP) ayuda garantizar una animación de entrada de PIP más fluida y sin parpadeos.

Reglas de No interrumpir mejoradas

AutomaticZenRule 允许应用自定义注意力机制管理（勿扰）规则，并确定何时启用或停用。Android 15 极大地增强了这些规则，旨在提高用户体验。其中包含以下增强功能：

向 AutomaticZenRule 添加类型，让系统能够应用特殊类型对某些规则的处理
向 AutomaticZenRule 添加图标，使模式更加丰富易于识别。
将 triggerDescription 字符串添加到 AutomaticZenRule，用于描述规则应当对用户生效的条件。
已添加 ZenDeviceEffects 更改为AutomaticZenRule，从而允许规则触发灰度等操作显示、夜间模式或调暗壁纸。

Cómo configurar VibrationEffect para los canales de notificación

Android 15 supports setting rich vibrations for incoming notifications by channel using NotificationChannel.setVibrationEffect, so your users can distinguish between different types of notifications without having to look at their device.

Chip de la barra de estado de proyección de contenido multimedia y detención automática

Media projection can expose private user information. A new, prominent status bar chip makes users aware of any ongoing screen projection. Users can tap the chip to stop screen casting, sharing, or recording. Also, for a more intuitive user experience, any in‑progress screen projection now automatically stops when the device screen is locked.

Chip de la barra de estado para compartir pantalla, transmitir y grabar.

Pantallas grandes y factores de forma

Android 15 brinda a tus apps la compatibilidad necesaria para aprovechar al máximo los factores de forma de Android, incluidas las pantallas grandes, los dispositivos plegables y los que se pueden voltear.

Mejoras en la realización de tareas múltiples en pantallas grandes

Users can save their favorite split-screen app combinations for
quick access

Android 15 gives users better ways to multitask on large screen devices. For example, users can save their favorite split-screen app combinations for quick access and pin the taskbar on screen to quickly switch between apps. This means that making sure your app is adaptive is more important than ever.

Google I/O has sessions on Building adaptive Android apps and Building UI with the Material 3 adaptive library that can help, and our documentation has more to help you Design for large screens.

Compatibilidad con la pantalla de la cubierta

Tu app puede declarar una propiedad que Android 15 usa para permitir que tu Application o Activity se presente en las pantallas de portada pequeñas de los dispositivos plegables compatibles. Estas pantallas son demasiado pequeñas para considerarse objetivos compatibles en los que se ejecuten apps para Android, pero tu app puede admitirlas, lo que la hará disponible en más lugares.

Conectividad

Android 15 actualiza la plataforma para que tu app tenga acceso a los avances más recientes en tecnologías inalámbricas y de comunicación.

Compatibilidad con satélites

Android 15 继续扩大对卫星连接的平台支持，并包含一些界面元素，以确保在整个卫星连接环境中提供一致的用户体验。

应用可以使用 ServiceState.isUsingNonTerrestrialNetwork() 执行以下操作：检测设备是否连接到卫星，让他们更清楚地了解可能会导致完全网络服务不可用的原因此外，Android 15 支持短信和彩信应用以及预加载的 RCS 应用，以便使用卫星连接发送和接收消息。

Experiencias de NFC más fluidas

Android 15 正在努力打造更顺畅、更可靠的感应式付款体验，同时继续支持 Android 强大的 NFC 应用生态系统。在受支持的设备上，应用可以请求 NfcAdapter 进入观察模式，在该模式下，设备会监听但不会响应 NFC 读卡器，并将应用的 NFC 服务 PollingFrame 对象发送以进行处理。PollingFrame 对象可用于在与 NFC 读卡器进行首次通信之前进行身份验证，在许多情况下，这支持一触式交易。

此外，应用可以在受支持的设备上注册过滤器，以便在有轮询循环活动时收到通知，从而能够与多个感知 NFC 的应用顺畅运行。

Rol de la billetera

Android 15 presenta un rol de billetera que permite una integración más estrecha con la app de billetera preferida del usuario. Este rol reemplaza la configuración predeterminada de pago sin contacto de NFC. Los usuarios pueden administrar el titular del rol de la Billetera navegando a Configuración > Apps > Apps predeterminadas.

El rol de billetera se usa cuando se enrutan los toques NFC para los AID registrados en la categoría de pago. Los toques siempre se dirigen al titular del rol de la Billetera, a menos que otra app que esté registrada para el mismo AID se esté ejecutando en primer plano.

Este rol también se usa para determinar dónde debe ir la tarjeta de acceso rápido a la Billetera cuando se activa. Cuando el rol se establece en "Ninguno", la tarjeta de acceso rápido no está disponible y las presiones de NFC de la categoría de pago solo se entregan a la app en primer plano.

Seguridad

Android 15 te ayuda a mejorar la seguridad de tu app, proteger sus datos y brindarles a los usuarios más transparencia y control sobre sus datos. Para obtener más información sobre lo que estamos haciendo para mejorar las medidas de protección del usuario y proteger tu app contra nuevas amenazas, consulta la charla Safeguarding user security on Android de Google I/O.

Cómo integrar Credential Manager con el autocompletado

A partir de Android 15, los desarrolladores pueden vincular vistas específicas, como campos de nombre de usuario o contraseña, con solicitudes de Credential Manager, lo que facilita la prestación de una experiencia del usuario personalizada durante el proceso de acceso. Cuando el usuario se enfoca en una de estas vistas, se envía una solicitud correspondiente al Administrador de credenciales. Las credenciales resultantes se agregan en todos los proveedores y se muestran en las IU de resguardo de autocompletado, como las sugerencias intercaladas o desplegables. La biblioteca androidx.credentials de Jetpack es el extremo preferido que deben usar los desarrolladores y pronto estará disponible para mejorar aún más esta función en Android 15 y versiones posteriores.

Integra el acceso y el registro con un solo toque con solicitudes biométricas

El Administrador de credenciales integra mensajes biométricos en la creación de credenciales. y procesos de acceso, lo que elimina la necesidad de que los proveedores gestionen instrucciones biométricas. Como resultado, los proveedores de credenciales solo deben enfocarse en los resultados de los flujos de creación y obtención, junto con el resultado del flujo biométrico. Este proceso simplificado crea una credencial más eficiente y optimizada de creación y recuperación.

Administración de claves para la encriptación de extremo a extremo

Presentamos E2eeContactKeysManager en Android 15, que facilita la encriptación de extremo a extremo (E2EE) en tus apps para Android, ya que proporciona una API a nivel del SO para el almacenamiento de claves públicas criptográficas.

E2eeContactKeysManager está diseñado para integrarse a la app de contactos de la plataforma y brindarles a los usuarios una forma centralizada de administrar y verificar las claves públicas de sus contactos.

Verificaciones de permisos en URIs de contenido

Android 15 introduces a set of APIs that perform permission checks on content URIs:

Context.checkContentUriPermissionFull: This performs a full permission check on content URIs.
Activity manifest attribute requireContentUriPermissionFromCaller: This enforces specified permissions on the provided content URIs at activity launch.
ComponentCaller class for Activity callers: This represents the app that launched the activity.

Accesibilidad

Android 15 agrega funciones que mejoran la accesibilidad para los usuarios.

Mejoras en el braille

In Android 15, we've made it possible for TalkBack to support Braille displays that are using the HID standard over both USB and secure Bluetooth.

This standard, much like the one used by mice and keyboards, will help Android support a wider range of Braille displays over time.

Internacionalización

Android 15 agrega funciones y capacidades que complementan la experiencia del usuario cuando un dispositivo se usa en diferentes idiomas.

Fuente variable CJK

从 Android 15 开始，面向中文、日文和韩文 (CJK) 语言的字体文件 NotoSansCJK 现在是可变字体。可变字体为中日韩语言的创意排版提供了更多可能性。设计师可以探索更多样式的排版，并制作出以前难以实现或根本无法实现的视觉效果出色的布局。

Justificación entre caracteres

从 Android 15 开始，可以通过使用 JUSTIFICATION_MODE_INTER_CHARACTER。“字词间的理由”原为最初是在 Android 8.0（API 级别 26）中引入的， Justifications 功能为使用例如中文、日语等。

使用 JUSTIFICATION_MODE_NONE 的日语文本布局。

使用 JUSTIFICATION_MODE_NONE 的英语文本布局。

使用 JUSTIFICATION_MODE_INTER_WORD 的日语文本布局。

使用 JUSTIFICATION_MODE_INTER_WORD 的英语文本布局。

使用 JUSTIFICATION_MODE_INTER_CHARACTER 的日语文本布局。

使用 JUSTIFICATION_MODE_INTER_CHARACTER 的英语文本布局。

Configuración automática de saltos de línea

Android 从以下语言开始支持基于短语的日语和韩语换行： Android 13（API 级别 33）。不过，虽然基于短语的行分隔符可以提高短文本行的可读性，但对于长文本行，效果并不理想。在 Android 15 中，应用只能使用 LINE_BREAK_WORD_STYLE_AUTO 选项，针对短文本行应用基于短语的行分隔符。此选项会为文本选择最佳字词样式选项。

对于短文本行，则使用基于短语的换行符，功能相同为 LINE_BREAK_WORD_STYLE_PHRASE，如以下图片：

对于短文本行，`LINE_BREAK_WORD_STYLE_AUTO` 应用基于短语的换行符，以提高文本的可读性。这与应用 `LINE_BREAK_WORD_STYLE_PHRASE`。

对于较长的文本行，LINE_BREAK_WORD_STYLE_AUTO 会使用 no 换行字词样式， LINE_BREAK_WORD_STYLE_NONE，如以下图片：

对于较长的文本，`LINE_BREAK_WORD_STYLE_AUTO` 应用不换行的字词样式，以提高文本的可读性。这与应用 `LINE_BREAK_WORD_STYLE_NONE`。

Fuente adicional de Hentaigana japonés

En Android 15, se incluyó un archivo de fuente para el antiguo hiragana japonés (conocido como Hentaigana). se agrupa de forma predeterminada. Las formas únicas de los caracteres hentaigana pueden agregar un estilo distintivo al material gráfico o al diseño, a la vez que ayudan a preservar la transmisión y la comprensión precisas de los documentos japoneses antiguos.

Carácter y estilo de texto del hentaigana japonés fuente.

Vulkan 和 Vulkan 徽标是 Khronos Group Inc.的注册商标。

OpenGL 是注册商标，OpenGL ES 徽标是 Hewlett Packard Enterprise 的商标，已获得 Khronos 的许可。

Descripción general de las funciones y API Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Cámara y contenido multimedia

Mejora con poca luz

Controles de cámara integrados en la app

Control de margen de HDR

Control de volumen

Dispositivos MIDI 2.0 virtuales

Decodificación de software AV1 más eficiente

Productividad y herramientas para desarrolladores

Actualizaciones de OpenJDK 17

Mejoras en el PDF

Mejoras en el cambio automático de idioma

Se mejoró la API de fuentes variables de OpenType

Kotlin

Java

Kotlin

Java

Controles detallados de saltos de línea

Archivado de apps

Habilita el modo de 16 KB en un dispositivo con las opciones para desarrolladores

Gráficos

Modernización del acceso a la GPU de Android

Plan de ruta de ANGLE para Android en Vulkan

Próximos pasos recomendados

Mejoras en Canvas

Rendimiento y batería

API de ApplicationStartInfo

Información detallada sobre el tamaño de la app

Creación de perfiles administrada por la app

Mejoras en la base de datos SQLite

Actualizaciones del framework de rendimiento dinámico de Android

Privacidad

Detección de grabación de pantalla

Capacidades expandidas de IntentFilter

Espacio privado

Consulta la selección del usuario más reciente para el acceso a las fotos seleccionadas

Kotlin

Java

Privacy Sandbox en Android

Health Connect

Compartir pantalla de una app

Experiencia del usuario y la IU del sistema

Vistas previas de widgets más enriquecidas con la API de Generated Previews

API de Push

Cuándo llamar a setWidgetPreview

Pantalla en pantalla

Reglas de No interrumpir mejoradas

Cómo configurar VibrationEffect para los canales de notificación

Chip de la barra de estado de proyección de contenido multimedia y detención automática

Pantallas grandes y factores de forma

Mejoras en la realización de tareas múltiples en pantallas grandes

Compatibilidad con la pantalla de la cubierta

Conectividad

Compatibilidad con satélites

Experiencias de NFC más fluidas

Rol de la billetera

Seguridad

Cómo integrar Credential Manager con el autocompletado

Integra el acceso y el registro con un solo toque con solicitudes biométricas

Administración de claves para la encriptación de extremo a extremo

Verificaciones de permisos en URIs de contenido

Accesibilidad

Mejoras en el braille

Internacionalización

Fuente variable CJK

Justificación entre caracteres

Configuración automática de saltos de línea

Fuente adicional de Hentaigana japonés

Descripción general de las funciones y API

Cuándo llamar a `setWidgetPreview`