将应用迁移到 Android 9

Android 9(API 级别 28)引入了可在您的应用中利用的新功能和 API,以及新的行为变更。本文档概述了在两个关键阶段将您的应用迁移到 Android 9 的步骤

  1. 确保与 Android 9 的基本兼容性

    验证您的现有应用在新版平台上是否完全正常运行。在此阶段,您无需使用新的 API 或更改应用的 targetSdkVersion,但可能需要进行一些小的更改。

  2. 以新平台为目标,使用 Android 9 SDK 编译,并使用 Android 9 功能构建

    当您准备好利用平台的新功能时,将您的 targetSdkVersion 更新为 28,验证应用继续按预期运行,然后开始使用新的 API。

准备运行 Android 9 的设备

如果您有兼容的设备,请从制造商处获取设备的 Android 9 系统映像;点击此处获取 Pixel 设备的出厂映像。刷机系统映像的常规说明 在此处

您还可以为 Android 模拟器下载 Android 9 系统映像。它在 SDK 管理器 中的 Android API 28 下列出为 Google APIs Intel x86 Atom 系统映像

注意:Android 9 模拟器系统映像可在 Android Studio 3.1 及更高版本中下载;Android Studio 3.2 提供最大兼容性。有关更多信息,请参阅 获取 Android 9 SDK

确保与 Android 9 兼容

这里的目标是确保您的现有应用在 Android 9 上按原样工作。由于某些平台更改可能会影响应用的行为方式,因此可能需要进行一些调整,但您无需使用新的 API 或更改 targetSdkVersion

Ensure compatibility with Android 9 step-by-step

执行兼容性测试

在大多数情况下,与 Android 9 的兼容性测试与您在准备发布应用时执行的相同类型的测试。现在是时候回顾 核心应用质量指南测试最佳实践 了。

但是,测试还有另一个方面:Android 9 对 Android 平台进行了一些更改,即使您不更改 targetSdkVersion,这些更改也可能会影响应用的行为或导致应用完全崩溃。因此,务必查看表 1 中的关键更改,并测试您为适应这些更改而实施的任何修复。

表 1. 影响在 Android 9 设备上运行的所有应用的关键更改。

更改 摘要
对非 SDK 接口的限制 现在阻止了对特定非 SDK 接口的访问,无论访问是直接的、通过 JNI 还是通过反射。尝试访问受限制的接口会生成错误,例如 NoSuchFieldExceptionNoSuchMethodException。有关详细信息,请参阅 对非 SDK 接口的限制
删除 Crypto 提供程序 从 Android 9 开始,已删除 Crypto JCA 提供程序。调用 SecureRandom.getInstance("SHA1PRNG", "Crypto") 将抛出 NoSuchProviderException
更严格的 UTF-8 解码器 在 Android 9 中,Java 语言的 UTF-8 解码器更严格,并遵循 Unicode 标准。
阻止空闲应用访问相机、麦克风和传感器 当应用处于空闲状态时,它们将无法再访问相机、麦克风或 SensorManager 传感器。

有关在 Android 9 上运行的所有应用的行为更改的更完整列表,请参阅 行为更改 文档。

更新您的目标版本并使用 Android P 功能

本部分说明如何通过将您的 targetSdkVersion 更新为 28 并添加 Android 9 中可用的新功能来启用对 Android 9 的完全支持。

除了为您提供新的 API 之外,当您将 targetSdkVersion 更新为 28 时,Android 9 还会引入一些行为更改。由于某些行为更改可能需要代码更改以避免中断,因此您应首先了解当您更改 targetSdkVersion 时您的应用可能会受到哪些影响,方法是查看所有 针对 Android 9 的应用的行为更改

注意:上面描述的 确保平台兼容性 的步骤是将您的应用定位到 Android 9 的先决条件,因此请务必先完成这些步骤。

Update target version and use Android 9 features step-by-step

获取 Android 9 SDK

您可以使用 Android Studio 3.1 或更高版本获取用于使用 Android 9 构建应用的 SDK 软件包。如果您现在不需要 Android 9 中的新功能,并且只想针对该版本的平台进行编译,则可以使用 Android Studio 3.1Android Studio 3.2 提供对 Android 9 功能的完全支持。

测试您的 Android 9 应用

完成以上准备工作后,您可以构建您的应用,然后对其进行进一步测试,以确保它在以 Android 9(API 级别 28)为目标时能够正常工作。这也是再次回顾 核心应用质量指南测试最佳实践 的好时机。

当您使用 targetSdkVersion 设置为 P 构建您的应用时,需要注意一些特定的平台更改。即使您没有在 Android 9 中实现新功能,其中一些更改也可能会严重影响您的应用行为,甚至导致应用完全崩溃。

表 2 提供了这些更改的列表以及更多信息的链接。

表 2.targetSdkVersion 设置为 28 时会影响应用的关键更改。

更改 摘要
前台服务权限 想要使用前台服务的应用现在必须首先请求 FOREGROUND_SERVICE 权限。这是一个普通权限,因此系统会自动将其授予请求的应用。在没有权限的情况下启动前台服务会抛出 SecurityException。
弃用 Bouncy Castle 密码 Android 9 弃用了一些来自 Bouncy Castle 提供程序的密码,转而使用 Conscrypt 提供程序提供的密码。请求 Bouncy Castle 提供程序的 getInstance() 调用会生成 NoSuchAlgorithmException 错误。要解决这些错误,请不要在 getInstance() 中指定提供程序(即,请求默认实现)。
移除对 Build.serial 的直接访问 需要 Build.serial 标识符的应用现在必须请求 READ_PHONE_STATE 权限,然后使用 Android 9 中添加的新 Build.getSerial() 方法。
禁止共享 WebView 数据目录 应用无法再跨进程共享单个 WebView 数据目录。如果您的应用有多个进程使用 WebView、CookieManager 或 android.webkit 包中的任何其他 API,则当第二个进程调用 WebView 方法时,您的应用将会崩溃。
SELinux 阻止访问应用的数据目录 系统通过每个应用私有数据目录上的每个应用 SELinux 限制来执行每个应用的 SELinux 沙箱。现在不允许通过路径直接访问其他应用的数据目录。应用可以继续使用 IPC 机制共享数据,包括通过传递 FD。

有关针对 Android 9 的应用的行为更改的更完整列表,请参阅 行为更改 文档。

要探索 Android 9 中可用的新功能和 API,请参阅 Android 9 功能和 API