Skip to content

Latest commit

 

History

History
117 lines (87 loc) · 11.4 KB

android-8.0-migration.md

File metadata and controls

117 lines (87 loc) · 11.4 KB
Raw

迁移应用到Android 8.0

Android 8.0引入了若干新的功能和API，并加入了即便您未对应用做任何更改仍可能对其行为产生影响的一些变动。为帮助您做好准备，本页面将说明如何执行兼容性测试，以及如何更新应用以便利用Android 8.0的新功能：

验证您的应用能够在新版本平台上全功能运行。在此阶段，您不需要使用新的API，也不需要更改应用的targetSdkVersion，但可能需要进行一些细微的更改。

当您准备好利用平台的新功能时，将targetSdkVersion更新至“O”，验证应用是否仍可按预期方式运行，然后开始使用新的API。

确保平台兼容性

这一步的目标是确保应用在Android 8.0上可照常运行。由于一些平台变化可能影响应用的行为方式，因此可能需要进行一些调整，但您不需要使用新的API或更改targetSdkVersion。

准备一台运行Android 8.0的设备

  • 如果您有一台兼容设备（Pixel、Pixel XL、Pixel C、Nexus 5X、Nexus 6P或Nexus Player），请从下载页面获得适合您的设备的Android 8.0系统映像，然后按照说明将映像刷入设备。
  • 或下载适用于Android Emulator的Android 8.0系统映像。它列于SDK 管理器的Android 8.0 Preview下，显示为Google APIs Intel x86 Atom System Image。

注：Android 8.0系统映像只能通过Android Studio 3.0 Canary下载。如需了解详细信息，请参阅下面一节以获取Android 8.0 SDK。

执行兼容性测试

与Android 8.0的兼容性测试多半与您准备发布应用时执行的测试属于同一类型。这时有必要回顾一下核心应用质量准则和测试最佳做法。

不过，测试还有另一个层面：Android 8.0向Android平台引入了一些变化，即便不对targetSdkVersion做任何变动，仍可能影响应用的行为或令其根本无法运行。因此，您必须回顾表 1中的关键变化，并对任何为适应这些变化而实现的修复进行测试。

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

变化 摘要 其他参考资料
后台位置更新频率下降 如果应用接收来自后台服务的位置更新，则其在Android 8.0上接收更新的频率要比旧版本Android低。具体地讲，后台服务接收位置更新的频率不能超过每小时几次。不过，当应用位于前台时，位置更新频率不变。 后台位置限制
不再支持net.hostname 查询net.hostname系统属性返回的结果为空。 无
send(DatagramPacket)引发新异常 如果之前执行的[connect(InetAddress, int)](https://developer.android.google.cn/reference/java/net/DatagramSocket.html#connect(java.net.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行为变更列表，另请参阅Android 8.0行为变更。

构建具有Android 8.0功能的应用

如表 2所述，除了提供新的API外，Android 8.0还会在您更新targetSdkVersion时引发其他行为变更。本节说明如何将开发环境设置为以新平台为目标，以及如何着手构建和测试Android 8.0 API带来的变化和新功能。

注：上述旨在确保平台兼容性的步骤是面向Android 8.0构建应用的先决条件，因此请您务必先完成这些步骤。

获取Android 8.0 SDK

  • 安装Android Studio 3.0 Canary。

    只有Android Studio 3.0包含对Android 8.0提供的所有新开发者功能的支持。因此您需要获得Android Studio 3.0 Canary版本，以便开始使用Android 8.0 SDK。但您仍可保留已安装的Android Studio稳定版。

  • 启动Android Studio 3.0，然后点击Tools > Android > SDK Manager打开SDK管理器。

  • 在SDK Platforms标签中，选中Show Package Details。在Android 8.0 Preview下选中下列项：

    • Android SDK Platform O
    • Google APIs Intel x86 Atom System Image（只需在使用模拟器时选中）

  • 切换到SDK Tools标签，选中所有已提供更新的项（点击每个显示破折号的复选框）。这应该包括下列必需项：

    • Android SDK Build-Tools 26.0.0（rc2 或更高版本）
    • Android SDK Platform-Tools 26.0.0（rc2 或更高版本）
    • Android Emulator 26.0.0
    • Support Repository

  • 点击OK安装所有选定的SDK软件包。

现在您就可以开始使用Android 8.0进行开发了。

更新构建配置

将compileSdkVersion、buildToolsVersion、targetSdkVersion和Support Library版本更新为下列版本：

android {
  compileSdkVersion 26
  buildToolsVersion '26.0.0'

  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 {
    maven {
        url 'https://maven.google.com'
        // Alternative URL is 'https://dl.google.com/dl/android/maven2/'
    }
}

您不能在此配置下发布应用。“O”版本是一个临时API级别，只能用于Android 8.0开发者预览期间的开发和测试。您必须等到最终 API 级别发布时再发布 Android 8.0 变更，届时再次更新配置。

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

由于Android 8.0引入了新的广播接收器限制，因此您应该移除所有为隐式广播Intent注册的广播接收器。将它们留在原位并不会在构建时或运行时令应用失效，但当应用运行在Android 8.0上时它们不起任何作用。

显式广播Intent（只有您的应用可以响应的Intent）在Android 8.0上仍以相同方式工作。

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

测试Android 8.0应用

完成以上准备工作后，您就可以构建应用，然后对其做进一步测试，以确保Android 8.0为目标平台时它能正常工作。这时有必要回顾一下核心应用质量准则和测试最佳做法。

如果您构建应用时设置了适用于Android 8.0的targetSdkVersion，应该注意特定的平台变化。即便您不实现Android 8.0中的新功能，其中的一些变化仍可能严重影响应用的行为或令其根本无法运行。

表 2列出了这些变化以及可获得更多信息的链接。

表 2. targetSdkVersion设置为“O”时影响应用的关键变化。

变化 摘要 其他参考资料
隐私性 Android 8.0不支持使用net.dns1、net.dns2、net.dns3或net.dns4系统属性。 行为变更：隐私性
实行了可写且可执行的代码段 对于原生库，Android 8.0实行的规则是：数据不应可执行，代码不应可写。 行为变更：原生库
ELF标头和节验证 动态链接器对ELF标头和节头中的更多值进行检查，如果值无效则失败。 行为变更：原生库
通知 以SDK的Android 8.0版本为目标平台的应用必须实现一个或多个通知渠道，以便向用户发布通知
[List.sort()](https://developer.android.google.cn/reference/java/util/List.html#sort&#40;java.util.Comparator<? super E>))方法 该方法的实现不得再调用Collections.sort()，否则应用将因堆栈溢出而引发异常。 行为变更：集合的处理
Collections.sort()方法 在列表实现中，Collections.sort()现在会引发ConcurrentModificationException。 行为变更：集合的处理

如需查看更详尽的Android 8.0行为变更列表，请参阅Android 8.0行为变更。

要想探究Android 8.0提供的新功能和新API，请参阅Android 8.0功能和APIs。