d8 是 Android Studio 和 Android Gradle 插件用于将项目 Java 字节码编译为在 Android 设备上运行的 DEX 字节码的命令行工具。d8 允许您在应用代码中使用 Java 8 语言功能。
d8 也作为独立工具包含在 Android Build Tools 28.0.1 及更高版本中：android_sdk/build-tools/version/。
一般用法
d8 只需要要转换为 DEX 字节码的已编译 Java 字节码的路径。例如
d8 MyProject/app/build/intermediates/classes/debug/*/*.class
输入字节码可以是 *.class 文件或容器（如 JAR、APK 或 ZIP 文件）的任意组合。您还可以包含 DEX 文件，以便 d8 合并到 DEX 输出中，这在包含增量构建的输出时非常有用。
默认情况下，d8 将 Java 字节码编译成优化的 DEX 文件，并包含可在运行时用于调试代码的调试信息。但是，您可以包含可选标志来执行增量构建，指定应编译到主 DEX 文件中的类，并指定使用 Java 8 语言功能所需的附加资源的路径。
d8 path-to-input-files [options]
下表描述了您可以与 d8 一起使用的可选标志
| 选项 | 描述 |
|---|---|
--debug
|
编译 DEX 字节码以包含调试信息，例如调试符号表。 此选项默认启用。要在 DEX 字节码中包含调试信息， 编译应用或库的发布版本的 DEX 文件时，请改用 |
--release
|
编译 DEX 字节码，不包含调试信息。但是， 编译用于公开发布的字节码时，请传递此标志。 |
--output path
|
指定所需的 DEX 输出路径。默认情况下， 如果指定了 ZIP 或 JAR 文件的路径和名称， |
--lib android_sdk/platforms/api-level/android.jar
|
指定 Android SDK 的 android.jar 的路径。当编译使用 Java 8 语言功能的字节码时，此标志是必需的。 |
--classpath path
|
指定 d8 可能需要编译项目的 DEX 文件的类路径资源。特别是，当编译使用 Java 8 语言功能的字节码时，d8 需要您指定某些资源。 |
--min-api number
|
指定您希望输出 DEX 文件支持的最低 API 级别。 |
--intermediate
|
传递此标志以让 d8 知道您没有编译项目 Java 字节码的完整集合。此标志在执行增量构建时很有用。而不是编译您期望在设备上运行的优化 DEX 文件，d8 会创建中间 DEX 文件并将它们存储在指定的输出或默认路径中。当您要编译打算在设备上运行的 DEX 文件时，请排除此标志并将中间 DEX 类的路径指定为输入。 |
--file-per-class
|
将每个类编译成单独的 DEX 文件。 启用此标志允许您通过仅重新编译已更改的类来执行更多增量构建。在使用 Android Gradle 插件执行增量构建时，此优化默认启用。 在同时指定 |
--no-desugaring
|
禁用 Java 8 语言功能。仅当您不打算编译使用 Java 8 语言功能的 Java 字节码时，才使用此标志。 |
--main-dex-list path
|
指定一个文本文件，其中列出了 由于Android系统在启动应用时首先加载主DEX文件，因此您可以使用此标志通过将某些类编译到主DEX文件中来优先考虑启动时的某些类。这在支持旧版Multidex时尤其有用，因为在加载旧版Multidex库之前，只有主DEX文件中的类在运行时可用。 请记住，每个DEX文件仍必须满足64K引用限制。因此，不要为主要DEX文件指定太多类，否则会发生编译错误。默认情况下，当使用 您不能在同时指定 |
--pg-map file
|
使用file作为分发映射文件。 |
--file-per-class-file
|
为每个输入.class文件生成一个单独的DEX文件。 将合成类与其源类保留在一起。 |
--desugared-lib file
|
指定一个去糖化库配置。 file是JSON格式的去糖化库配置文件。 |
--main-dex-rules file
|
用于放置在主DEX文件中的类的Proguard保留规则。 |
--main-dex-list-output file
|
将生成的主DEX列表输出到 |
|
|
强制启用javac生成的断言代码。 |
|
|
强制禁用javac生成的断言代码。这是生成DEX文件时javac断言代码的默认处理方式。 |
|
|
不要更改javac生成的断言代码。这是生成class文件时javac断言代码的默认处理方式。 |
|
|
将javac和kotlinc生成的断言代码更改为调用方法handler method处理每个断言错误，而不是抛出它。handler method指定为类名后跟一个点和方法名。处理程序方法必须接受一个类型为java.lang.Throwable的参数，并且返回类型为void。 |
--thread-count number of threads
|
指定用于编译的线程数。如果未指定，则该数字基于启发式算法，并考虑核心数量。 |
--map-diagnostics[ :type] from-level to-level
|
将报告为from-level的type（默认为任何）诊断映射到to-level，其中from-level和to-level是'info'、'warning'或'error'之一，可选的type是诊断的简单或完全限定的Java类型名称。如果未指定type，则映射from-level下的所有诊断。请注意，无法映射致命编译器错误。 |
--version
|
打印您当前正在使用的d8的版本。 |
--help
|
打印使用d8的帮助文本。 |
执行增量构建
为了提高开发过程中的构建速度，例如持续集成构建，请指示d8仅编译项目Java字节码的子集。例如，如果您启用了每个类的dexing，则可以仅重新编译自上次构建以来修改过的类。
以下命令执行一些类的增量构建并启用每个类的dexing。该命令还为增量构建指定了一个输出目录。
d8 MainActivity.class R.class --intermediate --file-per-class --output ~/build/intermediate/dex
当d8执行增量构建时，它会在DEX输出中存储其他信息。d8稍后将使用该信息正确处理--main-dex-list选项并在应用的完整构建期间合并DEX文件。
例如，在处理Java 8 lambda类时，d8会跟踪为每个输入类创建了哪些lambda类。在完整构建期间，当d8将类包含在主DEX文件中时，它会查阅元数据以确保为该类创建的所有lambda类也包含在主DEX文件中。
如果您已经将项目的所有字节码编译到多个增量构建中的DEX文件中，请通过将中间DEX文件的目录传递给d8来执行完整构建，如下面的命令所示。此外，您可以使用--main-dex-list指定希望d8编译到主DEX文件中的类。由于输入是一组已编译成DEX字节码的文件，因此此构建应比干净构建完成得更快。
d8 ~/build/intermediate/dex --release --main-dex-list ~/build/classes.txt --output ~/build/release/dex
编译使用Java 8语言功能的字节码
d8使您能够在代码中使用Java 8语言功能，这通过称为“去糖化”的编译过程实现。去糖化将这些有用的语言功能转换为可以在Android平台上运行的字节码。
Android Studio和Android Gradle插件包含d8为您启用去糖化所需的类路径资源。但是，当从命令行使用d8时，您需要自己包含它们。
其中一个资源是目标Android SDK中的android.jar。此资源包含一组Android平台API。使用--lib标志指定其路径。
另一个资源是编译到项目中但您当前未编译成DEX字节码，但需要编译其他类成DEX字节码的一组Java字节码。
例如，如果您的代码使用默认和静态接口方法（这是Java 8语言功能），则需要使用此标志指定项目中所有Java字节码的路径，即使您不打算将所有字节码编译成DEX字节码。这是因为d8需要此信息来了解项目的代码并解析对接口方法的调用。
以下代码示例执行访问默认接口方法的类的增量构建
d8 MainActivity.class --intermediate --file-per-class --output ~/build/intermediate/dex --lib android_sdk/platforms/api-level/android.jar --classpath ~/build/javac/debug