privacysandbox ui

  
Aufgaben
Letzte Aktualisierung Stabile Version Releasekandidat Beta-Ausgabe Alphaversion
20. Mai 2025 - – - 1.0.0-alpha16

Abhängigkeiten deklarieren

Wenn Sie eine Abhängigkeit von privacysandbox-ui hinzufügen möchten, müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.

Fügen Sie der Datei build.gradle für Ihre App oder Ihr Modul die Abhängigkeiten für die erforderlichen Artefakte hinzu:

Groovy

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

    // Use to implement privacysandbox ui-core
    implementation "androidx.privacysandbox.ui:ui-core:1.0.0-alpha16"

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

Kotlin

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

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

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

    
}

Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Bitte teilen Sie uns mit, wenn Sie neue Probleme feststellen oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können einer vorhandenen Anfrage Ihre Stimme geben, indem Sie auf die Schaltfläche mit dem Stern klicken.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Version 1.0

Version 1.0.0-alpha16

20. Mai 2025

androidx.privacysandbox.ui:ui-*:1.0.0-alpha16 wird veröffentlicht. Version 1.0.0-alpha16 enthält diese Commits.

Neue Funktionen

  • Es wurde Logik zum Messen von Hindernissen auf SandboxedSdkView hinzugefügt. Diese werden in SessionObserver.onUiContainerChanged() gesendet, wenn SandboxedUiAdapterSignalOptions.OBSTRUCTIONS in der zugehörigen SessionObserverFactory.signalOptions enthalten ist. Hindernisse werden relativ zur Ansicht selbst gemeldet.

API-Änderungen

  • SandboxedSdkUi wurde von „ui-client“ in die neue Bibliothek „ui-client-compose“ verschoben.
  • Logik zum Messen von Hindernissen in UI-Containern hinzugefügt. (I34bea)

Fehlerkorrekturen

  • SandboxedSdkView.setAlpha() wurde korrigiert. Jetzt wird das Alpha der Inhaltsansicht aktualisiert.

Version 1.0.0-alpha15

26. März 2025

androidx.privacysandbox.ui:ui-client:1.0.0-alpha15, androidx.privacysandbox.ui:ui-core:1.0.0-alpha15 und androidx.privacysandbox.ui:ui-provider:1.0.0-alpha15 werden losgelassen. Version 1.0.0-alpha15 enthält diese Commits.

Neue Funktionen

  • Lege die Standard-Z-Reihenfolge von SandboxedSdkView und SandboxedSdkUi auf „unten“ fest. Damit wird angegeben, dass die Oberfläche des Anbieters jetzt unter dem Fenster des Clients platziert wird. Unterstützung für den UI-Anbieter hinzugefügt, um MotionEvents in diesem Modus zu empfangen, nachdem sie vom Clientfenster empfangen wurde.
  • Der SessionObserverFactory-Benutzeroberfläche wurde das Feld signalOptions hinzugefügt. Damit können Sie eine Reihe von Stringoptionen definieren, mit denen festgelegt wird, welche Signale für die zugehörige SessionObserver erfasst werden. Die anfänglichen Signale werden in SandboxedUiAdapterSignalOptions definiert. Wenn keine Signaloptionen festgelegt sind, werden nur SessionObserver.onSessionOpened() und SessionObserver.onSessionClosed() aufgerufen.

API-Änderungen

  • SessionConstants wurde in SandboxedUiAdapter.openSession() in SessionData umbenannt.

Bekannte Probleme

  • Wenn das SDK in der SDK-Laufzeit geladen wird und die Z-Reihenfolge von SandboxedSdkView oder SandboxedSdkUi „oben“ ist, wird die Geste ausschließlich vom Anbieterfenster empfangen und nicht mehr an das Clientfenster übertragen.

Version 1.0.0-alpha14

26. Februar 2025

androidx.privacysandbox.ui:ui-client:1.0.0-alpha14, androidx.privacysandbox.ui:ui-core:1.0.0-alpha14 und androidx.privacysandbox.ui:ui-provider:1.0.0-alpha14 werden losgelassen. Version 1.0.0-alpha14 enthält diese Commits.

Neue Funktionen

  • Sie können jetzt eine „gemeinsame Benutzeroberfläche“ erstellen, d.h. eine Benutzeroberfläche mit Elementen, die dem Kunden und dem Anbieter gehören. Die freigegebene Benutzeroberfläche kann mit SharedUiContainer gehostet werden, was ViewGroup erweitert. Die neuen APIs nutzen das Konzept der Sitzungsverwaltung, das der von SandboxedSdkView und SandboxedUiAdapter ähnelt.
  • Alle in diesem Release hinzugefügten APIs sind mit dem Flag SharedUiPresentationApi @RequiresOptIn gekennzeichnet.

