本文介绍了如何配置 ART 及其编译选项。讨论的主题包括：系统映像预编译配置、dex2oat 编译选项，以及如何在 system 分区空间、data 分区空间和性能这三者之间取得平衡。

ART 使用预先 (AOT) 编译，并且从 Android 7.0（代号 Nougat，简称 N）开始结合使用 AOT、即时 (JIT) 编译和配置文件引导型编译。所有这些编译模式的组合均可配置，我们将在本部分中对此进行介绍。例如，Pixel 设备配置了以下编译流程：

ART 包括一个编译器（dex2oat 工具）和一个为启动 Zygote 而加载的运行时 (libart.so)。dex2oat 工具接受一个 APK 文件，并生成一个或多个编译工件文件，然后运行时将会加载这些文件。文件的个数、扩展名和名称因版本而异，但在 Android O 版本中，将会生成以下文件：

.vdex：其中包含 APK 的未压缩 DEX 代码，以及一些旨在加快验证速度的元数据。 .odex：其中包含 APK 中已经过 AOT 编译的方法代码。 .art (optional)：其中包含 APK 中列出的某些字符串和类的 ART 内部表示，用于加快应用启动速度。

ART 的编译选项分为以下两个类别：

用于配置这两个类别的一个核心 ART 选项是“编译过滤器”。编译过滤器可控制 ART 如何编译 DEX 代码，是一个传递给 dex2oat 工具的选项。从 Android O 开始，有四个官方支持的过滤器：

verify：只运行 DEX 代码验证。 quicken：运行 DEX 代码验证，并优化一些 DEX 指令，以获得更好的解译器性能。 speed：运行 DEX 代码验证，并对所有方法进行 AOT 编译。 speed-profile：运行 DEX 代码验证，并对配置文件中列出的方法进行 AOT 编译。

有许多 ART 构建选项可用于配置系统 ROM。如何配置这些选项取决于 /system 的可用存储空间以及预安装应用的数量。编译到系统 ROM 中的 JAR/APK 可以分为以下四个类别：

Makefile 选项

WITH_DEXPREOPT 是否对系统映像上安装的 DEX 代码调用 dex2oat。默认处于启用状态。

DONT_DEXPREOPT_PREBUILTS（从 Android L 开始） 启用 DONT_DEXPREOPT_PREBUILTS 可防止对预构建应用进行预先优化。这些都是在 Android.mk 中指定了 include $(BUILD_PREBUILT) 的应用，例如 Gmail。如果不对这些可能要通过 Google Play 更新的预构建应用进行预先优化，可以节省 /system 的空间，但是会增加首次启动时间。

PRODUCT_DEX_PREOPT_DEFAULT_COMPILER_FILTER（从 Android 9 开始） PRODUCT_DEX_PREOPT_DEFAULT_COMPILER_FILTER 会为经过预先优化的应用指定默认编译过滤器。这些都是在 Android.mk 中指定了 include $(BUILD_PREBUILT) 的应用，例如 Gmail。如果未指定，则默认值为 quicken。

WITH_DEXPREOPT_BOOT_IMG_AND_SYSTEM_SERVER_ONLY（Android O MR1 中的新增选项） 如果启用 WITH_DEXPREOPT_BOOT_IMG_AND_SYSTEM_SERVER_ONLY，将只会对启动类路径和系统服务器 JAR 进行预先优化。

LOCAL_DEX_PREOPT 通过在模块定义中指定 LOCAL_DEX_PREOPT 选项，还可以针对个别应用启用或停用预先优化功能。这有助于避免对那些可能会立即收到 Google Play 更新的应用进行预先优化，因为更新之后，对系统映像中的代码所做的预先优化都成了无用功。此外，这还有助于在进行重大版本 OTA 升级时节省空间，因为用户的 data 分区中可能已经有了更高版本的应用。

