使用 Java 8 语言功能

    注：在开发 Android 应用时，可以选择使用 Java 8 语言功能。 您可以将项目的源代码和目标代码兼容性值保留为 Java 7，但仍须使用 JDK 8 进行编译。

    Android Studio 为使用部分 Java 8 语言功能及利用这些功能的第三方库提供内置支持。 如图 1 所示，默认工具链对 编译器的输出执行字节码转换（称为 desugar），从而实现新语言功能。 Jack 不再受支持，您需要首先 才能使用默认工具链内置的 Java 8 支持。

    图 1. 采用 desugar 字节码转换的 Java 8 语言功能支持。

    要开始使用受支持的 Java 8 语言功能，请更新 Android 插件到 3.0.0（或更高版本）。 然后，针对使用（包括在源代码中或通过依赖项使用）Java 8 语言功能的每个模块，在其 build.gradle 文件中添加以下代码：

    虽然 Android Studio 并非支持所有 Java 8 语言功能，但未来发布的 IDE 版本将会增加更多功能。 目前，部分功能和 API 已可使用，具体取决于您所使用的 minSdkVersion，详见下表。

    除了上述 Java 8 语言功能和 API 之外，Android Studio 3.0 及更高版本还将对 的支持扩展到所有级别的 Android API。

    Desugar 目前暂不支持 MethodHandle.invoke 或 。如果您的源代码或任一模块依赖项使用了其中一种函数，则需指定 minSdkVersion 26 或更高版本。 否则会出现以下错误：

    1. Dex: Error converting bytecode to dex:
    2. Cause: signature-polymorphic method called without --min-sdk-version >= 26

    在某些情况下，即使您的模块包含在库依赖项中，也可能不会使用 invoke 或 invokeExact 函数。 因此，要继续使用 minSdkVersion 25 或更低版本的库，请通过启用代码压缩 移除未使用的函数。 如果这种方法无效，可考虑使用一个替代库，该库不使用未受支持的函数。

    如果 Android Studio 检测到您的项目使用了 Jack、 或 DexGuard，IDE 则会使用由这些工具提供的 Java 8 支持。 但与默认工具链相比，这些工具缺乏部分功能和支持。 所以，请参照本节说明迁移至 Android Studio 的默认工具链。

    要停用 Jack 并切换至默认工具链，只需从您的模块 build.gradle 文件中移除 jackOptions 块即可：

    从 Retrolambda 迁移

    与 Android Studio 的默认工具链相比，Retrolambda 缺少对使用 Java 8 语言功能的第三方库的支持。 要迁移到默认工具链，请从您的项目级 build.gradle 文件中移除 Retrolambda 依赖项：

    1. buildscript {
    2.   ...
    3.       // Remove the following dependency.
    4.       classpath 'me.tatarka:gradle-retrolambda:<version_number>'
    5.    }
    6. }

    同时移除每个模块 build.gradle 文件中的 Retrolambda 插件和 retrolambda 块：

    如果您遇到与 Java 8 语言功能支持相关的问题，可在 文件中加入以下代码来停用此支持：

      为帮助我们改进对 Java 8 的支持，请。