privacysandbox sdkruntime

声明依赖项

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

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

dependencies {

    implementation "androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha18"
    implementation "androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha18"
}

dependencies {
    implementation("androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha18")
    implementation "androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha18"
}

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

反馈

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

创建新问题

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

版本 1.0

版本 1.0.0-alpha18

2025 年 7 月 16 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha18、androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha18 和 androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha18。版本 1.0.0-alpha18 中包含这些提交内容。

API 变更

• 已完全移除 SandboxedSdkProviderCompat.getView()。如果项目还使用 androidx.privacysandbox.tools，则应使用最新版本。
• SdkSandboxControllerCompat 已迁移到 sdkruntime-provider。sdkruntime-core 中的 SdkSandboxControllerCompat 已弃用，并将在下一版本中移除。

bug 修复

• 现在，无论 loadSdk() 调用方线程如何，都从主线程调用 SandboxedSdkProviderCompat.onLoadSdk()。

版本 1.0.0-alpha17

2025 年 3 月 26 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha17、androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha17 和 androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha17。版本 1.0.0-alpha17 中包含这些提交内容。

新功能

API 变更

• 已弃用 SandboxedSdkProviderCompat.getView()，将在下一版本中移除。请在下一个版本发布之前迁移到 androidx.privacysandbox.tools 1.0.0-alpha13。
• 已停止支持 1.0-alpha13 库（应用和 SDK 都应使用更新的版本才能与此版本中的对等库搭配使用）

bug 修复

• 在 API33 设备上将 AppOwnedInterfaces 迁移到本地实现。

版本 1.0.0-alpha16

2024 年 12 月 11 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha16、androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha16 和 androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha16。版本 1.0.0-alpha16 中包含这些提交内容。

API 变更

• 引入 SdkSandboxClientImportanceListenerCompat，以便 SDK 接收有关客户端应用重要性（前台状态）变化的通知

bug 修复

• 修复了以下 bug：导致使用 Proguard 的客户端应用无法在向后兼容模式下加载 SDK。

版本 1.0.0-alpha15

2024 年 11 月 13 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha15、androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha15 和 androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha15。版本 1.0.0-alpha15 中包含这些提交内容。

新功能

• 支持在向后兼容模式下从 SdkContext 创建 LayoutInflater。
• 支持在向后兼容模式下从 SdkContext 创建 DisplayContext/WindowContext。

版本 1.0.0-alpha14

2024 年 7 月 24 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha14、androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha14 和 androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha14。版本 1.0.0-alpha14 中包含这些提交内容。

新功能

• 引入了 SdkSandboxControllerCompat#getClientPackageName 以检索客户端应用软件包名称。

API 变更

• 已从 sdkruntime-core 中完全移除 SandboxedSdkProviderAdapter。请使用 sdkruntime-provider 库中的 SandboxedSdkProviderAdapter。

版本 1.0.0-alpha13

2024 年 3 月 6 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha13、androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha13 和 androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha13。版本 1.0.0-alpha13 中包含这些提交内容。

新功能

