迁移到 Android 8.0

Android 8.0(API 级别 26)引入了行为变更以及新功能和 API,您可以在应用中加以利用。本文档简要介绍了在两个关键阶段将应用迁移到 Android 8.0 的步骤:

  1. 确保与 Android 8.0 兼容

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

  2. 更新目标版本并使用 Android 8.0 功能

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

确保与 Android 8.0 兼容

此处的目的是确保现有应用在 Android 8.0(API 级别 26)上能正常运行。由于某些平台变更可能会影响应用的行为方式,因此可能需要进行一些调整,但您无需使用新的 API 或更改 targetSdkVersion。

逐步确保与 Android 8.0 兼容

准备一台搭载 Android 8.0 的设备

  • 如果您使用的是兼容设备(Pixel、Pixel XL、Pixel C、Nexus 5X、Nexus 6P 或 Nexus Player),请按照说明刷写设备。
  • 或者下载适用于 Android 模拟器的 Android 8.0 系统映像。它在 SDK 管理器中的 Android 8.0 下列为 Google API Intel x86 Atom 系统映像。

    注意:Android 8.0 系统映像可从 Android Studio 3.0 及更高版本下载。 如需了解详情,请参阅下文中的获取 Android 8.0 SDK。

执行兼容性测试

在大多数情况下,测试与 Android 8.0(API 级别 26)的兼容性与您在准备发布应用时执行的测试类型相同。这时有必要查阅核心应用质量指南和测试最佳实践。

不过,测试还有另一个方面:Android 8.0 引入了对 Android 平台的变更,这些变更可能会影响应用的行为或完全破坏应用,即使您不更改 targetSdkVersion 也是如此。因此,请务必查看表 1 中的主要变更,并测试您为适应这些变更而实施的所有修复。

表 1. 影响在 Android 8.0 设备上运行的所有应用的主要变更。

更改 摘要 更多参考信息
降低后台位置信息更新频率 如果您的应用通过后台服务接收位置信息更新,那么在 Android 8.0(API 级别 26)上,其接收更新的频率会低于在旧版 Android 上。具体而言,后台服务每小时接收位置信息更新的次数不能超过几次。不过,当您的应用在前台运行时,位置信息更新速率不会发生变化。 后台位置信息访问限制
已不再支持的net.hostname 查询 net.hostname 系统属性会产生 null 结果。 无
send(DatagramPacket)中出现新的异常 如果之前执行的 connect(InetAddress, int) 方法失败,send(DatagramPacket) 方法会抛出 SocketException。 行为变更:网络和 HTTP(S) 连接性
AbstractCollection 方法中的正确 NullPointerException AbstractCollection.removeAll(null) 和 AbstractCollection.retainAll(null) 现在始终会抛出 NullPointerException;之前,当集合为空时,不会抛出 NullPointerException。此更改使行为与文档保持一致。 行为变更:集合处理
Currency.getDisplayName(null)中的正确 NullPointerException 调用 Currency.getDisplayName(null) 会抛出 NullPointerException。 行为变更:语言区域和国际化

如需查看 Android 8.0(API 级别 26)中行为变更的更详尽列表,另请参阅 Android 8.0 行为变更。

更新目标版本并使用 Android 8.0 功能

本部分将介绍如何通过将 targetSdkVersion 更新为 26 并添加 Android 8.0 中提供的新功能,来启用对 Android 8.0(API 级别 26)的全面支持。

除了提供新的 API 之外,Android 8.0 还引入了一些行为变更,这些变更会在您将 targetSdkVersion 更新为 26 时生效。由于某些行为变更可能需要更改代码才能避免应用崩溃,因此您应首先查看以 Android 8.0 为目标平台的应用的行为变更,了解更改 targetSdkVersion 可能会对应用产生哪些影响。

注意:上述确保平台兼容性的步骤是将应用的目标平台设为 Android 8.0 的前提条件,因此请务必先完成这些步骤。

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

获取 Android 8.0 SDK

您可以使用最新版本的 Android Studio(建议使用 Android Studio 3.0 或更高版本)获取 SDK 软件包,以便使用 Android 8.0(API 级别 26)构建应用。 Android Studio 3.0+ 包含可帮助您使用 Android 8.0 功能(例如自适应图标和可下载字体)的工具。 如果您还不需要这些功能,则可以使用 Android Studio 2.3.3 的稳定版本,通过 Android 8.0 构建应用并使用新的 API。