API-Änderungen

  • SharedUiContainer hat jetzt APIs zur Sitzungsverwaltung und Asset-Registrierung. Die Sitzungsverwaltung wird mithilfe von SharedUiAdapter implementiert, das im selben Release eingeführt wurde. (Ic60b0)
  • SharedUiContainer hinzugefügt, mit dem vom Kunden und vom Anbieter erstellte Benutzeroberflächen gehostet werden können. Alle untergeordneten Ansichten werden links oben platziert. (Ia7310)
  • Unterstützung für die Abwärtskompatibilität mit SharedUiAdapter hinzugefügt. (I56d7a)
  • SharedUiAdapter wurde für die Sitzungsverwaltung von Ansichtscontainern hinzugefügt, die client- und anbietereigene Benutzeroberflächen hosten können. Die Logik der Sitzungsverwaltung ähnelt der von SandboxedUiAdapter. (I501f6)

Fehlerkorrekturen

  • Sichtbarkeit berechnen, wenn onVisibilityAggregated aufgerufen wird. (I91c69)

Bekannte Probleme

  • Wenn SharedUiContainer in einem PoolingContainer platziert ist, wird die Sitzung beim Trennen des Fensters geschlossen.

Version 1.0.0-alpha13

29. Januar 2025

androidx.privacysandbox.ui:ui-client:1.0.0-alpha13, androidx.privacysandbox.ui:ui-core:1.0.0-alpha13 und androidx.privacysandbox.ui:ui-provider:1.0.0-alpha13 werden losgelassen. Version 1.0.0-alpha13 enthält diese Commits.

Neue Funktionen

  • Es wurde ein composables Objekt namens SandboxedSdkUi hinzugefügt, mit dem Remote-Inhalte in der Compose-Benutzeroberfläche angezeigt werden können. Dieses Objekt nutzt vorhandene SandboxedSdkView-Konzepte für die Sitzungsverwaltung und Event-Listener. (I009cf)
  • Die SandboxedUiAdapter.openSession-Signatur wurde um einen neuen SessionConstants-Parameter erweitert, der den vorherigen windowInputToken ersetzt. Mit diesem Parameter werden Werte übergeben, die während der Lebensdauer der SandboxedUiAdapter.Session konstant bleiben. (Ibc0df, I28435)

Bekannte Probleme

  • SessionObserver-Ereignisse werden für SandboxedSdkUi nicht gesendet, wenn der Nutzer scrollt.
  • SandboxedSdkUi wird im Z-above-Modus nicht von übergeordneten Ansichten abgeschnitten.

API-Änderungen

  • Einstellung des SDKActivityLauncher-Codes (I49a4f)
  • Die Logik für die Registrierung von Beobachterfabriken wurde von SandboxedUiAdapter getrennt, indem eine neue SessionObserverFactoryRegistry-Schnittstelle hinzugefügt wurde. (I245cc)

Version 1.0.0-alpha12

11. Dezember 2024

androidx.privacysandbox.ui:ui-client:1.0.0-alpha12, androidx.privacysandbox.ui:ui-core:1.0.0-alpha12 und androidx.privacysandbox.ui:ui-provider:1.0.0-alpha12 werden losgelassen. Version 1.0.0-alpha12 enthält diese Commits.

Neue Funktionen

  • StateChangedListener wurde durch SandboxedSdkViewEventListener ersetzt. Mit diesem Ereignis-Listener können Sie Ereignisse für die Benutzeroberfläche, die Sitzungsschließung und Sitzungsfehler abhören.

API-Änderungen

  • Fügen Sie SandboxedSdkViewEventListener hinzu, um UI-Ereignisse in SandboxedSdkView zu überwachen. Mit dieser Version wird auch StateChangedListener entfernt. (Id71ea)

Fehlerkorrekturen

  • Die Logik für Begrenzungen für die Bildausschnitte wurde aus SandboxedSdkView entfernt. Dies führt zu UX-Problemen, wenn SandboxedSdkView in einen scrollbaren Container eingefügt wird und orderProviderUiAboveClientUi(false) nicht aufgerufen wurde, bis der zugrunde liegende Framework-Fehler behoben ist. (Id420d)
  • Behoben wurde ein RemoteException, der auftreten konnte, wenn der Remoteprozess bei Verwendung von DelegatingSandboxedUiAdapter beendet wurde.

Version 1.0.0-alpha11

13. November 2024

