本文档概述了典型的开发和测试阶段,可帮助您制定与平台发布时间表良好对齐的准备计划,并确保您的用户在 Android 14 上获得出色的体验。
每个 Android 版本都会引入新功能以及行为变更,旨在使 Android 更实用、更安全、性能更高。在许多情况下,您的应用将按预期开箱即用,而在其他情况下,您可能需要更新应用以适应平台变更。
一旦源代码发布到 AOSP(Android 开源项目),用户就可以开始接收新平台,因此您的应用必须做好准备,按预期为用户运行,并且理想情况下应利用新功能和 API 以充分利用新平台。
典型的迁移有两个阶段,可以并行进行:
- 确保应用兼容性(在 Android 14 最终发布时)
- 以新平台功能和 API 为目标(最终发布后尽快)
确保与 Android 14 的兼容性
将现有应用的功能与 Android 14 进行测试非常重要,以确保更新到最新版 Android 的用户获得出色的体验。某些平台变更可能会影响应用的运行方式,因此及早、彻底地测试并对应用进行任何必要的调整非常重要。
您通常可以调整应用并发布更新,而无需更改应用的 targetSdkVersion
。同样,您应该不需要使用新的 API 或更改应用的 compileSdkVersion
,但这可能取决于您的应用构建方式及其使用的平台功能。
在开始测试之前,请务必熟悉所有应用的行为变更。这些变更可能会影响您的应用,即使您不更改其 targetSdkVersion
。
将 Android 14 系统映像刷写到您的设备,或下载适用于 Android 模拟器的系统映像。
查看系统行为变更,以确定您的应用可能受影响的区域。
在您的设备或模拟器上安装您的应用,并运行测试。重点关注系统行为变更,并遍历所有应用流程。
仅进行为适应行为变更或解决问题所需的代码更改。使用您的应用最初以之为目标的相同 API 级别重新编译——无需以 Android 14 为目标。
签署、上传和发布您更新后的 Android App Bundle 或 APK。
执行兼容性测试
在大多数情况下,与 Android 14 的兼容性测试类似于普通的应用测试。这是回顾核心应用质量指南和测试最佳实践的好时机。
要进行测试,请在运行 Android 14 的设备上安装您当前发布的应用,并遍历所有流程和功能,同时寻找问题。为了帮助您集中测试,请查看 Android 14 中引入的所有应用的行为变更,这些变更可能会影响您的应用功能或导致应用崩溃。
还要确保查看并测试受限非 SDK 接口的使用情况。您应该将应用使用的任何受限接口替换为公共 SDK 或 NDK 等效项。注意 logcat 警告,它们会突出显示这些访问,并使用 StrictMode
方法 detectNonSdkApiUsage()
以编程方式捕获它们。
最后,务必充分测试您应用中的库和 SDK,以确保它们在 Android 14 上按预期工作,并遵循隐私、性能、UX、数据处理和权限的最佳实践。如果您发现问题,请尝试更新到最新版本的 SDK,或联系 SDK 开发者寻求帮助。
完成测试并进行任何更新后,我们建议立即发布兼容应用。这让您的用户可以尽早测试应用,并有助于确保用户更新到 Android 14 时的平稳过渡。
更新应用的目标定位并使用新 API 进行构建
一旦您发布了应用的兼容版本,下一步就是通过更新其 targetSdkVersion
并利用 Android 14 中的新 API 和功能来添加对 Android 14 的完全支持。您可以随时进行这些更新,同时牢记 Google Play 要求对新平台进行目标定位。
在您规划完全支持 Android 14 的工作时,请查看影响以 Android 14 为目标的应用的行为变更。这些*有针对性的行为变更*可能会导致您需要解决的功能问题。在某些情况下,这些变更需要大量的开发工作,因此我们建议您尽早了解并解决它们。为了帮助识别影响您应用的特定行为变更,请使用兼容性切换开关测试您的应用,并启用选定的变更。
以下步骤描述了如何完全支持 Android 14。
安装最新版 Android Studio 预览版以使用 Android 14 进行构建。确保您拥有 Android 14 设备或模拟器。
更新您的 targetSdkVersion
和其他构建配置。
查看适用于以 Android 14 为目标的应用的行为变更。确定您的应用可能受影响的区域,并规划如何支持它们。
进行所需的代码和架构更改,以支持 Android 14 的用户隐私更改。
利用 Android 14 API 为您的应用带来新功能和新能力。为 Android 14 重新编译。
在 Android 14 设备或模拟器上测试。重点关注行为变更可能影响您的应用的区域。尝试使用新 API 的功能。提供平台和 API 反馈。报告任何平台、API 或第三方 SDK 问题。
一旦 Android 14 API 最终确定,再次更新您的 targetSdkVersion
和其他构建配置,进行任何额外的更新,并测试您的应用。
签署、上传和发布您更新后的 Android App Bundle 或 APK。
获取 SDK,更改目标定位,使用新 API 构建
要开始测试对 Android 14 的完全支持,请使用最新预览版 Android Studio 下载 Android 14 SDK 和您需要的任何其他工具。接下来,更新您应用的 targetSdkVersion
和 compileSdkVersion
,并重新编译应用。有关详细信息,请参阅SDK 设置指南。
测试您的 Android 14 应用
一旦您编译了应用并将其安装在运行 Android 14 的设备上,请开始测试以确保应用在以 Android 14 为目标时能正常工作。某些行为变更仅在您的应用以新平台为目标时才适用,因此您需要在开始之前查看这些变更。
与基本兼容性测试一样,遍历所有流程和功能,寻找问题。将您的测试重点放在以 Android 14 为目标的应用的行为变更上。这也是检查您的应用是否符合核心应用质量指南和测试最佳实践的好时机。
务必查看并测试可能适用的受限非 SDK 接口的使用情况。注意 logcat 警告,它们会突出显示这些访问,并使用 StrictMode 方法 detectNonSdkApiUsage()
以编程方式捕获它们。
最后,务必充分测试您应用中的库和 SDK,以确保它们在 Android 14 上按预期工作,并遵循隐私、性能、UX、数据处理和权限的最佳实践。如果您发现问题,请尝试更新到最新版本的 SDK,或联系 SDK 开发者寻求帮助。
使用应用兼容性切换开关进行测试
Android 14 包含兼容性切换开关,使测试应用与有针对性的行为变更更容易。对于可调试的应用,这些切换开关可让您:
- 无需实际更改应用的 targetSdkVersion 即可测试有针对性的变更。您可以使用切换开关强制启用特定的有针对性行为变更,以评估对现有应用的影响。
- 仅将测试重点放在特定变更上。不必一次性处理所有有针对性的变更,切换开关可让您禁用所有有针对性的变更,只留下您想要测试的那些。
- 通过 adb 管理切换开关。您可以使用 adb 命令在自动化测试环境中启用和禁用可切换的变更。
- 使用标准变更 ID 更快地调试。每个可切换的变更都有一个唯一的 ID 和名称,您可以使用它们快速调试日志输出中的根本原因。
在您准备更改应用目标定位时,或在您积极开发 Android 14 支持时,这些切换开关都可以提供帮助。有关更多信息,请参阅兼容性框架变更 (Android 14)。