• Backcompat 支持 SDK-SDK 加载 (SdkSandboxControllerCompat#loadSdk) - 现在本地加载的 SDK（在应用进程中）可以加载其他 SDK

版本 1.0.0-alpha12

2024 年 1 月 24 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha12、androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha12 和 androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha12。版本 1.0.0-alpha12 中包含这些提交内容。

新功能

• 引入 SdkSandboxControllerCompat#loadSdk 以支持沙盒中的其他 SDK 加载 SDK（目前仅在 API 34 扩展 10 上受支持）

API 变更

• 移除了 API 33 设备上的沙盒支持 - 在 API 34 之前应使用向后兼容（应用内）模式。

版本 1.0.0-alpha11

2023 年 11 月 15 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha11、androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha11 和 androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha11。版本 1.0.0-alpha11 中包含这些提交内容。

新功能

• AppOwnedSdkSandboxInterfaceCompat 支持 API34 Ext 8 设备（之前仅适用于 PrivacySandbox 开发者预览版 build）

版本 1.0.0-alpha10

2023 年 10 月 18 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha10、androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha10 和 androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha10。版本 1.0.0-alpha10 中包含这些提交内容。

bug 修复

• 修复了在应用进程中加载的 SDK 的资源重新映射。

版本 1.0.0-alpha09

2023 年 10 月 4 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha09、androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha09 和 androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha09。版本 1.0.0-alpha09 中包含这些提交内容。

API 变更

• sdkruntime-provider 库的第一个版本，应将其用于 SDK，而不是 sdkruntime-core 库。
• SandboxedSdkProviderAdapter 已迁移到 sdkruntime-provider。sdkruntime-core 中的 SandboxedSdkProviderAdapter 已弃用，很快就会被移除。

bug 修复

• 在 SDK 卸载时取消注册所有 SdkSandboxActivityHandlerCompat。
• ActivityHolder 生命周期事件现在与 ReportFragment 的行为相匹配

版本 1.0.0-alpha08

2023 年 8 月 9 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha08 和 androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha08。版本 1.0.0-alpha08 中包含这些提交内容。

bug 修复

• 修复了当目标上下文 SharedPreferences 不存在时 SharedPreferences 迁移失败的问题。

版本 1.0.0-alpha07

2023 年 7 月 26 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha07 和 androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha07。版本 1.0.0-alpha07 中包含这些提交内容。

新功能

• 为本地加载（在应用进程中）的 SDK 提供按 SDK 划分的 SharedPreferences 支持。SandboxedSdkProviderCompat#context 经过自定义，可为处于向后兼容模式的 SDK 提供 SDK 级 SharedPreferences 支持。

版本 1.0.0-alpha06

2023 年 6 月 21 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha06 和 androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha06。版本 1.0.0-alpha06 中包含这些提交内容。

新功能

• 支持为本地加载（在应用进程中）的 SDK 提供 SDK 级存储空间和数据库。
• SandboxedSdkProviderCompat#context 经过自定义，可为处于向后兼容模式的 SDK 提供 SDK 级存储空间和数据库支持。

版本 1.0.0-alpha05

2023 年 6 月 7 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha05 和 androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha05。此版本是在内部分支中开发的。

新功能

• （仅限 PrivacySandbox 开发者预览版 8 及更高版本）添加了对应用沙盒中介的支持（请参阅 SdkSandboxManagerCompat#registerAppOwnedSdkSandboxInterface + SdkSandboxControllerCompat#getAppOwnedSdkSandboxInterfaces）

版本 1.0.0-alpha04

2023 年 5 月 10 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha04 和 androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha04。此版本是在内部分支中开发的。

新功能

• 初步支持在 SDK 沙盒内启动 activity（适用于 UDC+ 设备）：SDK 需要通过调用 SdkSandboxControllerCompat#registerSdkSandboxActivityHandler 注册处理程序，然后应用可以通过调用 SdkSandboxManagerCompat#startSdkSandboxActivity 为 SDK 启动 activity。

版本 1.0.0-alpha03

2023 年 4 月 5 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-*:1.0.0-alpha03。

新功能

• 添加了对 SandboxProcessDeathCallback 的支持
• 添加了对 SDK 卸载的支持

API 变更

• 移除了 SandboxedSdkCompat#create(binder)，请使用构造函数 SandboxedSdkCompat(binder)

版本 1.0.0-alpha02

2023 年 3 月 22 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-*:1.0.0-alpha02。

新功能

• 添加了用于获取已加载 SDK 列表的 API - SdkSandboxControllerCompat.getSandboxedSdks()。

版本 1.0.0-alpha01

2023 年 1 月 11 日

发布了 androidx.privacysandbox.sdkruntime:sdkruntime-*:1.0.0-alpha01。

• 这是一个新的 Jetpack 库，其中包含用于在旧版 Android 平台上构建和加载支持运行时 SDK (Privacy Sandbox) 的组件。