androidx.privacysandbox.ui:ui-client:1.0.0-alpha11, androidx.privacysandbox.ui:ui-core:1.0.0-alpha11 und androidx.privacysandbox.ui:ui-provider:1.0.0-alpha11 werden losgelassen. Version 1.0.0-alpha11 enthält diese Commits.

Neue Funktionen

  • Einführung der experimentellen API DelegatingSandboxedUiAdapter, die SandboxedUiAdapter erweitert und zum Delegieren zwischen verschiedenen SandboxedUiAdapters verwendet werden kann. Wenn dieser Adapter auf einem Clientcontainer wie SandboxedSdkView festgelegt ist, kann der delegierende Adapter den delegierten Adapter mit updateDelegate ändern. Dadurch wird die vorhandene Sitzung geschlossen und eine neue SandboxedUiAdapter.Session für den neuen Bevollmächtigten erstellt. So können Sie nahtlos zwischen den Delegierten wechseln. (I5f1c5, I9e3e7)
  • Bessere SandboxedSdkView-Unterstützung für Ränder hinzugefügt. (Ic414f)

Fehlerkorrekturen

  • Behobene NullPointerException, die bei einem globalen Layoutereignis auftreten konnten.

Version 1.0.0-alpha10

18. September 2024

androidx.privacysandbox.ui:ui-client:1.0.0-alpha10, androidx.privacysandbox.ui:ui-core:1.0.0-alpha10 und androidx.privacysandbox.ui:ui-provider:1.0.0-alpha10 werden losgelassen. Version 1.0.0-alpha10 enthält diese Commits.

Neue Funktionen

  • Die Logik zum Öffnen von Sitzungen wurde aktualisiert. Eine Sitzung wird jetzt nur in einem SandboxedSdkView geöffnet, wenn das Fenster mit dem SandboxedSdkView sichtbar ist.
  • Die SessionObserver-Logik wurde aktualisiert, damit onUiContainerChanged gesendet wird, wenn sich die Sichtbarkeit des Fensters mit der SandboxedSdkView ändert.

Fehlerkorrekturen

  • onUiContainerChanged wird aufgerufen, wenn sich die Sichtbarkeit des Fensters ändert (I541cf)
  • Die manuelle Kennzeichnung des Zugriffs auf neue Plattform-APIs wurde entfernt, da dies bei Verwendung von R8 mit AGP 7.3 oder höher (z.B. R8 Version 3.3) und für alle Builds bei Verwendung von AGP 8.1 oder höher (z.B. D8 Version 8.1) automatisch über die API-Modellierung erfolgt. Kunden, die AGP nicht verwenden, wird empfohlen, auf D8 Version 8.1 oder höher zu aktualisieren. Weitere Details findest du in diesem Artikel. (If6b4c, b/345472586)

Version 1.0.0-alpha09

26. Juni 2024

androidx.privacysandbox.ui:ui-client:1.0.0-alpha09, androidx.privacysandbox.ui:ui-core:1.0.0-alpha09 und androidx.privacysandbox.ui:ui-provider:1.0.0-alpha09 werden losgelassen. Version 1.0.0-alpha09 enthält diese Commits.

Neue Funktionen

  • Einführung der abstrakten Klassen AbstractSandboxedUiAdapter und AbstractSandboxedUiAdapter.AbstractSession, die von UI-Anbietern verwendet werden können, um die Implementierung der gesamten SandboxedUiAdapter- oder Session-Schnittstellen zu vermeiden. UI-Anbietern wird empfohlen, diese abstrakten Klassen zu verwenden.
  • Es wurde registerObserverFactory-Logik hinzugefügt, mit der ein SessionObserverFactory an ein SandboxedUiAdapter angehängt werden kann. Wenn eine SessionObserverFactory an einen Adapter angeschlossen ist, wird für jede neue UI-Sitzung, die für diesen Adapter erstellt wird, eine SessionObserver erstellt. Die erstellte SessionObserver erhält einen onSessionOpened-Callback, wenn die UI-Sitzung geöffnet wird. Wenn sich die Benutzeroberfläche der Ansicht von Session ändert, wird SessionObserver.onUiContainerChanged aufgerufen. onUiContainerChanged wird gedrosselt und maximal alle 200 ms aufgerufen.
  • SandboxedSdkViewUiInfo hinzugefügt, das aus den in SessionObserver.onUiContainerChanged gesendeten Bundle erstellt werden kann Dieses Objekt stellt den UI-Status des SandboxedSdkView dar, auf dem die UI-Sitzung gehostet wird. Es enthält Informationen zu Höhe und Breite, ein Rect, das die Geometrie der Ansicht darstellt, die auf dem Bildschirm sichtbar ist, und einen Hinweis zur Deckkraft, der die Deckkraft der Ansicht darstellt.

