このページは Cloud Translation API によって翻訳されました。

privacysandbox UI

ToDo

最新の更新	安定版リリース	リリース候補版	ベータ版リリース	アルファ版リリース
2024 年 6 月 26 日	-	-	-	1.0.0-alpha09

依存関係の宣言

privacysandbox-ui への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

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")

    
}

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

バージョン 1.0

バージョン 1.0.0-alpha09

2024 年 6 月 26 日

androidx.privacysandbox.ui:ui-client:1.0.0-alpha09、androidx.privacysandbox.ui:ui-core:1.0.0-alpha09、androidx.privacysandbox.ui:ui-provider:1.0.0-alpha09 がリリースされました。バージョン 1.0.0-alpha09 に含まれる commit については、こちらをご覧ください。

新機能

UI プロバイダが SandboxedUiAdapter インターフェースまたは Session インターフェース全体の実装を回避するために使用できる、AbstractSandboxedUiAdapter および AbstractSandboxedUiAdapter.AbstractSession 抽象クラスを導入しました。UI プロバイダでは、これらの抽象クラスを使用することをおすすめします。
SessionObserverFactory を SandboxedUiAdapter にアタッチできるようにする registerObserverFactory ロジックを追加しました。SessionObserverFactory がアダプターに接続されると、そのアダプターに対して作成された新しい UI セッションごとに SessionObserver が作成されます。作成された SessionObserver は、UI セッションが開始すると onSessionOpened コールバックを受け取ります。Session のビューの UI 表示が変更されると、SessionObserver.onUiContainerChanged が呼び出されます。onUiContainerChanged はスロットリングされ、最大で 200 ミリ秒ごとに呼び出されます。
SessionObserver.onUiContainerChanged で送信された Bundle から作成できる SandboxedSdkViewUiInfo を追加しました。このオブジェクトは、UI セッションをホストしている SandboxedSdkView の UI 状態を表します。高さと幅の情報、画面に表示されるビューのジオメトリを表す Rect、ビューの不透明度を表す不透明度のヒントが含まれます。

API の変更

SandboxedSdkViewUiInfo に不透明度のヒントを追加。（I093ac）。
SessionObserver.onUiContainerChanged と SandboxedSdkViewUiInfo を追加します。（Ie98bc）。
SessionObserver インターフェースと登録ロジックを追加。（I047dc）。
AbstractSandboxedUiAdapter と AbstractSession を追加します。（I3617a）。

既知の問題

UI プロバイダがクライアントアプリケーションと同じプロセスにある場合、コンテナのスクロール時に SessionObserver.onUiContainerChanged は送信されません。

バージョン 1.0.0-alpha08

2024 年 5 月 14 日

androidx.privacysandbox.ui:ui-client:1.0.0-alpha08、androidx.privacysandbox.ui:ui-core:1.0.0-alpha08、androidx.privacysandbox.ui:ui-provider:1.0.0-alpha08 がリリースされました。バージョン 1.0.0-alpha08 に含まれる commit については、こちらをご覧ください。

新機能

RecyclerView などの PoolingContainer 内で SandboxedSdkView を使用するためのサポートを追加しました。SandboxedSdkView の親が PoolingContainer の場合、その UI セッションのライフサイクルは PoolingContainer のライフサイクルに合わせて調整され、ウィンドウのデタッチ後もセッションが維持されるようになります。

API の変更

プライバシーサンドボックスのアクティビティ API のサポートが終了しました。これらの API は、専用のアクティビティライブラリ androidx.privacysandbox.activity で入手できるようになりました。（I68beb）。

バグの修正

プーリングコンテナ内でリモートコンテンツを表示するときのレンダリングのバグを修正しました。（I804df）。
下位互換性モードで ViewGroups のレンダリングの問題の原因となっていたバグを修正しました。（I8de92）。
SandboxedSdkView の親の 1 つが PoolingContainer の場合、PoolingContainer がリソースを解放できることが示されたら、ウィンドウのデタッチではなく、UI セッションを閉じます。（I2046b）。

外部からの協力

minSdk から GestureDetector が利用できるようになったため、GestureDetectorCompat のサポートが終了しました。（Icc4cd）。

バージョン 1.0.0-alpha07

2023 年 10 月 18 日

androidx.privacysandbox.ui:ui-client:1.0.0-alpha07、androidx.privacysandbox.ui:ui-core:1.0.0-alpha07、androidx.privacysandbox.ui:ui-provider:1.0.0-alpha07 がリリースされました。バージョン 1.0.0-alpha07 に含まれる commit については、こちらをご覧ください。

新機能

ライブラリの下位互換性のサポートを追加しました。API 33 以前では、プロバイダのビューはアプリプロセス内の別のクラスローダーでレンダリングされます。（If0b7a）。
表示される UI ジャンクを回避するために、ホストコンテナとプロバイダコンテナのサイズ変更を同じフレームで commit できるようにするロジックを追加しました。（Ic2cd9）。

API の変更

ライブラリの MinSdk が API 21 に引き上げられました。（I474b8）。