LOCAL_DEX_PREOPT 支持分别使用值“true”和“false”来启用和停用预先优化功能。此外，如果在预先优化过程中不应将 classes.dex 文件从 APK 或 JAR 文件中剥离出来，则可以指定“nostripping”。通常情况下，此文件会被剥离出来，因为在进行预先优化之后将不再需要该文件；但若要使第三方 APK 签名仍保持有效，则必须使用最后这个选项。

PRODUCT_DEX_PREOPT_BOOT_FLAGS 将选项传递给 dex2oat 以控制如何编译启动映像。该选项可用于指定自定义映像类列表、已编译类列表，以及编译过滤器。

PRODUCT_DEX_PREOPT_DEFAULT_FLAGS 将选项传递给 dex2oat 以控制如何编译除启动映像之外的所有内容。

PRODUCT_DEX_PREOPT_MODULE_CONFIGS 用于为特定模块和产品配置传递 dex2oat 选项。该选项在产品的 device.mk 文件中通过 $(call add-product-dex-preopt-module-config,,) 设置，其中 是一个 LOCAL_MODULE（表示 JAR 文件）和 LOCAL_PACKAGE（表示 APK 文件）名称的列表。

PRODUCT_DEXPREOPT_SPEED_APPS (New in Android O) 一个应用列表，其中的应用被确定为产品的核心应用，并且应使用 speed 编译过滤器进行编译。例如，常驻应用（如 SystemUI）只有在下次系统重新启动时才有机会使用配置文件引导型编译，因此可能最好是让产品始终对这些应用进行 AOT 编译。

PRODUCT_SYSTEM_SERVER_APPS (New in Android O) 系统服务器加载的应用的列表。这些应用将默认使用 speed 编译过滤器进行编译。

PRODUCT_ART_TARGET_INCLUDE_DEBUG_BUILD(Post Android O) 是否在设备上包含 ART 的调试版本。默认情况下，系统会针对 userdebug build 和 eng build 启用此选项。可以通过将该选项明确设为“true”或“false”来覆盖此行为。

默认情况下，设备将使用非调试版本 (libart.so)。如需进行切换，请将系统属性 persist.sys.dalvik.vm.lib.2 设置为 libartd.so。

在 Android 7.0 中，PIC 编译默认处于启用状态。

启动类路径配置

使用示例（产品的 device.mk 中）：

注意：如果有任何从 build/target/product/base.mk 提取默认值的产品配置 Makefile，则此行必须放置在沿用任何这类 Makefile 的行之前。

使用示例（在产品的 device.mk 中）：

使用示例（在产品的 device.mk 中）：

注意：如果有任何从 build/target/product/base.mk 提取默认值的产品配置 Makefile，则此行必须放置在沿用任何这类 Makefile 的行之前。

Jit 选项 仅在 ART JIT 编译器可用的情况下，以下选项才会影响 Android 版本。

dalvik.vm.usejit：是否启用 JIT。

dalvik.vm.jitinitialsize（默认为 64K）：代码缓存初始容量。代码缓存将定期进行垃圾回收 (GC)，并将视需要增加容量。

dalvik.vm.jitmaxsize（默认为 64M）：代码缓存最大容量。

dalvik.vm.jitthreshold（默认为 10000）：方法的“热度”计数器必须超过该阈值，系统才会对方法进行 JIT 编译。“热度”计数器是运行时的内部指标。它的影响因素包括调用次数、后向分支及其他因素。

dalvik.vm.usejitprofiles：是否启用 JIT 配置文件；即使dalvik.vm.usejit 为 false，也可以使用该选项。请注意，如果该选项为 false，编译过滤器 speed-profile 将不会对任何方法进行 AOT 编译，效果与 quicken 相同。

dalvik.vm.jitprithreadweight（默认为 dalvik.vm.jitthreshold/20）：应用界面线程的 JIT“样本”（请参阅 jitthreshold）的权重。用于加快以下方法的编译速度：当用户与应用交互时，会直接影响用户体验的方法。

