Android 9(API 级别 28)引入了您可以在应用中利用的新功能和 API,以及新的行为变更。本文档概述了将应用迁移到 Android 9 的两个关键阶段的步骤
- 确保与 Android 9 的基本兼容性
验证您的现有应用在新版平台上的所有功能是否正常。在此阶段,您无需使用新的 API 或更改应用的
targetSdkVersion
,但可能需要进行少量修改。 - 以新平台为目标,使用 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 平台引入了更改,这些更改可能会影响您的应用行为,甚至完全破坏应用,即使您不更改 targetSdkVersion
。因此,务必查看表 1 中的关键更改,并测试您为适应这些更改而实施的任何修复。
表 1. 影响在 Android 9 设备上运行的所有应用的关键更改。
更改 | 摘要 |
---|---|
对非 SDK 接口的限制 | 现在,无论是直接访问、通过 JNI 还是通过反射,对特定非 SDK 接口的访问都被阻止。尝试访问受限接口会生成诸如 NoSuchFieldException 和 NoSuchMethodException 等错误。有关详细信息,请参阅对非 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 SDK
您可以使用 Android Studio 3.1 或更高版本获取 SDK 软件包以使用 Android 9 构建应用。如果您尚不需要 Android 9 中的新功能,并且只想针对该版本的平台进行编译,则可以使用 Android Studio 3.1。Android Studio 3.2 提供对 Android 9 功能的完整支持。
测试您的 Android 9 应用
完成上述准备工作后,您可以构建应用并进行进一步测试,以确保其在以 Android 9(API 级别 28)为目标时正常运行。现在是回顾核心应用质量指南和测试最佳实践的又一个好时机。
当您将 targetSdkVersion
设置为 P 来构建应用时,您应该注意一些特定的平台更改。即使您不在 Android 9 中实现新功能,其中一些更改也可能显著影响您的应用行为,甚至完全破坏您的应用。
表 2 提供了这些更改的列表以及指向更多信息的链接。
表 2. 当 targetSdkVersion
设置为 28 时影响应用的关键更改。
更改 | 摘要 |
---|---|
前台服务权限 | 现在,想要使用前台服务(foreground services)的应用必须首先请求 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 机制共享数据,包括通过传递 FDs。 |
如需查看针对 Android 9 的应用行为变更的更详尽列表,请参阅行为变更文档。
如需探索 Android 9 中可用的新功能和 API,请参阅Android 9 功能和 API。