Se usó la API de Cloud Translation para traducir esta página.

IU de privacysandbox

Referencia de la API
androidx.privacysandbox.ui

PENDIENTE

Actualización más reciente	Versión estable	Versión potencial	Versión beta	Versión alfa
13 de noviembre de 2024	-	-	-	1.0.0-alpha11

Cómo declarar dependencias

Para agregar una dependencia en privacysandbox-ui, debes agregar el repositorio de Maven de Google a tu proyecto. Consulta el repositorio de Maven de Google para obtener más información.

Agrega las dependencias de los artefactos que necesites en el archivo build.gradle de tu app o módulo:

Groovy

dependencies {
    // Use to implement privacysandbox ui
    implementation "androidx.privacysandbox.ui:ui:1.0.0-alpha09"

    // Use to implement privacysandbox ui-core
    implementation "androidx.privacysandbox.ui:ui-core:1.0.0-alpha09"
   
    // Use to implement privacysandbox ui-core
    implementation "androidx.privacysandbox.ui:ui-provider:1.0.0-alpha09"
}

Kotlin

dependencies {
    // Use to implement privacysandbox ui
    implementation("androidx.privacysandbox.ui:ui:1.0.0-alpha09")

    // Use to implement privacysandbox ui-core
    implementation("androidx.privacysandbox.ui:ui-core:1.0.0-alpha09")

    // Use to implement privacysandbox ui-provider
    implementation("androidx.privacysandbox.ui:ui-provider:1.0.0-alpha09")

    
}

Para obtener más información sobre las dependencias, consulta Cómo agregar dependencias de compilación.

Comentarios

Tus comentarios ayudan a mejorar Jetpack. Avísanos si descubres nuevos errores o tienes ideas para mejorar esta biblioteca. Consulta los errores existentes de esta biblioteca antes de crear uno nuevo. Puedes agregar tu voto a un error existente haciendo clic en el botón de la estrella.

Crear un error nuevo

Consulta la documentación sobre la Herramienta de seguimiento de errores para obtener más información.

Versión 1.0

Versión 1.0.0-alpha11

13 de noviembre de 2024

Lanzamiento de androidx.privacysandbox.ui:ui-client:1.0.0-alpha11, androidx.privacysandbox.ui:ui-core:1.0.0-alpha11 y androidx.privacysandbox.ui:ui-provider:1.0.0-alpha11. La versión 1.0.0-alpha11 contiene estas confirmaciones.

Nuevas funciones

Se introdujo una API experimental, DelegatingSandboxedUiAdapter, que extiende SandboxedUiAdapter y se puede usar para delegar entre diferentes SandboxedUiAdapters. Cuando este adaptador se configura en un contenedor de cliente, como SandboxedSdkView, el adaptador de delegación puede cambiar el adaptador delegado con updateDelegate. Esto cerrará la sesión existente y creará un SandboxedUiAdapter.Session nuevo para el delegado nuevo. Esto permite transiciones fluidas entre delegados. (I5f1c5, I9e3e7).
Se agregó una mejor compatibilidad con SandboxedSdkView para el padding. (Ic414f).

Correcciones de errores

Se corrigió el NullPointerException que podía ocurrir en un evento de diseño global.

Versión 1.0.0-alpha10

18 de septiembre de 2024

Lanzamiento de androidx.privacysandbox.ui:ui-client:1.0.0-alpha10, androidx.privacysandbox.ui:ui-core:1.0.0-alpha10 y androidx.privacysandbox.ui:ui-provider:1.0.0-alpha10. La versión 1.0.0-alpha10 contiene estas confirmaciones.

Nuevas funciones

Se actualizó la lógica de apertura de la sesión para que solo se abra una sesión dentro de un SandboxedSdkView si la ventana que contiene el SandboxedSdkView es visible.
Se actualizó la lógica de SessionObserver para enviar onUiContainerChanged cuando cambia la visibilidad de la ventana que contiene el SandboxedSdkView.

Correcciones de errores

Invoca onUiContainerChanged cuando cambia la visibilidad de la ventana (I541cf).
Se quitó el esquema manual de acceso a las nuevas APIs de la plataforma, ya que esto se realiza automáticamente a través del modelado de API cuando se usa R8 con AGP 7.3 o versiones posteriores (p.ej., R8 versión 3.3) y para todas las compilaciones cuando se usa AGP 8.1 o versiones posteriores (p.ej., D8 versión 8.1). Se recomienda a los clientes que no usen AGP que actualicen a la versión 8.1 de D8 o una posterior. Consulta este artículo para obtener más detalles. (If6b4c, b/345472586).

Versión 1.0.0-alpha09

26 de junio de 2024

Lanzamiento de androidx.privacysandbox.ui:ui-client:1.0.0-alpha09, androidx.privacysandbox.ui:ui-core:1.0.0-alpha09 y androidx.privacysandbox.ui:ui-provider:1.0.0-alpha09. La versión 1.0.0-alpha09 contiene estas confirmaciones.

