设置设备或模拟器映像

如需使用 Privacy Sandbox on Android 的 Beta 版执行端到端测试，您需要与搭载 Android 13 的设备进行交互。您可以请求将您的 Android 13 设备添加到 Beta 版许可名单中，也可以使用 AdServices SDK 扩展中提供的经过 Beta 版批准的模拟器映像。（对于开发者预览版，不需要提供此信息。）

设置 Android 13 设备

Privacy Sandbox on Android Beta 版计划从 2023 年初开始推出，并从一小部分受支持的 Android 13 设备开始。在初始发布阶段，如果您加入了早期测试人员计划，就可以设置自己的设备以进行早期测试。这样，您就可以在您自己的有限数量的 Android 13 设备和应用中测试 Privacy Sandbox API。

如要确保您的设备运行的是最新的模块版本，请执行以下操作：

  1. 使用 Google 账号登录您的 Android 13 设备。
  2. 依次前往设置 > 安全和隐私 > 更新 > Google Play 系统更新，确保您的设备是最新版本。根据需要选择更新。
  3. Google Play 系统更新完成后，请重新启动设备。
  4. 检查 SDK 扩展在设备上是否可用。

使用开发者预览版映像设置 Android 13 设备

测试新兴功能的广告技术平台可能需要安装开发者预览版映像。功能和 API 可能会发生变化。

  1. 从以下 Android 13 设备列表中下载首选设备映像：

    设备 下载链接和 SHA-256 校验和
    Pixel 7
    3be2ca79f36839ca1facc98c9cc9ea200fd938dafd44f001ae24a029471a7e2f
    Pixel 7 Pro
    165314bf06543d705f3a24624ec610ed359d3443464ce21d6cdf4d8328d45707
    Pixel 7a
    e0aff67beebb97e44f18d5513058249961dde0beabbfb048197ef2e4b42b7d6a
    Pixel 6
    cd9d22a9b6d786cdcdcbc99da68ccb1c3447797afa43195081d179f9d7f53c3d
    Pixel 6 Pro
    ce8d295eb5a1618254606c2d3ffb0c7b9f4d4f90d71df9577ba7bc2e22aad808
    Pixel 6a
    2c1731f7f55f2c130274404e7d109f6e554700612938137640db563f9399732a
    Pixel 5
    a9b536a1a418916cf413d4b69d5cc1696a3aaa367f1f5401952ed91872b1d8f1
    Pixel 5a
    4a1af1af8019cec11784e88994887f2ffd45505ee0e768ccc9e70e09920feadf

  2. 备份 Android Pixel 设备的数据。

  3. 将设备映像刷写到 Android 13 设备上。

使用 Android 刷写工具刷写设备

Android 刷写工具可让您将 Privacy Sandbox on Android 系统映像安全地刷写到受支持的 Pixel 设备上。Android 刷写工具可以在任何支持 WebUSB 的网络浏览器（如 Chrome 或 Edge 79 及更高版本）上使用。

Android 刷写工具会引导您逐步完成设备刷写过程。您无需安装工具，但需要解锁设备并在开发者选项中启用 USB 调试。如需查看完整说明，请参阅 Android 刷写工具文档。

通过 USB 连接设备，然后导航到 Android 刷写工具，并按照屏幕上的指导操作。如需查看完整说明，请参阅 Android 刷写工具文档。

设置 Android 设备模拟器映像

如需设置开发者预览版模拟器映像以运行 Privacy Sandbox on Android，请执行以下操作：

  1. 安装 Android Studio 的最新 Canary build 或稳定版 build。
  2. 在 Android Studio 中，依次前往 Settings > Languages & Frameworks > Android SDK。
  3. 在 SDK Tools 标签页中，选择最新版 Android 模拟器，然后点击 OK。如果尚未安装最新版本，此操作将会安装最新版本。
  4. 依次转到 Tools > Device Manager，按照所显示的页面上的说明操作，然后选择 Create device。
  5. 如果您尚未安装与您的设备定义匹配的 Privacy Sandbox on Android 系统映像，请点击“UpsideDownCakePrivacySandbox”版本名称旁边的 Download 获取该映像。
  6. 返回“Device Manager”中的虚拟设备列表，然后为 Privacy Sandbox on Android 虚拟设备选择 Launch this AVD 操作以启动该设备。
  7. 设备启动后，继续操作以将设备配置为使用 Privacy Sandbox。