将应用迁移到 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 System Image

注意:Android 9 模拟器系统映像可在 Android Studio 3.1 及更高版本中下载;Android Studio 3.2 提供最高的兼容性。 如需了解详情,请参阅获取 Android 9 SDK

确保与 Android 9 兼容

这样做的目标是确保您的现有应用可在 Android 9 上正常运行。由于一些平台变更可能会影响应用的行为方式,因此可能需要进行一些调整,但您不需要使用新的 API 或更改 targetSdkVersion

逐步确保与 Android 9 兼容

执行兼容性测试

在大多数情况下,与 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 还引入了一些行为变更。由于某些行为变更可能需要更改代码以避免服务中断,因此您应该先查看以 Android 9 为目标平台的应用的所有行为变更,了解更改 targetSdkVersion 后应用会受到哪些影响。

注意:上述旨在确保平台兼容性的步骤是将应用以 Android 9 为目标平台的先决条件,因此请您务必先完成这些步骤。

逐步更新目标版本并使用 Android 9 功能

获取 Android 9 SDK

您可以获取 SDK 软件包,以便使用 Android Studio 3.1 或更高版本在 Android 9 中构建应用。 如果您不需要 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 提供程序提供的加密方式。调用 getInstance() 来请求 Bouncy Castle 提供程序时,系统会生成 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