Privacy Sandbox on Android Beta 版计划提供稳定版 API。您可以使用 Beta 版计划版本在 Android 13 及更高版本的移动设备上（适用于所有 API）和 Android 12 及更高版本的移动设备上（适用于 Attribution Reporting API [ARA]）构建和测试用于有限生产环境测试的解决方案。我们将首先支持一小部分设备，并逐步支持更多设备。若想加入该计划，组织可以申请访问有限数量的设备，还可以注册任何将采用 Privacy Sandbox API 的应用。
对于 SDK 运行时，我们有一个封闭式 Beta 版测试，让开发者能够测试面向选定应用的支持运行时的 SDK 分发。
如需使用 Beta 版，开发者必须使用 API 级别 33 SDK 扩展更新来编译其解决方案。
Android SDK 扩展
Beta 版中的稳定 API 使用新的 Android SDK 扩展版本方法提供。此发布方法支持在主要版本之间发布稳定的 Android 功能。它提供了一种新的版本控制机制，可让您使用 Google Play 系统更新在多个 API 级别上为应用提供新的 API。Privacy Sandbox on Android SDK 扩展称为广告服务扩展详细了解 Android SDK 扩展。
开始使用
如需开始使用 Privacy Sandbox for Android，请执行以下步骤：
第 1 步：报名和注册 Beta 版计划
- 注册：完成注册流程，即可使用与广告相关的 API。
- 注册：您必须注册才能参与 Beta 版计划。
通过注册，您可以：
- 使您自己的设备用于内部测试。
- 在 Google Play 商店中指定有限数量的已发布应用，这些应用能够直接集成可保护隐私的 API 或集成使用这些 API 的 SDK 解决方案。
- 使用 Google Play 商店测试支持运行时的 SDK 分发。如果您只需要在设备上测试 SDK 运行时，则无需执行此步骤。
第 2 步：设置开发环境
在 Android Studio 中设置 Privacy Sandbox on Android SDK。
第 3 步：配置 AdServices 权限
声明 API 专属权限并配置 SDK 访问权限，以访问目标 API 管理的资源。
第 4 步：设置设备或模拟器映像
如需执行端到端测试，您需要与受支持的 Android 13 设备交互，或使用模拟器映像获取适当的 SDK 扩展。
第 5 步：配置设备以使用 Privacy Sandbox on Android
配置设置，以在设备上启用（或停用）Privacy Sandbox on Android。
排查已知问题
为避免在搭载 Android 12 及更低版本的设备上出现 PP API 集成方面的已知问题，与这些设备的广告服务 API 集成的开发者应执行以下操作：
- 验证客户端应用的清单文件是否包含
<uses-library>extservices 标记。相关标签如下：
<uses-library
android:name="android.ext.adservices"
android:required="false" />
- 如果您使用的是
androidx.privacysandbox.adsJetpack 库，请确保使用 1.1.0-beta05 版或更高版本。
有哪些可用的开发者资源？
Privacy Sandbox on Android Beta 版计划包含以下工具和资源。
SDK 和模拟器系统映像
使用 Android Studio，您可以通过 SDK 管理器下载最新的广告服务扩展和模拟器系统映像。详细了解如何设置开发环境和设置 API 访问权限。
API 参考文档
完整的 API 参考文档已可获取。
支持与反馈
在您使用 Privacy Sandbox on Android 进行测试和开发时，请查看版本说明，并使用问题跟踪器报告问题和提供反馈。
使开发环境保持最新状态
我们强烈建议您将开发环境保持为最新版本。这可确保您拥有最新的功能和安全补丁，并且您的环境与最新版本的依赖项兼容。如需接收有关新版本的通知，请订阅电子邮件更新。