符合 Google Play 的目标 API 级别要求

您上传的 APK 必须符合 Google Play 的目标 API 级别要求

新应用必须以 Android 12(API 级别 31)或更高版本为目标平台;Wear OS 应用除外,此类应用必须以 Android 11(API 级别 30)或更高版本为目标平台。

从 2022 年 11 月开始,新版应用必须以 API 级别 31 或更高级别为目标运行环境,并针对 Android 12 中的行为变更进行调整。

注意:从 2022 年开始,搭载更高 Android 版本的设备的新用户将无法使用部分过时的应用。

为何要以较新的 SDK 为目标平台?

每个新的 Android 版本都会引入一些变化,以便改进安全性和性能,并提升 Android 用户体验。部分变更只会影响通过 targetSdkVersion 清单属性(也称为目标 API 级别)明确声明支持这些变更的应用。

将应用的目标 API 级别配置为新近的 API 级别可确保用户享受到这些改进,而同时仍可让应用在较低版本的 Android 上运行。支持新近的 API 级别还有助于让您的应用利用平台的最新功能,为用户提供愉悦的体验。此外,从 Android 10(API 级别 29)开始,如果应用的目标平台为 Android 5.1(API 级别 22)或更低版本,用户首次启动应用时会看到警告

本文重点介绍了有关更新目标 API 级别的重要须知,以便您满足 Google Play 的要求

从较低版本迁移时,请参见下方的完整变更列表

注意:如果您的 Gradle 文件包含清单条目,您可以按照配置 build 中的说明,确认或更改应用的 Gradle 文件中当前的 targetSdkVersion 值。或者,您也可以按照 <uses-sdk> 清单元素文档中的说明,使用清单文件中的 android:targetSdkVersion 属性。

从 Android 11(API 级别 30)迁移到 Android 12(API 级别 31)

安全与权限

用户体验

  • 自定义通知:包含自定义内容视图的通知将不再使用完整的通知区域;相反,系统会应用标准模板。此模板可确保自定义通知在所有状态下都与其他通知的装饰相同。此行为与 Notification.DecoratedCustomViewStyle 的行为几乎完全相同。
  • Android App Links 验证的变更:在使用 Android App Links 验证时,请确保您的 intent 过滤器包含 BROWSABLE 类别并支持 HTTPS 架构。

性能

  • 前台服务启动限制:以 Android 12 或更高版本为目标平台的应用无法在后台运行时启动前台服务,但少数特殊情况除外。如果应用尝试在后台运行时启动前台服务,则会引发异常(少数特殊情况除外)。

    当您的应用在后台运行时,请考虑使用 WorkManager 来计划和启动加急工作。如需完成用户请求的紧急操作,请按照精确的闹钟启动前台服务。

  • 通知 trampoline 限制:当用户点按通知时,某些应用会启动一个应用组件来做出响应,该组件会启动用户看到并与之互动的 activity。该应用组件被称为通知 trampoline。

    应用不得从用作通知 trampoline 的服务或广播接收器中启动 activity。当用户点按通知或通知中的操作按钮后,您的应用无法在服务或广播接收器内调用 startActivity()

查看会影响以 Android 12(API 级别 31)为目标平台的应用的完整变更列表

从低于 Android 11(API 级别 30)的版本迁移

请选择您要迁出数据的 Android 版本:

迁移到 Android 5(API 级别 21)

请查看下列每个版本对应的“行为变更”页面,以确保您的应用已将这些版本推出的变更纳入考量:

如要继续,请按照下一部分中的说明操作。

迁移到 Android 6(API 级别 23)

以下注意事项适用于以 Android 6.0 及更高版本为目标平台的应用:

  • 运行时权限

    • 危险权限只能在运行时授予。您的界面操作流程必须提供授予这些权限的手动启示。

    • 确保您的应用尽可能做好准备,以应对权限请求遭拒的情况。例如,如果用户拒绝应用访问设备 GPS 的请求,您的应用应该能够以其他方式继续运行。

如需查看 Android 6.0(API 级别 23)所推出变更的详尽列表,请参阅相应平台版本的行为变更页面。

如要继续,请按照下一部分中的说明操作。

迁移到 Android 7(API 级别 24)

