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

IU de Privacy Sandbox

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
26 de junio de 2024	-	-	-	1.0.0-alpha09

Cómo declarar dependencias

Para agregar una dependencia en privacysandbox-ui, debes agregar el repositorio de Maven de Google a tu proyecto. Lee 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-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 la implementación de todas las interfaces SandboxedUiAdapter o Session. Se recomienda que los proveedores de IU usen estas clases abstractas.
Se agregó lógica registerObserverFactory que permite adjuntar un SessionObserverFactory a un SandboxedUiAdapter. Cuando se conecta un SessionObserverFactory a un adaptador, se creará un SessionObserver para cada sesión de IU nueva que se cree para ese adaptador. El SessionObserver creado recibirá una devolución de llamada 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 está limitado 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, una Rect que representa la geometría de la vista que se ve en la pantalla y una sugerencia de opacidad que representa la opacidad de la vista.

Cambios en la API

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

Errores conocidos

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

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 elemento SandboxedSdkView tiene un elemento superior que es un PoolingContainer, el ciclo de vida de las sesiones de su IU se alineará con el de PoolingContainer para garantizar que la sesión pueda persistir a través de la desconexión de ventanas.

Cambios en la API

Se dieron de baja las APIs de actividad de Privacy Sandbox. Estas APIs ahora se pueden encontrar en la biblioteca de actividades dedicada androidx.privacysandbox.activity. (I68beb).

Correcciones de errores

Se corrigió el error de renderización que se producía cuando se mostraba contenido remoto dentro de contenedores de agrupación. (I804df).
Se corrigió un error que causaba problemas de renderización de ViewGroups en el modo de retrocompatibilidad. (I8de92).
Cuando uno de los elementos superiores de SandboxedSdkView sea PoolingContainer, cierra la sesión de la IU cuando PoolingContainer indique que los recursos se pueden liberar, en lugar de hacerlo cuando se desconecta una 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ó lógica que permite que el cambio de tamaño de los contenedores de host y proveedor se confirme en el mismo fotograma para evitar bloqueos visibles de la IU. (Ic2cd9).

Cambios en la API

MinSdk para la biblioteca se actualizó 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 a la vista "superior delimitadora" en la que se puede desplazar. De esta manera, se garantiza que el contenido de SandboxedSdkView no ocluya otras vistas ni ningún componente 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 de orden Z correcto al host. (Ib0ddf).
Transfiere solo el enfoque táctil para los desplazamientos o los gestos 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 gestos de desplazamiento y deslizamiento que se originan en SandboxedSdkView Esto permite que la IU del proveedor de hosting de contenedores 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 Activa después de la primera apertura. (I36f3f)
Se corrigió el problema de diseño de SandboxedSdkView. (I09cb8).
Se agregó lógica para transferir el enfoque táctil al host. (I33b54).
Agrega el parámetro windowInputToken a SandboxedUiAdapter. Esto es necesario para garantizar que el token de SurfaceControlViewHost esté correctamente asociado con el host de la jerarquía incorporada. (Ief578).
Ejecuta notifyResized dentro del subproceso principal. (I62440).
Se corrigió la 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 elemento SdkActivityLauncher. 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 notifyZOrderChanged. Garantiza que el proveedor de la IU reciba notificaciones de todos los cambios de orden en Z. El proveedor de la IU no recibirá una notificación explícita si se cambia el orden en Z de SandboxedSdkView antes de que se invoque 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 de 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 el proveedor de la IU reciba notificaciones de 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 testChangeSandboxedSdkViewLayoutChangesChildLayout.

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 nuevas bibliotecas de Jetpack 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 proporcionada por el SDK (proveedor).