Nuevas funciones

Se introdujeron las clases abstractas AbstractSandboxedUiAdapter y AbstractSandboxedUiAdapter.AbstractSession que los proveedores de IU pueden usar para evitar implementar todas las interfaces SandboxedUiAdapter o Session. Se recomienda que los proveedores de IU usen estas clases abstractas.
Se agregó una lógica registerObserverFactory que permite que un SessionObserverFactory se adjunte a un SandboxedUiAdapter. Cuando se conecta un SessionObserverFactory a un adaptador, se crea un SessionObserver para cada sesión de IU nueva que se crea para ese adaptador. El SessionObserver creado recibirá una devolución de llamada de onSessionOpened cuando se abra la sesión de la IU. Cuando cambie la presentación de la IU de la vista de Session, se llamará a SessionObserver.onUiContainerChanged. onUiContainerChanged se limita y se llamará como máximo cada 200 ms.
Se agregó SandboxedSdkViewUiInfo, que se puede crear a partir del Bundle enviado en SessionObserver.onUiContainerChanged. Este objeto representa el estado de la IU del SandboxedSdkView que aloja la sesión de la IU. Contiene información de altura y ancho, un Rect que representa la geometría de la vista que es visible en la pantalla y una sugerencia de opacidad que representa la opacidad de la vista.

Cambios en la API

Agrega una sugerencia de opacidad a SandboxedSdkViewUiInfo. (I093ac).
Se agregaron SessionObserver.onUiContainerChanged y SandboxedSdkViewUiInfo. (Ie98bc).
Se agregó la interfaz y la lógica de registro de SessionObserver. (I047dc).
Agrega AbstractSandboxedUiAdapter y AbstractSession. (I3617a)

Errores conocidos

Cuando el proveedor de la IU está en el mismo proceso que la aplicación cliente, no se envía SessionObserver.onUiContainerChanged cuando se desplaza el contenedor.

Versión 1.0.0-alpha08

14 de mayo de 2024

Lanzamiento de androidx.privacysandbox.ui:ui-client:1.0.0-alpha08, androidx.privacysandbox.ui:ui-core:1.0.0-alpha08 y androidx.privacysandbox.ui:ui-provider:1.0.0-alpha08. La versión 1.0.0-alpha08 contiene estas confirmaciones.

Nuevas funciones

Se agregó compatibilidad para usar SandboxedSdkView dentro de un PoolingContainer, como un RecyclerView. Cuando un SandboxedSdkView tiene un elemento superior que es un PoolingContainer, el ciclo de vida de sus sesiones de IU se alineará con el de PoolingContainer para garantizar que la sesión pueda persistir a través de la separación de la ventana.

Cambios en la API

APIs de actividad de Privacy Sandbox obsoletas Ahora, estas APIs se pueden encontrar en la biblioteca de Activity androidx.privacysandbox.activity dedicada. (I68beb).

Correcciones de errores

Se corrigió el error de renderización cuando se mostraba contenido remoto dentro de contenedores de agrupación. (I804df).
Se corrigió un error que causaba problemas de renderización para ViewGroups en el modo de retrocompatibilidad. (I8de92).
Cuando uno de los elementos superiores de SandboxedSdkView es un PoolingContainer, cierra la sesión de la IU cuando PoolingContainer indique que se pueden liberar los recursos, en lugar de hacerlo cuando se desconecta la ventana. (I2046b)

Contribución externa

GestureDetectorCompat dejó de estar disponible, ya que GestureDetector está disponible en minSdk. (Icc4cd).

Versión 1.0.0-alpha07

18 de octubre de 2023

Lanzamiento de androidx.privacysandbox.ui:ui-client:1.0.0-alpha07, androidx.privacysandbox.ui:ui-core:1.0.0-alpha07 y androidx.privacysandbox.ui:ui-provider:1.0.0-alpha07. La versión 1.0.0-alpha07 contiene estas confirmaciones.

Nuevas funciones

Se agregó compatibilidad con versiones anteriores para la biblioteca. En el nivel de API 33 y versiones anteriores, la vista del proveedor se renderizará dentro del proceso de la app, en un cargador de clases diferente. (If0b7a).
Se agregó una lógica que permite que el cambio de tamaño de los contenedores de host y proveedor se confirme en el mismo marco para evitar bloqueos visibles de la IU. (Ic2cd9)

Cambios en la API

Se actualizó el MinSdk de la biblioteca al nivel de API 21. (I474b8).

Versión 1.0.0-alpha06

20 de septiembre de 2023

Lanzamiento de androidx.privacysandbox.ui:ui-client:1.0.0-alpha06, androidx.privacysandbox.ui:ui-core:1.0.0-alpha06 y androidx.privacysandbox.ui:ui-provider:1.0.0-alpha06. La versión 1.0.0-alpha06 contiene estas confirmaciones.

