将应用迁移到 Android 15

本文档简要介绍了典型的开发和测试阶段 制定一个符合当前目标的准备状态计划 平台发布时间表并确保在 Android 15。

每次发布 Android 版本时,我们都会引入一些新的功能, 旨在提高 Android 的实用性、安全性和性能。 在许多情况下,您的应用都可以开箱即用,完全按预期运行, 在其他情况下,您可能需要更新应用以适应平台变化。

源代码发布后,用户即可开始接收新平台 发布到 AOSP(Android 开源项目),因此您的应用 一切就绪,按预期为用户带来出色效果,最好能够利用 新功能和 API,以便充分利用新平台。

典型的迁移包含两个阶段,这两个阶段可以同时进行:

  • 确保应用兼容性(在 Android 15 最终发布前)
  • 针对新的平台功能和 API 调整目标( 最终版本)

确保与 Android 15 兼容

请务必对照测试现有应用的功能 Android 15 确保为更新到 最新版本的 Android 系统一些平台变更可能会影响应用的方式 因此,务必要尽早进行全面测试, 做出调整

您通常无需更改应用即可调整应用并发布更新 应用的 targetSdkVersion。同样,您应该不需要使用新的 API 或 更改应用的 compileSdkVersion,但这取决于 及其所使用的平台功能。

在开始测试之前,请务必熟悉 应用的变更。即使您不会影响您的应用, 更改其 targetSdkVersion

获取 Android 15

将 Android 15 系统映像刷写到设备上,或下载 Android 模拟器的系统映像。

查看变更

查看系统行为变更,以确定变更可能会在哪些方面影响您的应用。

测试

在设备或模拟器上安装您的应用,然后运行测试。重点关注系统行为变更,并完成所有应用流程。

更新

只进行必要的代码更改,以适应行为变更或解决问题。使用相同的 API 级别重新编译 而无需以 Android 15 为目标平台。

发布

注册、上传并发布更新的 Android App Bundle 或 APK。

执行兼容性测试

在大多数情况下,测试与 Android 15 的兼容性 类似于普通的应用测试这时有必要回顾一下核心应用 质量指南测试最佳实践

如需进行测试,请在运行 Android 15,并完成所有流程和功能 来发现问题为了帮助您集中测试 请参阅本节课中引入的针对所有应用的行为变更 Android 15 的 Android 版本,可能会影响应用的功能或导致 应用崩溃

此外,请务必查看并测试是否使用受限非 SDK 接口。您应将应用使用的所有受限界面替换为 公共 SDK 或 NDK 等效项。留意突出显示以下内容的 logcat 警告 访问并使用 StrictMode 方法 detectNonSdkApiUsage() 捕获 以编程方式创建

最后,请务必全面测试应用中的库和 SDK,确保 确保它们在 Android 15 上按预期运行,并遵循最佳 隐私权、性能、用户体验、数据处理和权限方面的做法。如果您 发现问题,尝试更新到最新版 SDK,或与 向 SDK 开发者寻求帮助。

当您完成测试并进行更新后,建议您发布 您的兼容应用这样,用户就能尽早测试应用并 有助于确保在用户更新到 Android 15。

更新应用的目标平台并使用新 API 进行构建

发布应用的兼容版本后,下一步就是添加 通过更新 targetSdkVersion 来全面支持 Android 15 并充分利用 Android 15 中的新 API 和功能。 您可以在准备就绪后立即进行这些更新,请注意,Google 针对新平台的 Play 要求

在计划全面支持 Android 15 时,请查看 影响以 Android 15 为目标平台的应用的行为变更。 这些针对性的行为变更可能会导致功能问题,您将需要 地址。在某些情况下,这些更改需要大量开发工作,因此我们 建议您尽早了解并解决这些问题。提供帮助 确定影响应用的具体行为变更,请使用兼容性 切换开关以在启用所选变更的情况下测试应用。

以下步骤介绍了如何完全支持 Android 15。

获取 Android 15 SDK

安装最新版本的 Android Studio 预览版以构建 Android 15。确保您使用的是 Android 15 设备,或 模拟器。
更新您的 targetSdkVersion 和其他构建配置。

查看行为变更

查看适用于应用定位的行为变更 Android 15。确定变更可能会在哪些方面影响您的应用,并规划如何提供支持。

检查是否有新的隐私权变更

进行所需的代码和架构更改,以支持 Android 15 用户隐私权的变化。

采用 Android 15 功能

利用 Android 15 API 引入新功能和 应用功能针对 Android 15 重新编译。

测试

在 Android 15 设备或模拟器上进行测试。重点关注行为变更可能会在哪些方面影响您的应用。试用使用新 API 的功能。提供平台和 API 反馈。报告任何平台、API 或第三方 SDK 问题。

最终更新

在最终的 Android 15 API 发布后,请更新您的 targetSdkVersion 和其他 build 配置 进行其他更新,并测试您的应用。

发布

注册、上传并发布更新的 Android App Bundle 或 APK。

获取 SDK,更改目标平台,使用新 API 进行构建

如需开始测试全面支持 Android 15,请使用最新版 使用 Android Studio 下载 Android 15 SDK 的预览版 以及所需的任何其他工具接下来,更新应用的 targetSdkVersioncompileSdkVersion,然后重新编译应用。如需了解更多详情,请参阅 SDK 设置指南

测试 Android 15 应用

编译应用并将其安装在运行 Android 15,开始测试以确保应用正常运行 (以 Android 15 为目标平台时)。某些行为变更仅在 您的应用是针对新平台定位的,因此您需要查看 更改

与基本兼容性测试一样,完成所有流程和功能以查找问题。将测试重点放在 以 Android 15 为目标平台的应用的行为变更。时间是 也是根据核心应用质量指南检查您的应用的好时机 和测试最佳做法

请务必查看并测试受限非 SDK 接口的使用 可能适用的类别。留意突出显示这些访问权限和使用的 logcat 警告 StrictMode 方法 detectNonSdkApiUsage() 来捕获它们 以编程方式

最后,请务必全面测试应用中的库和 SDK,确保 确保它们在 Android 15 上按预期运行,并遵循最佳 隐私权、性能、用户体验、数据处理和权限方面的做法。如果您 发现问题,尝试更新到最新版 SDK,或与 向 SDK 开发者寻求帮助。

使用应用兼容性切换开关进行测试

Android 15 包含兼容性切换开关,可让您更轻松地测试应用 。对于可调试的应用,切换开关可让您:

  • 在不实际更改应用的 targetSdkVersion 的情况下测试针对性的变更。您可以使用切换开关强制启用特定的针对性行为变更,以评估对现有应用的影响。
  • 仅针对特定变更进行测试。您可以使用切换开关停用除要测试的变更之外的所有针对性变更,而不必一次处理所有针对性变更。
  • 通过 adb 管理切换开关。您可以使用 adb 命令启用 在自动化测试环境中停用可切换的更改。
  • 使用标准变更 ID 更快地进行调试。每个可切换的变更都有一个 可用于在日志中快速调试根本原因的唯一 ID 和名称 输出。

在您准备更改应用的目标平台时,或处于活跃状态时 进行开发时,切换开关将十分有用。如需更多信息 请参阅兼容性框架变更 (Android 15)