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

privacysandbox ui

TODO

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

依存関係の宣言

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-alpha12

2024 年 12 月 11 日

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

新機能

StateChangedListener が SandboxedSdkViewEventListener に変更されました。このイベントリスナーは、UI の表示、セッションの終了、セッションエラーのイベントをリッスンするために使用できます。

API の変更

SandboxedSdkView 内で UI イベントをリッスンするための SandboxedSdkViewEventListener を追加しました。このバージョンでは StateChangedListener も削除されます。（Id71ea）

バグの修正

SandboxedSdkView からクリッピング境界のロジックを削除しました。SandboxedSdkView がスクロール可能なコンテナに配置され、orderProviderUiAboveClientUi(false) が呼び出されていない場合、（基盤となるフレームワークのバグが修正されるまで）UX の問題が発生します。（Id420d）
DelegatingSandboxedUiAdapter の使用中にリモートプロセスが終了した場合に発生する可能性がある RemoteException を修正しました。

バージョン 1.0.0-alpha11

2024 年 11 月 13 日

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

新機能

SandboxedUiAdapter を拡張し、異なる SandboxedUiAdapters 間で委任に使用できる試験運用版 API DelegatingSandboxedUiAdapter を導入しました。このアダプターが SandboxedSdkView などのクライアントコンテナに設定されている場合、委任アダプターは updateDelegate を使用して委任アダプターを変更できます。これにより、既存のセッションが閉じられ、新しいデリゲート用の新しい SandboxedUiAdapter.Session が作成されます。これにより、デリゲート間のシームレスな遷移が可能になります。（I5f1c5、I9e3e7）
パディングの SandboxedSdkView サポートを改善しました。（Ic414f）

バグの修正

グローバルレイアウトイベントで発生する可能性のある NullPointerException を修正しました。

バージョン 1.0.0-alpha10

2024 年 9 月 18 日

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

新機能

セッションの開始ロジックを更新し、SandboxedSdkView を含むウィンドウが表示されている場合にのみ、SandboxedSdkView 内のセッションを開くようにしました。
SandboxedSdkView を含むウィンドウの可視性が変更されたときに onUiContainerChanged を送信するように SessionObserver ロジックを更新しました。

バグの修正

ウィンドウの可視性が変更されたときに onUiContainerChanged を呼び出す（I541cf）
新しいプラットフォーム API へのアクセスの手動アウトラインを削除しました。これは、AGP 7.3 以降（R8 バージョン 3.3 など）で R8 を使用する場合、および AGP 8.1 以降（D8 バージョン 8.1 など）を使用するすべてのビルドで、API モデリングによって自動的に行われるためです。AGP を使用していないクライアントは、D8 バージョン 8.1 以降にアップデートすることをおすすめします。詳しくは、こちらの記事をご覧ください。（If6b4c、b/345472586）

バージョン 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 の変更

非推奨のプライバシーサンドボックス Activity API。これらの API は、専用の Activity ライブラリ androidx.privacysandbox.activity に移動されました。（I68beb）

バグの修正

プーリングコンテナ内でリモートコンテンツを表示する際のレンダリングバグを修正しました。（I804df）
下位互換モードで ViewGroups のレンダリングの問題を引き起こしていたバグを修正しました。（I8de92）
SandboxedSdkView の親の 1 つが PoolingContainer の場合、PoolingContainer がリソースを解放できることを示すときに UI セッションを閉じ、ウィンドウの切断時に閉じないようにします。（I2046b）

外部からの協力

GestureDetector が minSdk から利用可能になったため、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）
ホストコンテナとプロバイダコンテナのサイズ変更を同じフレームで commit できるようにするロジックを追加し、UI のジャンクを回避しました。（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-order 値をホストに送信します。（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 の変更

SandboxedUiAdapter に windowInputToken パラメータを追加しました。（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）

バグの修正

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

バージョン 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 については、こちらをご覧ください。

バグの修正

フレーキーテストを無効にする ChangingSandboxedSdkViewLayoutChangesChildLayout テスト

バージョン 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 については、こちらをご覧ください。

新機能

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