API-Änderungen

  • Fügen Sie SandboxedSdkViewUiInfo einen Hinweis zur Deckkraft hinzu. (I093ac)
  • Fügen Sie SessionObserver.onUiContainerChanged und SandboxedSdkViewUiInfo hinzu. (Ie98bc)
  • Fügen Sie die SessionObserver-Benutzeroberfläche und die Registrierungslogik hinzu. (I047dc)
  • Fügen Sie AbstractSandboxedUiAdapter und AbstractSession hinzu. (I3617a)

Bekannte Probleme

  • Wenn sich der UI-Anbieter im selben Prozess wie die Clientanwendung befindet, wird SessionObserver.onUiContainerChanged nicht gesendet, wenn der Container scrollt.

Version 1.0.0-alpha08

14. Mai 2024

androidx.privacysandbox.ui:ui-client:1.0.0-alpha08, androidx.privacysandbox.ui:ui-core:1.0.0-alpha08 und androidx.privacysandbox.ui:ui-provider:1.0.0-alpha08 werden losgelassen. Version 1.0.0-alpha08 enthält diese Commits.

Neue Funktionen

  • Unterstützung für die Verwendung von SandboxedSdkView in einem PoolingContainer wie einem RecyclerView hinzugefügt. Wenn ein SandboxedSdkView ein übergeordnetes PoolingContainer hat, wird der Lebenszyklus seiner UI-Sitzungen an den des PoolingContainer angepasst, damit die Sitzung auch nach dem Trennen des Fensters fortgesetzt werden kann.

API-Änderungen

  • Die eingestellten Privacy Sandbox Activity APIs. Diese APIs finden Sie jetzt stattdessen in der speziellen Bibliothek für Aktivitäten androidx.privacysandbox.activity. (I68beb)

Fehlerkorrekturen

  • Ein Fehler beim Rendern von Remote-Inhalten in Pooling-Containern wurde behoben. (I804df)
  • Ein Fehler wurde behoben, der im Abwärtskompatibilitätsmodus zu Renderingsproblemen für ViewGroups geführt hat. (I8de92)
  • Wenn eines der übergeordneten Elemente von SandboxedSdkView ein PoolingContainer ist, schließen Sie die UI-Sitzung, wenn das PoolingContainer angibt, dass Ressourcen freigegeben werden können, und nicht, wenn das Fenster getrennt wird. (I2046b)

Externer Beitrag

  • GestureDetectorCompat wird jetzt eingestellt, da GestureDetector über die minSdk verfügbar ist. (Icc4cd)

Version 1.0.0-alpha07

18. Oktober 2023

androidx.privacysandbox.ui:ui-client:1.0.0-alpha07, androidx.privacysandbox.ui:ui-core:1.0.0-alpha07 und androidx.privacysandbox.ui:ui-provider:1.0.0-alpha07 werden losgelassen. Version 1.0.0-alpha07 enthält diese Commits.

Neue Funktionen

  • Unterstützung für die Abwärtskompatibilität der Bibliothek hinzugefügt. Bei API 33 und niedriger wird die Ansicht des Anbieters im App-Prozess in einem anderen Classloader gerendert. (If0b7a)
  • Es wurde eine Logik hinzugefügt, mit der die Größe von Host- und Anbietercontainern im selben Frame festgelegt werden kann, um Ruckler in der Benutzeroberfläche zu vermeiden. (Ic2cd9)

API-Änderungen

  • MinSdk für die Bibliothek auf API 21 erhöht. (I474b8)

Version 1.0.0-alpha06

20. September 2023

androidx.privacysandbox.ui:ui-client:1.0.0-alpha06, androidx.privacysandbox.ui:ui-core:1.0.0-alpha06 und androidx.privacysandbox.ui:ui-provider:1.0.0-alpha06 werden losgelassen. Version 1.0.0-alpha06 enthält diese Commits.

Neue Funktionen

  • Es wurde Logik hinzugefügt, um SandboxedSdkView in der übergeordneten Ansicht zu zuschneiden, in der es gescrollt werden kann. So wird sichergestellt, dass die Inhalte des SandboxedSdkView keine anderen Ansichten oder UI-Komponenten außerhalb der Stamminhaltsansicht verdecken. (I9ea94)

API-Änderungen

  • SandboxedSdkView.setZOrderOnTopAndEnableUserInteraction in orderProviderUiAboveClientUi (Iecb7e) umbenennen

