此页面由 Cloud Translation API 翻译。

privacysandbox-tools

用于在 Android 中利用 Privacy Sandbox 功能的库

最近更新时间	稳定版	候选版	Beta 版	Alpha 版
2025 年 12 月 17 日	-	-	-	1.0.0-alpha14

声明依赖项

如需添加 privacysandbox-tools 的依赖项，您必须将 Google Maven 制品库添加到项目中。如需了解详情，请参阅 Google 的 Maven 制品库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

Groovy

dependencies {
    // Use to implement privacysandbox libraries

    implementation "androidx.privacysandbox.tools:tools:1.0.0-alpha14"
    Implementation "androidx.privacysandbox.tools:tools-apicompiler:1.0.0-alpha14"
    implementation "androidx.privacysandbox.tools:tools-apigenerator:1.0.0-alpha14"
    implementation "androidx.privacysandbox.tools:tools-core:1.0.0-alpha14"
    implementation "androidx.privacysandbox.tools:tools-testing:1.0.0-alpha14"
    implementation "androidx.privacysandbox.tools:tools-apipackager:1.0.0-alpha14"
    
    
}

Kotlin

dependencies {
    // Use to implement privacysandbox libraries
    
    implementation("androidx.privacysandbox.tools:tools:1.0.0-alpha14")
    implementation("androidx.privacysandbox.tools:tools-apicompiler:1.0.0-alpha14")
    implementation("androidx.privacysandbox.tools:tools-apigenerator:1.0.0-alpha14")
    implementation("androidx.privacysandbox.tools:tools-core:1.0.0-alpha14")
    implementation("androidx.privacysandbox.tools:tools-testing:1.0.0-alpha14")
    implementation("androidx.privacysandbox.tools:tools-apipackager:1.0.0-alpha14")

}

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

反馈

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

创建新问题

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

版本 1.0

版本 1.0.0-alpha14

2025 年 12 月 17 日

发布了 androidx.privacysandbox.tools:tools-*:1.0.0-alpha14。版本 1.0.0-alpha14 中包含这些提交内容。

此库已被弃用，未来不会再收到任何更新。

API 变更 - 弃用了 privacysandbox.tools API。（Ieb66c、b/452878636） - 废弃了 privacysandbox.sdkruntime API（Ibe81a、b/452878636） - 废弃了 privacysandbox.ui API（I858d5、b/452878636） - 使用 Kotlin 2.0 发布的项目需要使用 KGP 2.0.0 或更高版本才能使用（Idb6b5、b/344563182）

版本 1.0.0-alpha13

2025 年 3 月 26 日

发布了 androidx.privacysandbox.tools:tools-*:1.0.0-alpha13。版本 1.0.0-alpha13 中包含这些提交内容。

新功能

在 openSession 中添加了对 SessionData 参数的支持，该参数取代了 SessionConstants。
移除了 SandboxedSdkProviderCompat.getView() 的生成，该功能现已弃用。

版本 1.0.0-alpha12

2025 年 2 月 26 日

发布了 androidx.privacysandbox.tools:tools-*:1.0.0-alpha12。版本 1.0.0-alpha12 中包含这些提交内容。

新功能

@PrivacySandboxInterface-annotated 接口现在可以扩展 androidx.privacysandbox.ui:ui-core:1.0.0-alpha14 中引入的 SharedUiAdapter 接口，与 SandboxedUiAdapter 类似。一个接口只能扩展一个界面适配器类型。

版本 1.0.0-alpha11

2025 年 1 月 29 日

发布了 androidx.privacysandbox.tools:tools-*:1.0.0-alpha11。版本 1.0.0-alpha11 中包含这些提交内容。

新功能

在 SandboxedUiAdapter.openSession 中添加了对更新后的 SessionConstants 参数的支持。(I65886)

版本 1.0.0-alpha10

2024 年 10 月 2 日

发布了 androidx.privacysandbox.tools:tools-*:1.0.0-alpha10。版本 1.0.0-alpha10 中包含这些提交内容。

新功能

在带注释的接口和带注释的值中添加对使用 const val 的 SDK 定义常量的支持。

API 变更

禁止使用 apicompiler 中的对象（之前会以静默方式忽略这些对象）

bug 修复

修复了当存在以 .class 结尾的源目录时发生的崩溃

