满足 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 及更高版本的平台的应用

• 休眠和应用待机

  设计用于 针对休眠和应用待机进行优化 中描述的行为，这包括在几个平台版本中引入的增量更改。

  当设备处于休眠和应用待机模式时，系统将按如下方式运行

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

• 权限更改

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

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

有关 Android 7.0 (API 级别 24) 中引入的更改的详尽列表，请参阅该版本的平台的 行为更改 页面。

继续按照下一节中的说明操作。

迁移到 Android 8 (API 级别 26)

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

• 后台执行限制
  • 系统限制未在前台运行的应用的服务。
    • startService() 现在在应用尝试在禁止 startService() 时调用它时会抛出异常。
    • 要启动前台服务，应用必须使用 startForeground() 和 startForegroundService()。
    • 仔细查看对 JobScheduler API 所做的更改，如 Android 8.0 (API 级别 26) 行为更改页面 上所述。
    • Firebase 云消息传递 需要 版本 10.2.1 或更高版本的 Google Play 服务 SDK。
    • 使用 Firebase 云消息传递 时，消息传递受后台执行限制。当消息接收后需要后台工作时（例如，执行后台数据同步），您的应用应使用 Firebase 作业调度程序或 JobIntentService 来调度作业。有关更多信息，请参阅 Firebase 云消息传递文档。
  • 隐式广播
    • 隐式广播受到限制。有关处理后台事件的信息，请参阅 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)

• 具有全屏意图的通知
  • 需要请求普通权限 USE_FULL_SCREEN_INTENT（不是运行时权限）。
• 支持 可折叠设备 和大屏幕设备
  • 现在多个活动可以同时处于“已恢复”状态，但只有一个活动实际上获得了焦点。
    • 此更改会影响 onResume() 和 onPause() 的行为。
    • 新的生命周期概念“最顶层已恢复”，可以通过订阅 onTopResumedActivityChanged() 来检测。
      • 只有一个活动可以是“最顶层已恢复”。
  • 当 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 接口，获取已阻止的非 SDK 接口的完整列表。

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

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