12L 开发者预览版

欢迎加入 12L 预览版计划,该计划将为您提供面向 Android 12 即将投放的 12L 功能提升应用兼容性和构建应用所需的所有功能。您可以免费加入该计划,并且可以下载预览版 SDK 和工具,立即开始使用

时间轴、里程碑和更新

12L 开发者预览版和 Beta 版的时间轴

12L 预览版计划于 2021 年 10 月开始启动,一直持续到面向 AOSP 发布最终公开版本,最终版本预计将于 2022 年初发布。我们将为您的开发和测试环境提供每月更新。每次更新均包括 SDK 工具、系统映像、文档、API 参考文档和 API 差异。该计划包括以下里程碑:

时间轴 Build 类型 开发者操作
10 月 开发者预览版 1 早期的基准 build,涉及少量新功能、API 和行为变更,重点关注开发者反馈。 API 反馈的重要窗口。 查看新的 API 和行为变更,并在此期间向我们报告任何重大问题或请求。开始早期的应用兼容性测试。
12 月 Beta 版 1 最终 API

初始 Beta 版本,面向注册试用 Android Beta 版的尝鲜者提供无线更新。
继续进行兼容性测试,留意 Android Beta 版用户的反馈。如有任何问题,请通知 SDK 和库的开发者。
1 月 Beta 版 2 Beta 版增量更新 开始对应用、SDK 和库进行最终的兼容性测试。发布兼容版本。必要时,根据正式 API 32 SDK 编译应用。
2 月 Beta 版 3 Beta 版增量更新 开始对应用、SDK 和库进行最终的兼容性测试。发布兼容版本。必要时,根据正式 API 32 SDK 编译应用。
2022 年第 1 季度 最终版本 面向 AOSP 和生态系统发布 12L 版本 发布应用、SDK 和库的兼容更新。

预览版阶段

对开发者而言,开发者预览版阶段的重点在于 API 反馈应用兼容性。应用兼容性意味着测试当前版本的应用是否在新平台上外观正常并且运行良好。

开发者预览版 build 提供早期测试和开发环境,您可借此在您的应用中试用 12L 功能。虽然我们不打算在此版本中添加任何破坏性更改,但仍建议您测试您的应用来识别任何潜在的兼容性问题,以便您可以在必要时规划迁移或功能工作。在此期间,向我们提供您的反馈尤为重要。此外,您还应了解,每次更新都会有一些 API 变更。

Beta 版 1 为您提供了更全面、更稳定的环境,方便您构建和测试 12L 功能,这是我们向注册参加 Android Beta 版计划的尝鲜者提供的首个 build。在 Beta 版期间,尝鲜者将在 Pixel 设备上使用您的应用,因此我们建议您留意这些用户的反馈,并发布兼容更新以解决所有问题,而不更改应用的目标平台。

Beta 版 2 开始,系统行为和 API 均已最终确定。这时可开始进行最终测试和开发工作,以确保向获取此更新的用户提供准备就绪的兼容版应用。此时 12L 将具有标准 API 级别(API 级别 32)。

由于此时已有最终 API,您也可以开始将工作重心转移到最终兼容性测试,并向用户和下游开发者发布更新后的应用。您还可以使用最终版 API 构建应用,并优化使用了新 API 或新功能的新代码。

12L API 级别和可选平台定位

12L 更新包含少量面向开发者的新 API。这些 API 仍处于开发阶段,在此期间,12L 平台将使用临时 API 级别“Sv2”。当 API 最终确定后,12L 平台将使用 API 级别“32”。

对开发者而言,将应用的目标平台设置为 12L API 级别 (targetSdkVersion="32") 以满足 Google Play 的要求是一项可选设置(但建议这么设置)。如需详细了解最新的 Google Play 目标平台要求,请参阅这篇文章

12L 预览版包含哪些内容?

12L 预览版计划包含您在使用不同屏幕尺寸、网络技术、CPU 和 GPU 芯片组和硬件架构的各种设备中测试现有应用所需的一切功能。

SDK 和工具