Nuevas funciones

Se agregó lógica para recortar SandboxedSdkView en la vista "superior de límite" en la que puede desplazarse. Esto garantiza que el contenido de SandboxedSdkView no oculte otras vistas ni componentes de la IU fuera de la vista de contenido raíz. (I9ea94).

Cambios en la API

Se cambió el nombre de SandboxedSdkView.setZOrderOnTopAndEnableUserInteraction por orderProviderUiAboveClientUi (Iecb7e).

Correcciones de errores

Envía el valor correcto del orden en Z al host. (Ib0ddf).
Solo transfiere el enfoque táctil para los desplazamientos o deslizamientos verticales. (I0528c)

Versión 1.0.0-alpha05

9 de agosto de 2023

Lanzamiento de androidx.privacysandbox.ui:ui-client:1.0.0-alpha05, androidx.privacysandbox.ui:ui-core:1.0.0-alpha05 y androidx.privacysandbox.ui:ui-provider:1.0.0-alpha05. La versión 1.0.0-alpha05 contiene estas confirmaciones.

Nuevas funciones

Se agregó lógica para transferir el enfoque táctil al host en los gestos de desplazamiento y arrastre que se originan en SandboxedSdkView. Esto permite que la IU del proveedor de host de contenedor desplazable del cliente responda correctamente a los desplazamientos y deslizamientos.

Cambios en la API

Se agregó el parámetro windowInputToken a SandboxedUiAdapter (Ief578).

Correcciones de errores

Se estableció el estado de la sesión como activo después del primer sorteo (I36f3f).
Se corrigió el problema de diseño con SandboxedSdkView. (I09cb8).
Se agregó lógica para transferir el enfoque táctil al host. (I33b54).
Se agregó el parámetro windowInputToken a SandboxedUiAdapter. Esto es necesario para garantizar que el token de SurfaceControlViewHost esté asociado correctamente con el host de la jerarquía incorporada. (Ief578).
Ejecuta notifyResized dentro del subproceso principal. (I62440).
Se corrigió una falla en el flujo de Session.close(). (I5392e).

Versión 1.0.0-alpha04

21 de junio de 2023

Lanzamiento de androidx.privacysandbox.ui:ui-client:1.0.0-alpha04, androidx.privacysandbox.ui:ui-core:1.0.0-alpha04 y androidx.privacysandbox.ui:ui-provider:1.0.0-alpha04. La versión 1.0.0-alpha04 contiene estas confirmaciones.

Nuevas funciones

Presenta el SdkActivityLauncher. Es una interfaz para permitir que los SDKs habilitados para el entorno de ejecución inicien actividades. (I5b3dc)

Correcciones de errores

Se corrigió la condición de carrera de notifyZOrderChanged. Garantiza que se notifique al proveedor de la IU sobre todos los cambios en el orden en Z. No se notificará explícitamente al proveedor de la IU si se cambia el orden en Z de SandboxedSdkView antes de invocar openSession.

Versión 1.0.0-alpha03

24 de mayo de 2023

Lanzamiento de androidx.privacysandbox.ui:ui-client:1.0.0-alpha03, androidx.privacysandbox.ui:ui-core:1.0.0-alpha03 y androidx.privacysandbox.ui:ui-provider:1.0.0-alpha03. La versión 1.0.0-alpha03 contiene estas confirmaciones.

Nuevas funciones

StateChangedListener informa a la aplicación los cambios en la sesión de la IU.

Cambios en la API

Se agregó StateChangedListener para reemplazar ErrorConsumer (Icd5d3).

Correcciones de errores

Se corrigió la condición de carrera notifyZOrderChanged para que se notifique al proveedor de la IU sobre todos los cambios de orden en Z.

Versión 1.0.0-alpha02

19 de abril de 2023

Lanzamiento de androidx.privacysandbox.ui:ui-client:1.0.0-alpha02, androidx.privacysandbox.ui:ui-core:1.0.0-alpha02 y androidx.privacysandbox.ui:ui-provider:1.0.0-alpha02. La versión 1.0.0-alpha02 contiene estas confirmaciones.

Correcciones de errores

Se inhabilitó la prueba de inconsistencias de ChangingSandboxedSdkViewLayoutChangesChildLayout.

Versión 1.0.0-alpha01

8 de marzo de 2023

Lanzamiento de androidx.privacysandbox.ui:ui-client:1.0.0-alpha01, androidx.privacysandbox.ui:ui-core:1.0.0-alpha01 y androidx.privacysandbox.ui:ui-provider:1.0.0-alpha01. La versión 1.0.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

Estas son bibliotecas de Jetpack nuevas que las aplicaciones y los SDKs habilitados para el entorno de ejecución (Privacy Sandbox) pueden usar para permitir que la aplicación (cliente) aloje cualquier IU que proporcione el SDK (proveedor).