dalvik.vm.jittransitionweight（默认为 dalvik.vm.jitthreshold/10）：调用时需要在编译代码和解译器之间进行转换的方法的权重。这有助于确保对所涉及的方法进行编译以尽可能减少转换（转换需要很大开销）。 软件包管理器选项 从 Android 7.0 开始，系统提供了一种通用方式来指定各个阶段的编译/验证级别。编译级别通过系统属性来配置，默认值如下：

pm.dexopt.install=quicken 这是通过 Google Play 安装应用时使用的编译过滤器。如需加快安装速度，可以尝试使用 quicken 编译过滤器。

pm.dexopt.bg-dexopt=speed-profile 这是在设备闲置、充电以及充满电时使用的编译过滤器。若要充分利用配置文件引导型编译并节省存储空间，可以尝试使用 speed-profile 编译过滤器。

pm.dexopt.boot=verify 无线下载更新后使用的编译过滤器。对于此选项，我们强烈建议使用 verify 编译过滤器，以防启动时间过长。

pm.dexopt.first-boot=quicken 在设备初次启动时使用的编译过滤器。此时使用的过滤器只会影响出厂后的启动时间。我们建议使用 quicken 过滤器，以免用户在首次使用手机时需要花很长时间等待手机启动。请注意，如果 /system 中的所有应用都已使用 quicken 编译过滤器进行了编译，或者都已使用 speed 或 speed-profile 编译过滤器进行了编译，那么 pm.dexopt.first-boot 将不会产生任何影响。

Dex2oat 选项 请注意，这些选项在设备编译期间以及预先优化期间都会影响 dex2oat，但是前面讨论的大多数选项都只会影响预先优化。

在 dex2oat 编译启动映像时对其进行控制：

在 dex2oat 编译除启动映像之外的所有内容时对其进行控制：

Android 6.0 之前的版本提供了一个适用于编译除启动映像之外的所有内容的附加选项：

自 Android 6.1 起，该选项变成了两个适用于编译除启动映像之外的所有内容的附加选项：

Android 7.1 及之后的版本提供了两个选项来控制编译除启动映像之外的所有内容时的内存使用方式：

不应减小用于控制 dex2oat 初始堆大小和最大堆大小的选项数值，因为它们可能会限制可对哪些应用进行编译。

从 Android 11 开始，我们提供了 3 个 CPU 亲和性选项，通过这些选项，编译器线程可以限定在特定的一组 CPU 上：

指定 CPU 时，应采用以英文逗号分隔的 CPU ID 列表的形式。例如，如需在 CPU 0-3 上运行 dex2oat，请按如下所示进行设置：

设置 CPU 亲和性属性时，建议设定 dex2oat 线程数量的相应属性与选定的 CPU 的数量相匹配，以避免不必要的内存和 I/O 争用：

ROM 配置 从 Android 7.0 开始，设备可以使用两个 system 分区来实现 A/B 系统更新。为了减小 system 分区大小，可以将经过预先优化的文件安装在未使用的第二个 system 分区中。在系统首次启动时，这些文件会被复制到 data 分区。

使用示例（在 device-common.mk 中）：

在设备的 BoardConfig.mk 中：

请注意，启动类路径代码、系统服务器代码以及产品专属的核心应用始终会被编译到 system 分区中。默认情况下，所有其他应用都会被编译到未使用的第二个 system 分区中。可以使用 SYSTEM_OTHER_ODEX_FILTER 控制此行为，其值默认为：

后台 dexopt OTA 在启用了 A/B 的设备上，可以在后台对应用进行编译，以更新到新的系统映像。如需在系统映像中选择性地加入编译脚本和二进制文件，请参阅在后台编译应用。可通过以下选项控制用于此类编译的编译过滤器：

我们建议使用 speed-profile，以利用配置文件引导型编译并节省存储空间。

本文整理翻译自Google ART配置