如需设置任一版本的 Android Studio,请按以下步骤操作:

  1. 启动 Android Studio,然后依次点击 Tools > SDK Manager,打开 SDK 管理器。
  2. 在 SDK Platforms 标签页中,勾选 Show Package Details。在 Android 8.0 预览版下,检查以下内容:
    • Android SDK Platform 26
    • Google APIs Intel x86 Atom System Image(仅模拟器需要)
  3. 切换到 SDK 工具 标签页,然后勾选所有有可用更新的项(点击每个显示短划线 的复选框)。这应包括以下所需项的最新版本:
    • Android SDK Build-Tools 26.0.0
    • Android SDK Platform-Tools 26.0.0
    • Android 模拟器 26.0.0
  4. 点击 OK 以安装所有选定的 SDK 软件包。

现在,您可以开始使用 Android 8.0 进行构建了。

更新构建配置

将 compileSdkVersion、targetSdkVersion 和支持库版本更新为最新的可用修订版本,例如:

android {
  compileSdkVersion 26

  defaultConfig {
    targetSdkVersion 26
  }
  ...
}

dependencies {
  compile 'com.android.support:appcompat-v7:26.0.0'
}

// REQUIRED: Google's new Maven repo is required for the latest
// support library that is compatible with Android 8.0
repositories {
    google()

    // If you're using a version of Gradle lower than 4.1, you must instead use:
    // maven {
    //     url 'https://maven.google.com'
    // }
}

从清单文件中移除广播接收器

由于 Android 8.0(API 级别 26)引入了针对广播接收器的新限制,因此您应该移除所有为隐式广播 intent 注册的广播接收器。保留这些属性不会在构建时或运行时破坏应用,但当应用在 Android 8.0 上运行时,这些属性不会产生任何影响。

只有您的应用可以响应的广播(即显式广播 intent 和专门发送到应用软件包名称的广播)在 Android 8.0 上的运行方式保持不变。

这项新限制也有例外情况。如需查看在以 Android 8.0 为目标平台的应用中仍然有效的隐式广播列表,请参阅隐式广播例外。

测试 Android 8.0 应用

完成上述准备工作后,您可以构建应用,然后进一步测试,以确保应用在以 Android 8.0(API 级别 26)为目标平台时能够正常运行。这时有必要再次查阅核心应用质量指南和测试最佳实践。

当您将 targetSdkVersion 设置为 26 来构建应用时,您应该注意一些特定的平台变更。其中一些变更可能会对应用的行为产生重大影响,甚至可能导致应用完全无法运行,即使您未在 Android 8.0 中实现新功能也是如此。

表 2 列出了这些变更,并提供了指向更多信息的链接。

表 2. targetSdkVersion 设置为 26 时影响应用的主要变更。

更改 摘要 更多参考信息
隐私权 Android 8.0(API 级别 26)不支持使用 net.dns1、net.dns2、net.dns3 或 net.dns4 系统属性。 行为变更:隐私权
强制执行可写和可执行段 对于原生库,Android 8.0(API 级别 26)强制执行以下规则:数据不可执行,代码不可写入。 行为变更:原生库
ELF 标头和部分验证 动态链接器会检查 ELF 标头和部分标头中的更多值,如果这些值无效,则会失败。 行为变更:原生库
通知 以 Android 8.0(API 级别 26)版 SDK 为目标平台的应用必须实现一个或多个通知渠道,才能向用户发布通知。 API 概览:通知
List.sort() 方法 此方法的实现可能不再调用 Collections.sort(),否则您的应用会因堆栈溢出而抛出异常。 行为变更:集合处理
Collections.sort() 方法 在 List 实现中,Collections.sort() 现在会抛出 ConcurrentModificationException。 行为变更:集合处理

如需查看 Android 8.0(API 级别 26)中行为变更的更详尽列表,请参阅 Android 8.0 行为变更。

如需探索 Android 8.0(API 级别 26)提供的新功能和 API,请参阅 Android 8.0 功能和 API。