以下注意事项适用于以 Android 7.0 及更高版本为目标平台的应用:

  • 低电耗模式和应用待机模式

    按照针对低电耗模式和应用待机模式进行优化一文的说明设计应用行为;这篇文章同时也说明了在多个平台版本中推出的增量变更。

    当设备处于低电耗模式和应用待机模式时,系统的行为如下:

    • 限制网络访问权限
    • 延迟提醒、同步和作业
    • 限制 GPS 和 WLAN 扫描
    • 限制一般优先级的 Firebase Cloud Messaging 消息。
  • 权限更改

    • 系统限制访问应用的私有目录。
    • 在您的应用之外显示 file:// URI 会触发 FileUriExposedException。如果您需要将文件共享到自己的应用之外,请实现 FileProvider
  • 系统禁止链接到非 NDK 库。

如需查看 Android 7.0(API 级别 24)所推出变更的详尽列表,请参阅相应平台版本的行为变更页面。

如要继续,请按照下一部分中的说明操作。

迁移到 Android 8(API 级别 26)

以下注意事项适用于以 Android 8.0 及更高版本为目标平台的应用:

如需查看 Android 8.0(API 级别 26)所推出变更的详尽列表,请参阅相应平台版本的行为变更页面。

从 Android 8 (API 26) 迁移到 Android 9 (API 28)

如需查看 Android 9.0(API 级别 28)所推出变更的详尽列表,请参阅行为变更

从 Android 9(API 级别 28)迁移到 Android 10(API 级别 29)

从 Android 10(API 级别 29)迁移到 Android 11(API 级别 30)

如需查看 Android 11(API 级别 30)所推出变更的详尽列表,请参阅行为变更页面。

按照上一部分中的说明继续更新到 API 31。

翻新您的应用

更新应用的目标 API 级别时,不妨考虑采用最新的平台功能翻新应用,为用户提供愉悦的体验。

检查及更新您的 SDK 和库

请确保您的第三方 SDK 依赖项支持 API 29:部分 SDK 提供商会在清单中发布这项信息;而对于其他 SDK 提供商,则需要再进行调查。如果您使用的 SDK 不支持 API 29,请与 SDK 提供商合作,优先解决该问题。

另请注意,您的应用或游戏的 targetSdkVersion 可能会限制对私有 Android 平台库的访问;如需了解详情,请参阅 NDK 应用链接至平台库

您还应确认正在使用的 Android 支持库版本中存在哪些限制。与以往一样,您必须确保 Android 支持库的主要版本与您的应用的 compileSdkVersion 兼容。

我们建议您选择不高于支持库主要版本的 targetSdkVersion。您最好更新至最新的兼容支持库,以便利用最新的兼容性功能和问题修复程序。

测试您的应用

适当更新应用的 API 级别和功能后,您应测试部分核心用例。下面仅列举部分建议,旨在引导您进行测试。我们建议您针对以下方面进行测试:

  • 您的应用已编译为 API 29,且没有出现错误或警告。
  • 您的应用对用户拒绝权限请求的情况已有应对策略,且会提示用户授予权限。测试方法如下:
    • 转到应用的“应用信息”屏幕,然后停用所有权限。
    • 打开应用,确保不会出现崩溃问题。
    • 执行核心用例测试,并确保系统会再次提示用户授予所需权限。

  • 低电耗模式可呈现预期效果,且不会出现错误。
    • 使用 adb,让测试设备在您的应用正在运行时进入低电耗模式。
      • 测试所有会触发 Firebase 云消息传递消息的用例。
      • 测试所有使用闹钟或作业的用例。
      • 消除后台服务的所有依赖项。
    • 将您的应用设为应用待机模式
      • 测试所有会触发 Firebase 云消息传递消息的用例。
      • 测试所有使用闹钟的用例。

  • 处理拍摄的新照片/视频
  • 处理将文件共享给其他应用的操作
    • 测试所有将文件数据共享给任何其他应用(甚至是同一开发者推出的其他应用)的用例
    • 测试内容是否在其他应用中可见而不会触发崩溃。

更多信息

在 Google Play 管理中心内选择接收电子邮件,以便接收我们向您发送的 Android 和 Google Play 重要更新及公告,包括每月的合作伙伴简报。