privacysandbox-tools

一个用于利用 Android 中隐私沙盒功能的库

最新更新	稳定版	发布候选版本 (RC)	Beta 版	Alpha 版
2025 年 3 月 26 日	-	-	-	1.0.0-alpha13

声明依赖项

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

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

Groovy

dependencies {
    // Use to implement privacysandbox libraries

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

Kotlin

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

}

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

反馈

您的反馈有助于改进 Jetpack。如果您发现新问题或有改进此库的建议，请告知我们。在创建新问题之前，请查看此库中的现有问题。您可以通过点击星形按钮为您关注的现有问题投票。

创建新问题

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

版本 1.0

版本 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 注解的接口现在可以扩展 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 注解的枚举类的支持。
支持隐私沙盒界面 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，因此应用可以在隐私沙盒中向 SDK 发送启动器。请注意，此功能目前仅在开发者预览版中提供。

Bug 修复

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

版本 1.0.0-alpha03

2023 年 3 月 8 日

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

新功能

添加了对隐私沙盒界面 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 包含这些提交。

这些工具旨在增强与隐私沙盒 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 库，其中包含用于利用隐私沙盒功能的 API。请在我们的问题跟踪器组件中提交 Bug。