版本 1.0.0-alpha09

2024 年 6 月 26 日

发布了 androidx.privacysandbox.tools:tools-*:1.0.0-alpha09。版本 1.0.0-alpha09 中包含这些提交内容。

新功能

添加了对使用 @PrivacySandboxValue 注释的枚举类的支持。
支持 Privacy Sandbox 界面 Alpha 版 09。

版本 1.0.0-alpha08

2024 年 3 月 20 日

发布了 androidx.privacysandbox.tools:tools-*:1.0.0-alpha08。版本 1.0.0-alpha08 中包含这些提交内容。

新功能

带有 @PrivacySandboxCallback 注释的接口现在可以包含返回值的方法，只要该方法会挂起即可。(I16063)
现在，在带注释的接口和值中，Bundle 可作为有效的参数和返回类型。(I52995)

版本 1.0.0-alpha07

2024 年 2 月 7 日

发布了 androidx.privacysandbox.tools:tools-*:1.0.0-alpha07。版本 1.0.0-alpha07 中包含这些提交内容。

API 变更

支持新的 SDK activity 启动器接口。新接口位于 androidx.privacysandbox.activity.core 中。androidx.privacysandbox.ui.core 中的旧版不再受支持。(Ia9079)

版本 1.0.0-alpha06

2023 年 9 月 6 日

发布了 androidx.privacysandbox.tools:tools-*:1.0.0-alpha06。版本 1.0.0-alpha06 中包含这些提交内容。

bug 修复

使用非 Android Guava 依赖项，以避免 Bazel 中的类路径冲突。
修复了从 Bazel 调用 API 编译器时发生的崩溃问题。(I24c9d)

版本 1.0.0-alpha05

2023 年 8 月 9 日

发布了 androidx.privacysandbox.tools:tools-*:1.0.0-alpha05。版本 1.0.0-alpha05 中包含这些提交内容。

新功能

生成的 SandboxedUiAdapters 现在具有新的 windowInputToken 集。这使得此版本与 androidx.privacysandbox.ui:ui-core:1.0.0-alpha05 兼容。

版本 1.0.0-alpha04

2023 年 5 月 24 日

发布了 androidx.privacysandbox.tools:tools-*:1.0.0-alpha04。版本 1.0.0-alpha04 中包含这些提交内容。

新功能

CancellationExceptions 现已传播到应用，因此 SDK 现在可以按预期取消其协程。
SdkActivityLaunchers 现在可用于 SDK API，因此应用可以向 Privacy Sandbox 中的 SDK 发送启动器。请注意，此功能目前仅在开发者预览版中提供。

bug 修复

由 SDK 声明的非挂起函数现在默认在主线程中运行。它们过去在 Binder 线程中运行。
服务无法再从界面适配器继承。
修复了在数据类中定义界面适配器属性会导致编译错误的问题。

版本 1.0.0-alpha03

2023 年 3 月 8 日

发布了 androidx.privacysandbox.tools:tools-*:1.0.0-alpha03。版本 1.0.0-alpha03 中包含这些提交内容。

新功能

添加了对 Privacy Sandbox 界面 API 集成的支持

API 变更

将目标 Kotlin 版本更改为 1.8.0

版本 1.0.0-alpha02

2022 年 12 月 7 日

发布了 androidx.privacysandbox.tools:tools-*:1.0.0-alpha02。版本 1.0.0-alpha02 中包含这些提交内容。

这些工具旨在增强与 Privacy Sandbox SDK 运行时 API 的集成。这些工具将帮助自动生成样板代码，以便为支持运行时的 SDK 定义面向客户端的接口并与之交互。

新功能 - 添加了对定义面向客户端的 SDK 接口的支持，这些接口可接受回调和数据值对象作为参数和返回值类型 - 向客户端传播 SDK 异常 - 支持 SDK 生成运行时向后兼容性

API 变更

添加了 @JvmDefaultWithCompatibility 注释 (I8f206)

版本 1.0.0-alpha01

2022 年 11 月 9 日

发布了 androidx.privacysandbox.tools:tools-*:1.0.0-alpha01。版本 1.0.0-alpha01 中包含这些提交内容。

新功能

这是一个新的 Jetpack 库，其中包含用于利用 Privacy Sandbox 功能的 API。请通过我们的问题跟踪器组件提交 bug。