本文档提供了典型开发和测试阶段的高级视图，可帮助您制定准备计划，使其与平台发布时间表完美契合，并确保用户在 Android 14 上获得出色的体验。
随着每个 Android 版本的发布，我们都会引入新功能以及旨在使 Android 更有用、更安全和更高效的行为更改。在许多情况下，您的应用将按预期工作，而在其他情况下，您可能需要更新您的应用以适应平台更改。
用户可以在源代码发布到 AOSP（Android 开源项目）后立即开始接收新平台，因此，您的应用务必做好准备，为用户提供预期的性能，并理想情况下利用新功能和 API 以充分利用新平台。
典型的迁移包含两个阶段，这两个阶段可以同时进行
- 确保应用与 Android 14 最终版本兼容（在 Android 14 最终版本发布之前）
- 针对新的平台功能和 API（在最终版本发布后尽快）
确保与 Android 14 兼容
务必针对 Android 14 测试现有应用的功能，以确保为更新到最新版 Android 的用户提供出色的体验。某些平台更改可能会影响应用的行为方式，因此务必尽早且彻底地进行测试，并对应用进行必要的调整。
通常，您可以调整应用并发布更新，而无需更改应用的 targetSdkVersion。同样，您也不需要使用新的 API 或更改应用的 compileSdkVersion，尽管这可能取决于应用的构建方式及其使用的平台功能。
在开始测试之前，请务必熟悉 所有应用的行为更改。即使您不更改其 targetSdkVersion，这些更改也可能会影响您的应用。
将 Android 14 系统映像刷入您的设备，或下载适用于 Android 模拟器的系统映像。
查看系统行为更改，以识别可能影响您应用的区域。
将您的应用安装到您的设备或模拟器上，并运行测试。重点关注系统行为更改，并遍历所有应用流程。
仅进行适应行为更改或解决问题所需的代码更改。使用应用最初目标的相同 API 级别重新编译 - 无需以 Android 14 为目标。
签名、上传和发布更新的 Android 应用捆绑包或 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 应用捆绑包或 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)。