满足 Google Play 的目标 API 级别要求

从低于 Android 11（API 级别 30）的版本迁移

选择您将从哪个 Android 版本迁移

迁移到 Android 5（API 级别 21）

请参阅以下每个版本的“行为变更”页面，以确保您的应用已考虑这些版本中引入的变更

• Android 5.0（API 级别 21）
• Android 4.4（API 级别 19）.
• Android 4.1.x（API 级别 16）.

继续遵循下一节中的说明。

迁移到 Android 6（API 级别 23）

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

• 运行时权限

  • 危险权限仅在运行时授予。您的 UI 流程必须提供授予这些权限的途径。

  • 尽可能确保您的应用已准备好处理权限请求的拒绝。例如，如果用户拒绝访问设备 GPS 的请求，请确保您的应用有其他方法继续。

有关 Android 6.0（API 级别 23）中引入的变更的完整列表，请参阅该平台版本的行为变更页面。

继续遵循下一节中的说明。

迁移到 Android 7（API 级别 24）

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

• Doze 和应用待机

  设计符合优化 Doze 和应用待机模式中描述的行为，这包含了多个平台版本中引入的增量更改。

  当设备处于 Doze 和应用待机模式时，系统行为如下

  • 限制网络访问
  • 推迟闹钟、同步和作业
  • 限制 GPS 和 Wi-Fi 扫描
  • 限制普通优先级 Firebase Cloud Messaging 消息。

• 权限变更

  • 系统限制对应用私有目录的访问。
  • 在应用外部公开 file:// URI 会触发 FileUriExposedException。如果您需要在应用外部共享文件，请实现 FileProvider

• 系统禁止链接到非 NDK 库。

有关 Android 7.0（API 级别 24）中引入的变更的完整列表，请参阅该平台版本的行为变更页面。

继续遵循下一节中的说明。

迁移到 Android 8（API 级别 26）

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

• 后台执行限制
  • 系统限制了非前台运行应用的 Service。
    • startService() 现在在应用尝试在 startService() 被禁止时调用它时会抛出异常。
    • 要启动前台服务，应用必须使用 startForeground() 和 startForegroundService()。
    • 请仔细查看对 JobScheduler API 所做的更改，如 Android 8.0（API 级别 26）行为变更页面中所述。
    • Firebase Cloud Messaging 需要 10.2.1 版本或更高版本的 Google Play 服务 SDK。
    • 使用 Firebase Cloud Messaging 时，消息传递受后台执行限制。当消息接收后需要执行后台工作（例如执行后台数据同步）时，您的应用应改用 Firebase Job Dispatcher 或 JobIntentService 调度作业。有关更多信息，请参阅 Firebase Cloud Messaging 文档。
  • 隐式广播
    • 隐式广播受到限制。有关处理后台事件的信息，请参阅 JobScheduler API 的文档。
  • 后台位置限制
    • 在后台运行的应用对位置数据的访问受到限制。
      • 在安装了 Google Play 服务的设备上，使用 融合位置提供程序 获取定期位置更新。
• 通知渠道
  • 您应该根据每个渠道定义通知中断属性。
  • 您必须将通知分配给一个渠道，通知才能显示。
  • 此平台版本支持 NotificationCompat.Builder。
• 隐私
  • ANDROID_ID 按应用签名密钥进行限定。

有关 Android 8.0（API 级别 26）中引入的变更的完整列表，请参阅该平台版本的行为变更页面。

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

• 电源管理
  • 应用待机“应用桶”带来了基于应用参与度的新后台限制，例如延迟的作业、闹钟和高优先级消息的配额
  • 省电模式改进增加了对应用待机应用的限制
• 前台服务权限
  • 需要请求正常权限 FOREGROUND_SERVICE（不是运行时权限）
• 隐私变更
  • 对后台传感器的访问受限
  • 对通话记录的访问受限，现在位于 CALL_LOG 权限组中
  • 对电话号码的访问受限，需要 READ_CALL_LOG 权限
  • 对 Wi-Fi 信息的访问受限

有关 Android 9.0（API 级别 28）中引入的变更的完整列表，请参阅行为变更。

从 Android 9（API 级别 28）迁移到 Android 10（API 级别 29）

• 具有全屏 Intent 的通知
  • 需要请求正常权限 USE_FULL_SCREEN_INTENT（不是运行时权限）。
• 支持折叠屏和大屏幕设备
  • 现在可以有多个 Activity 同时处于“resumed”状态，但只有一个 Activity 实际获得焦点。
    • 此变更会影响 onResume() 和 onPause() 的行为。
    • 新的生命周期概念“topmost resumed”，可以通过订阅 onTopResumedActivityChanged() 来检测。
      • 只有一个 Activity 可以是“topmost resumed”。
  • 当 resizeableActivity 设置为 false 时，应用还可以指定 minAspectRatio，这会在更窄的宽高比上自动为应用添加黑边。
• 隐私变更
  • 分区存储
    • 外部存储访问仅限于应用专属目录和应用已创建的特定媒体类型。
  • 应用在后台时对位置的访问受限，需要 ACCESS_BACKGROUND_LOCATION 权限。
  • 对不可重置标识符（例如 IMEI 和序列号）的访问受限。
  • 对身体活动信息（例如用户的步数）的访问受限，需要 ACTIVITY_RECOGNITION 权限。
  • 对某些电话、蓝牙和 Wi-Fi API 的访问受限，需要 ACCESS_FINE_LOCATION 权限。
  • 对 Wi-Fi 设置的访问受限
    • 应用不再能直接启用或禁用 Wi-Fi，需要使用设置面板进行操作。
    • 限制发起 Wi-Fi 网络连接，需要使用 WifiNetworkSpecifier 或 WifiNetworkSuggestion。

从 Android 10（API 级别 29）迁移到 Android 11（API 级别 30）

• 隐私
  • 分区存储强制执行：应用应采用分区存储模型，其中应用专属、媒体和其他文件类型使用专用位置保存和访问。
  • 权限自动重置：如果用户几个月没有与应用互动，系统会自动重置应用的敏感权限。这应该不会影响大多数应用。如果您的应用主要在后台工作而无需用户互动，您可能会考虑请求用户禁用自动重置。
  • 后台位置访问：应用必须分别请求前台和后台位置权限。访问后台位置权限只能在应用设置中授予，而不是在运行时权限对话框中。
  • 软件包可见性：当应用查询设备上已安装应用和服务的列表时，返回的列表会经过过滤。
    • 如果您使用文本转语音或语音识别服务，您需要向清单文件添加服务的查询元素。
• 安全
  • 不再支持压缩的 `resource.arsc` 文件
  • 现在需要 APK 签名方案 v2。出于向后兼容性原因，开发者还应继续使用 APK 签名方案 v1 进行签名。
  • 非 SDK 接口限制。不建议以 API 级别 30 为目标的应用使用非 SDK 接口，因为其中一些非 SDK 接口现在已被阻止。有关已在 Android 11 中阻止的非 SDK 接口的完整列表，请参阅Android 11 中现已阻止的非 SDK 接口。

有关 Android 11（API 级别 30）中引入的变更的完整列表，请参阅行为变更页面。

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