Save the date! Android Dev Summit is coming to Mountain View, CA on November 7-8, 2018.

将应用迁移到 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 Emulator 下载 Android 9 系统镜像。它列于 SDK 管理器Android 9 下,显示为 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 平台引入了一些变化,即便不对 targetSdkVersion 做任何变动,仍可能影响应用的行为或令其根本无法运行。因此,您必须回顾表 1 中的关键变化,并对任何为适应这些变化而实现的修复进行测试。

表 1. 对在 Android 9 设备上运行的所有应用都有影响的关键变化。

变化 摘要
对于非 SDK 接口的限制 现已禁止访问特定的非 SDK 接口,无论是直接访问,还是通过 JNI 或反射进行间接访问。尝试访问受限制的接口时,会生成 NoSuchFieldExceptionNoSuchMethodException 之类的错误。详情请参阅对于非 SDK 接口的限制
移除加密提供程序 从 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 SDK

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

要设置任一版本的 Android Studio,请按照设置 Preview SDK 中介绍的步骤操作。

测试 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