满足 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 Cloud Messaging 消息。

• 权限更改

  • 系统限制对应用专用目录的访问。
  • 在应用外部公开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 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）

• 具有全屏意图的通知
  • 需要请求普通权限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接口。有关已阻止的非SDK接口的完整列表，请参阅Android 11中现在已阻止的非SDK接口。

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

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