バージョン 1.0.0-alpha06

2023 年 9 月 20 日

androidx.privacysandbox.ui:ui-client:1.0.0-alpha06、androidx.privacysandbox.ui:ui-core:1.0.0-alpha06、androidx.privacysandbox.ui:ui-provider:1.0.0-alpha06 がリリースされました。バージョン 1.0.0-alpha06 に含まれる commit については、こちらをご覧ください。

新機能

SandboxedSdkView をスクロールできる「境界となる親」ビューにクリップするロジックを追加しました。これにより、SandboxedSdkView のコンテンツによって、ルートコンテンツビュー外の他のビューや UI コンポーネントが隠れることがなくなります。（I9ea94）。

API の変更

SandboxedSdkView.setZOrderOnTopAndEnableUserInteraction の名前を orderProviderUiAboveClientUi に変更しました。（Iecb7e）

バグの修正

正しい Z オーダー値をホストに送信します。（Ib0ddf）。
縦スクロール/フリングの場合のみ、タップフォーカスを転送します。（I0528c）。

バージョン 1.0.0-alpha05

2023 年 8 月 9 日

androidx.privacysandbox.ui:ui-client:1.0.0-alpha05、androidx.privacysandbox.ui:ui-core:1.0.0-alpha05、androidx.privacysandbox.ui:ui-provider:1.0.0-alpha05 がリリースされました。バージョン 1.0.0-alpha05 に含まれる commit については、こちらをご覧ください。

新機能

SandboxedSdkView からのスクロール操作とフリング操作でタップフォーカスをホストに転送するロジックを追加しました。これにより、クライアントのスクロール可能なコンテナホスティングプロバイダの UI がスクロールとフリングに正しく応答できます。

API の変更

windowInputToken パラメータを SandboxedUiAdapter に追加しました。（Ief578）

バグの修正

最初の描画後にセッション状態をアクティブに設定（I36f3f）
SandboxedSdkView でのレイアウトの問題を修正。（I09cb8）。
タップフォーカスをホストに転送するロジックを追加しました。（I33b54）。
windowInputToken パラメータを SandboxedUiAdapter に追加します。これは、SurfaceControlViewHost のトークンが埋め込み階層のホストに正しく関連付けられていることを確認するために必要です。（Ief578）。
メインスレッド内で notifyResized を実行します。（I62440）。
Session.close() フローのクラッシュを修正。（I5392e）。

バージョン 1.0.0-alpha04

2023 年 6 月 21 日

androidx.privacysandbox.ui:ui-client:1.0.0-alpha04、androidx.privacysandbox.ui:ui-core:1.0.0-alpha04、androidx.privacysandbox.ui:ui-provider:1.0.0-alpha04 がリリースされました。バージョン 1.0.0-alpha04 に含まれる commit については、こちらをご覧ください。

新機能

SdkActivityLauncher を紹介します。ランタイム対応 SDK がアクティビティを起動できるようにするためのインターフェース。（I5b3dc）。

バグの修正

notifyZOrderChanged の競合状態を修正。すべての Z オーダーの変更について UI プロバイダが通知されるようにします。openSession が呼び出される前に SandboxedSdkView の Z オーダーが変更されても、UI プロバイダには明示的に通知されません。

バージョン 1.0.0-alpha03

2023 年 5 月 24 日

androidx.privacysandbox.ui:ui-client:1.0.0-alpha03、androidx.privacysandbox.ui:ui-core:1.0.0-alpha03、androidx.privacysandbox.ui:ui-provider:1.0.0-alpha03 がリリースされました。バージョン 1.0.0-alpha03 に含まれる commit については、こちらをご覧ください。

新機能

StateChangedListener が UI セッションの変更をアプリに通知します。

API の変更

ErrorConsumer を置き換えるために StateChangedListener を追加しました（Icd5d3）

バグの修正

すべての Z オーダーの変更について UI プロバイダが通知されるように notifyZOrderChanged 競合状態を修正しました。

バージョン 1.0.0-alpha02

2023 年 4 月 19 日

androidx.privacysandbox.ui:ui-client:1.0.0-alpha02、androidx.privacysandbox.ui:ui-core:1.0.0-alpha02、androidx.privacysandbox.ui:ui-provider:1.0.0-alpha02 がリリースされました。バージョン 1.0.0-alpha02 に含まれる commit については、こちらをご覧ください。

バグの修正

testModifySandboxedSdkViewLayoutChangesChildLayout テストのフレーキングを無効にしました

バージョン 1.0.0-alpha01

2023 年 3 月 8 日

androidx.privacysandbox.ui:ui-client:1.0.0-alpha01、androidx.privacysandbox.ui:ui-core:1.0.0-alpha01、androidx.privacysandbox.ui:ui-provider:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

これらは新しい Jetpack ライブラリで、アプリとランタイム対応 SDK（プライバシーサンドボックス）は、SDK（プロバイダ）が提供する UI をアプリ（クライアント）でホストするために使用できます。