此页面由 Cloud Translation API 翻译。

privacysandbox 界面

待办事项

最近更新时间	稳定版	候选版	Beta 版	Alpha 版
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")

    
}

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

版本 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 中包含这些提交内容。

新功能

引入了 AbstractSandboxedUiAdapter 和 AbstractSandboxedUiAdapter.AbstractSession 抽象类，界面提供程序可以使用它们来避免实现整个 SandboxedUiAdapter 或 Session 接口。建议界面提供程序使用这些抽象类。
添加了允许将 SessionObserverFactory 附加到 SandboxedUiAdapter 的 registerObserverFactory 逻辑。将 SessionObserverFactory 附加到适配器时，系统会为为该适配器创建的每个新界面会话创建一个 SessionObserver。当界面会话打开时，创建的 SessionObserver 将收到 onSessionOpened 回调。当 Session 视图的界面呈现方式发生变化时，系统会调用 SessionObserver.onUiContainerChanged。onUiContainerChanged 受到限制，系统最多每 200 毫秒会调用一次。
添加了 SandboxedSdkViewUiInfo，它可根据 SessionObserver.onUiContainerChanged 中发送的 Bundle 创建。此对象表示托管界面会话的 SandboxedSdkView 的界面状态。它包含高度和宽度信息、表示屏幕上可见视图几何形状的 Rect，以及表示视图不透明度的不透明度提示。

API 变更

向 SandboxedSdkViewUiInfo 添加了不透明度提示。（I093ac）
添加了 SessionObserver.onUiContainerChanged 和 SandboxedSdkViewUiInfo。（Ie98bc）
添加了 SessionObserver 接口和注册逻辑。（I047dc）
添加了 AbstractSandboxedUiAdapter 和 AbstractSession。（I3617a）

已知问题

当界面提供程序与客户端应用在同一进程中时，当容器滚动时，系统不会发送 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 中包含这些提交内容。

新功能

添加了对在 PoolingContainer（例如 RecyclerView）中使用 SandboxedSdkView 的支持。当 SandboxedSdkView 的父项为 PoolingContainer 时，其界面会话的生命周期将与 PoolingContainer 的生命周期保持一致，以确保会话可以在窗口分离后持续存在。

API 变更

废弃了 Privacy Sandbox Activity API。现在，这些 API 可在专用的 Activity 库 androidx.privacysandbox.activity 中找到。(I68beb)

bug 修复

修复了在池化容器内显示远程内容时出现的渲染 bug。（I804df）
修复了导致在向后兼容模式下 ViewGroups 出现渲染问题的 bug。（I8de92）
当 SandboxedSdkView 的其中一个父级为 PoolingContainer 时，当 PoolingContainer 指示资源可以释放时（而不是在窗口分离时），关闭界面会话。（I2046b）

外部贡献

GestureDetectorCompat 现已废弃，因为 GestureDetector 可通过 minSdk 获取。（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 中包含这些提交内容。

新功能

为库添加了向后兼容性支持。在 API 33 及更低版本中，提供程序的视图将在应用进程内的另一个类加载器中呈现。(If0b7a)
添加了允许在同一帧中调整主机和提供程序容器的大小，以避免可见的界面卡顿的逻辑。（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 中包含这些提交内容。

新功能

添加了将 SandboxedSdkView 裁剪到其可在其中滚动的“绑定父级”视图的逻辑。这样可确保 SandboxedSdkView 的内容不会遮挡根内容视图之外的其他视图或任何界面组件。（I9ea94）

API 变更

将 SandboxedSdkView.setZOrderOnTopAndEnableUserInteraction 重命名为了 orderProviderUiAboveClientUi (Iecb7e)

bug 修复

将正确的 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 中包含这些提交内容。

新功能

添加了用于在滚动和快速滑动手势（源自 SandboxedSdkView）时将触摸焦点转移到宿主的逻辑。这样，客户端的可滚动容器托管服务提供商界面就可以正确响应滚动和投掷。

API 变更

向 SandboxedUiAdapter 添加了 windowInputToken 参数 (Ief578)

bug 修复

在首次绘制后将会话状态设置为“活跃”(I36f3f)
修复了 SandboxedSdkView 的布局问题。（I09cb8）
添加了将触摸焦点转移到主机的逻辑。（I33b54）
向 SandboxedUiAdapter 添加了 windowInputToken 参数。必须这样做，才能确保 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 中包含这些提交内容。

新功能

引入 SdkActivityLauncher。一个允许支持运行时的 SDK 启动 activity 的接口。（I5b3dc）

bug 修复

修复了 notifyZOrderChanged 竞态条件问题。确保针对所有 Z 顺序更改通知界面提供程序。如果在调用 openSession 之前 SandboxedSdkView 的 Z 顺序发生更改，界面提供程序将不会被明确通知。

版本 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 中包含这些提交内容。

新功能

StateChangedListener 会通知应用界面会话发生的变化

API 变更

添加了 StateChangedListener，以替换 ErrorConsumer (Icd5d3)

bug 修复

修复了 notifyZOrderChanged 竞态条件，以便界面提供程序收到所有 Z 顺序更改的通知

版本 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 中包含这些提交内容。

bug 修复

停用了不稳定的 testChangeSandboxedSdkViewLayoutChangesChildLayout 测试

版本 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 中包含这些提交内容。

新功能

这些是新的 Jetpack 库，应用和支持运行时的 SDK (Privacy Sandbox) 可以使用它们来让应用（客户端）托管 SDK（提供程序）提供的任何界面。