使用 Android Studio,您可以通过 SDK 管理器下载以下组件:

  • 12L SDK 和工具
  • 适用于所有屏幕尺寸的 12L 模拟器系统映像(仅限 64 位,请参阅版本说明

我们将根据需要在每个里程碑为这些开发工具提供更新。

如需开始使用,请参阅获取 12L。如需了解已知问题,请参阅版本说明

模拟器和 Pixel 系统映像

12L 中的大部分变更都仅适用于大屏设备,因此在手机等小屏设备上看不到。为了提供一个运行时环境让您试用新功能,我们提供了 12L 模拟器,您可以在 Android Studio Bumblebee Beta 版 3 或更高版本支持的任何模拟器设备配置上使用它。

在预览版期间,我们强烈建议您使用 12L 模拟器在平板电脑、可折叠设备或桌面设备配置上测试您的应用。

如需详细了解如何设置 12L 模拟器,请参阅获取 12L

作为次要目标,同样建议您在手机上测试兼容性,因为 12L 也将投放到手机中。从 Beta 版 1 开始,我们将为所有受支持的 Pixel 设备提供系统映像,同时还会提供 GSI 映像,以便可以针对更广泛的设备执行开发和测试。届时,请访问下载页面获取用于开发和测试的系统映像。

通过 Android Beta 版计划以 OTA 方式更新 Pixel

从 Beta 版 1 开始,如果您拥有以下任一 Google Pixel 设备,您可以将设备注册加入适用于 Pixel 的 Android Beta 版计划,以便通过无线下载 (OTA) 方式获取 Android 12L 里程碑更新:

  • Pixel 3a 和 Pixel 3a XL
  • Pixel 4 和 Pixel 4 XL
  • Pixel 4a 和 Pixel 4a (5G)
  • Pixel 5 和 Pixel 5a
  • Pixel 6 和 Pixel 6 Pro

注册后,您的设备将会收到直到(并包括)Android 12L 最终版本的定期 OTA 更新。

可以注册后,请访问 g.co/androidbeta 进行注册。

预览版 API 和发布

12L 预览版最初提供的系统和 Android 库仅用于开发用途,不具备标准的 API 级别。在此阶段,如果您想以该新平台为目标平台并使用新的 12L API 进行构建,就必须将应用的 targetSdkVersionminSdkVersion 设为 "Sv2" 并将其 Gradle compileSdkVersion 设为 "Sv2",从而将目标平台设定为 12L 预览版。如需了解详情,请参阅针对 12L 更新 build 配置

12L 预览版提供预览版 API,在发布最终版 SDK 之前,这些 API 都不是正式 API。这意味着,在一段时间内,特别是该计划的开发者预览版阶段,API 可能会变更。对于每个 12L 版本,我们都会提供变更摘要。

在 Beta 版 2 中,将最终确定开发者 API,您可以将正式版 12L SDK 下载到 Android Studio 中,以正式 API 级别 32 为目标平台,并根据正式 API 进行编译。请注意,根据预览版 SDK 编译的应用不能安装在支持最终版 API 的系统映像中。

在最终确定 API 之前,Google Play 会禁止发布以 Sv2 为目标平台的应用。当最终版 SDK 可用时,您就能以正式 12L API 级别为目标平台,并使用 Alpha 版、Beta 版和正式版发布渠道将应用发布到 Google Play。与此同时,如果您希望向测试人员分发以 12L 为目标平台的应用,可随时通过电子邮件或直接从您的网站下载实现分发。

保持最新状态

在整个 12L 预览版期间,当您对开发者预览版和 Beta 版进行测试时,强烈建议您将开发环境保持为最新状态。当有新的更新可用时,我们会使用以下渠道通知您:

更多信息

如需详细了解 12L,请参阅以下文档资源:

  • 12L 功能和变更页面汇总了所有记录的可能会影响应用开发者的功能和行为变更。
  • 版本说明页面列出并介绍了每个开发者预览版或 Beta 版特有的已知问题和传递变更。

API 参考文档和差异报告

完整的 12L API 参考文档可在线获取。当新 API 处于开发阶段时,系统会为其添加水印以供查看,并将 API 级别显示为“Sv2”。请注意,只有使用 12L 预览版 SDK 构建应用时才可以使用这些 API。

正式版 12L SDK 可用后,API 参考文档会以正式 API 级别 32 标记新 API。

如需详细了解每个版本中新增、修改、弃用和移除的 API,我们建议您先查看版本说明中列出的差异报告。

差异报告中的变更包含指向相关 API 参考文档的链接。

支持资源

使用 12L 进行测试和开发时,请使用以下渠道报告问题并提供反馈:

  • 访问反馈和问题页面获得有关如何报告问题的完整信息,并与我们分享您的想法。

  • 开发者预览版问题跟踪器是我们的主要问题跟踪器。您可通过问题跟踪器报告 bug、性能问题和一般反馈。您还可以查看已知问题,并查找解决方法步骤。我们将对您的问题进行分类并发送给 Android 工程团队以供审查,并会为您提供相关进度更新通知。如需详细了解如何报告各种问题,请参阅在何处报告问题部分。

  • Android Beta 版社区,在此社区中,您可以与参与 12L Beta 版计划的其他用户和开发者建立联系。您可以在此分享观察结果或想法,并查找问题的解答。

开始使用!

首先,请按照获取 12L 中的步骤设置模拟器,以进行兼容性测试。针对大屏设备优化应用,立即为您的用户打造更出色的体验。感谢您参与 12L 预览版计划!