Fehlerkorrekturen

  • Senden Sie den richtigen Wert für die Z-Reihenfolge an den Host. (Ib0ddf)
  • Der Touch-Fokus wird nur bei vertikalem Scrollen/Wischen übertragen. (I0528c)

Version 1.0.0-alpha05

9. August 2023

androidx.privacysandbox.ui:ui-client:1.0.0-alpha05, androidx.privacysandbox.ui:ui-core:1.0.0-alpha05 und androidx.privacysandbox.ui:ui-provider:1.0.0-alpha05 werden losgelassen. Version 1.0.0-alpha05 enthält diese Commits.

Neue Funktionen

  • Es wurde Logik hinzugefügt, um den Touch-Fokus bei Scroll- und Wischgesten von SandboxedSdkView auf den Host zu übertragen. So kann die scrollbare Benutzeroberfläche des Container-Hostinganbieters des Clients richtig auf Scroll- und Wischaktionen reagieren.

API-Änderungen

  • windowInputToken-Parameter zu SandboxedUiAdapter hinzugefügt (Ief578)

Fehlerkorrekturen

  • Sitzungsstatus nach der ersten Auslosung auf „Aktiv“ setzen (I36f3f)
  • Layoutproblem mit SandboxedSdkView behoben (I09cb8)
  • Logik zum Übertragen des Touch-Fokus auf den Host hinzugefügt. (I33b54)
  • Fügen Sie SandboxedUiAdapter den Parameter windowInputToken hinzu. Das ist erforderlich, damit das Token von SurfaceControlViewHost dem Host der eingebetteten Hierarchie korrekt zugeordnet werden kann. (Ief578)
  • Führen Sie notifyResized im Hauptthread aus. (I62440)
  • Absturz im Session.close()-Ablauf behoben (I5392e)

Version 1.0.0-alpha04

21. Juni 2023

androidx.privacysandbox.ui:ui-client:1.0.0-alpha04, androidx.privacysandbox.ui:ui-core:1.0.0-alpha04 und androidx.privacysandbox.ui:ui-provider:1.0.0-alpha04 werden losgelassen. Version 1.0.0-alpha04 enthält diese Commits.

Neue Funktionen

  • Stellen Sie die SdkActivityLauncher vor. Eine Schnittstelle, mit der laufzeitfähige SDKs Aktivitäten starten können. (I5b3dc)

Fehlerkorrekturen

  • Korrigieren Sie die Race-Bedingung für notifyZOrderChanged. Der UI-Anbieter wird über alle Änderungen der Z-Reihenfolge informiert. Der UI-Anbieter wird nicht explizit benachrichtigt, wenn die Z-Reihenfolge des SandboxedSdkView vor dem Aufruf von „openSession“ geändert wird.

Version 1.0.0-alpha03

24. Mai 2023

androidx.privacysandbox.ui:ui-client:1.0.0-alpha03, androidx.privacysandbox.ui:ui-core:1.0.0-alpha03 und androidx.privacysandbox.ui:ui-provider:1.0.0-alpha03 werden losgelassen. Version 1.0.0-alpha03 enthält diese Commits.

Neue Funktionen

  • StateChangedListener informiert die Anwendung über Änderungen in der UI-Sitzung

API-Änderungen

  • StateChangedListener wurde anstelle von ErrorConsumer hinzugefügt (Icd5d3)

Fehlerkorrekturen

  • Behebung der notifyZOrderChanged-Race-Condition, damit der UI-Anbieter über alle Änderungen der Z-Reihenfolge benachrichtigt wird

Version 1.0.0-alpha02

19. April 2023

androidx.privacysandbox.ui:ui-client:1.0.0-alpha02, androidx.privacysandbox.ui:ui-core:1.0.0-alpha02 und androidx.privacysandbox.ui:ui-provider:1.0.0-alpha02 werden losgelassen. Version 1.0.0-alpha02 enthält diese Commits.

Fehlerkorrekturen

  • Deaktivierter Test für instabile Tests: ChangingSandboxedSdkViewLayoutChangesChildLayout

Version 1.0.0-alpha01

8. März 2023

androidx.privacysandbox.ui:ui-client:1.0.0-alpha01, androidx.privacysandbox.ui:ui-core:1.0.0-alpha01 und androidx.privacysandbox.ui:ui-provider:1.0.0-alpha01 werden losgelassen. Version 1.0.0-alpha01 enthält diese Commits.

Neue Funktionen

  • Dies sind neue Jetpack-Bibliotheken, die von Anwendungen und runtimefähigen SDKs (Privacy Sandbox) verwendet werden können, um die Anwendung (Client) jede vom SDK (Anbieter) bereitgestellte Benutzeroberfläche hosten zu lassen.