细说dex2oat(1)
dex2oat的命令行参数
首先我们先看一下dex2oat都支持一些什么样的命令行参数：
通用类
- -j<线程数>：编译时使用多少个线程。缺省值为默认的CPU核数。例：-j8
输入输出的文件类
- --dex-file=:待编译的.dex, .jar或者.apk文件
- --dex-location=:dex文件的路径
- --zip-fd=:包含classes.dex文件的zip的文件描述符
- --zip-location=：zip文件路径
- --oat-file=<输出的oat文件名>：输出的oat文件名
- --oat-fd=<输出文件描述符>:输出文件描述符
- --oat-location=<输出的oat文件的路径>:输出的oat文件的路径
- --oat-symbols=:指定输出完整符号的oat路径
- --image=：指定输出的image文件名
- --image-classes=<预编译文件列表>:指定preloaded-classes的路径，例：--image=frameworks/base/preloaded-classes
- --base=：指定boot image的基地址，例：--base=0x50000000
- --boot-image=:指定boot class的文件。例：--boot-image=/system/framework/boot.art，默认值为：$ANDROID_ROOT/system/framework/boot.art
- --android-root=<路径>:portable linking所用的库的路径。例：--android-root=out/host/linux-x86，默认值：$ANDROID_ROOT
指令集类
- --instruction-set=(arm|arm64|mips|mips64|x86|x86_64):指定编译的指令集。例：--instruction-set=x86，默认：arm
- --instruction-set-features=<指令集参数>。例：--instruction-set-features=div，默认：default
编译器优化选项类
- --compile-pic:Force indirect use of code, methods, and classes. 默认：disabled
- --compiler-filter=(verify-none| interpret-only| space |balanced |speed |everything |time):选择compiler filter。例：--compiler-filter=everything。默认值：speed
- --huge-method-max=<方法指令数>:巨型方法的指令数，用于编译器调优。例：--huge-method-max=10000，默认值：10000
- --large-method-max=<方法指令数>：大型方法的指令数，用于编译器调优。例：--large-method-max=600，默认值：600
- --small-method-max=<方法指令数>:小型方法的指令数，用于编译器调优。例：--small-method-max=60，默认值：60
- --tiny-method-max=<方法指令数>:微型方法的指令数，用于编译器调优。例：--tiny-method-max=20，默认值：20
- --num-dex-methods=<方法数>:小型dex文件的方法上限，用于编译器调优。如果发现是个小型的dex文件，而编译器的filter不是interpret-only或者verify-none的话，就用speed filter。例:--num-dex-method=900，默认值：900
- --inline-depth-limit=<深度限制>:编译器调优用，只建议开发和实验用。例：--inline-depth-limit=5，默认值：5
- --inline-max-code-units=<方法数>：inline调优用，实验用。例：--inline-max-code-units=100,默认值：100
- --dump-timing: 显示时间都花到哪儿去了。
重定位信息类
- --include-patch-information:编译时包含patch信息，可以在不重编的情况下重定位。
- --no-include-patch-information:不包含patch信息。
调试信息类
- -g:与--generate-debug-info相同
- --generate-debug-info:生成所有可用的调试信息。可以通过标准的strip命令或者objcopy命令来压缩掉无用信息。
- --no-generate-debug-info:不生成调试信息
运行参数类
- --runtime-arg <参数>：指定运行时参数，如：初始堆大小，最大堆大小，详细输出等。每次只能传一个参数。例：--runtime-arg -Xms256m
- --profile-file=:指定profile信息，供编译器例用
编译选项类
- --print-pass-names: 打印pass name信息
- --disable-passes=:禁止某些pass项，例：--disable-passes=UseCount,BBOptimizations
- --print-pass-options:打印当前配置的pass信息
- --pass-options=Pass1Name:Pass1OptionName:Pass1Option#,Pass2Name:Pass2OptionName:Pass2Option#:指定pass信息。
临时文件类
- --swap-file=<交换文件名>:指定交换文件，例：--swap-file=/data/tmp/swap.001
- --swap-fd=<文件描述符>:指定交换文件的描述符
Makefile中指定的编译参数
上面我们学习了dex2oat的参数的简介，下面我们学以致用，看看在真实的环境中它们是如何被使用的。
运行时的Xms和Xmx参数
我们直接看build时，dex2oat的参数是如何被传进去的，在build/core/dex_preopt_libart.mk中：
91# For a single jar or APK
92
93# $(1): the input .jar or .apk file
94# $(2): the output .odex file
95define dex2oat-one-file
96$(hide) rm -f $(2)
97$(hide) mkdir -p $(dir $(2))
98$(hide) $(DEX2OAT) \
99 --runtime-arg -Xms$(DEX2OAT_XMS) --runtime-arg -Xmx$(DEX2OAT_XMX) \
首先指定两个运行时参数，这两个参数是在前面定义的：
44DEX2OAT_XMS := $(call get-product-default-property,dalvik.vm.dex2oat-Xms)
45DEX2OAT_XMX := $(call get-product-default-property,dalvik.vm.dex2oat-Xmx)
也就是说，这两个值取自属性dalvik.vm.dex2oat-Xms和vm.dex2oat-Xmx。这两个属性是哪里来的呢，是在/build/target/product/runtime_libart.mk中，编译的时候指定进来的：
48PRODUCT_DEFAULT_PROPERTY_OVERRIDES += \
49 dalvik.vm.image-dex2oat-Xms=64m \
50 dalvik.vm.image-dex2oat-Xmx=64m \
51 dalvik.vm.dex2oat-Xms=64m \
52 dalvik.vm.dex2oat-Xmx=512m \
53 ro.dalvik.vm.native.bridge=0 \
这样，这两个值分别是64m和512m。
boot-image
我们回到dex_preopt_libart.mk中继续看：
100 --boot-image=$(PRIVATE_DEX_PREOPT_IMAGE_LOCATION) \
查这个PRIVATE_DEX_PREOPT_IMAGE_LOCATION，定义于/build/core/setup_one_odex.mk中：
30$(my_built_odex): PRIVATE_DEX_PREOPT_IMAGE_LOCATION := $(my_dex_preopt_image_location)
然后再向上追my_dex_preopt_image_location
22ifdef LOCAL_DEX_PREOPT_IMAGE_LOCATION
23my_dex_preopt_image_location := $(LOCAL_DEX_PREOPT_IMAGE_LOCATION)
24else
25my_dex_preopt_image_location := $($(my_2nd_arch_prefix)DEFAULT_DEX_PREOPT_BUILT_IMAGE_LOCATION)
26endif
LOCAL_DEX_PREOPT_IMAGE_LOCATION没有定义，继续顺藤摸瓜。
23$(my_2nd_arch_prefix)DEFAULT_DEX_PREOPT_BUILT_IMAGE_LOCATION := $(DEXPREOPT_BOOT_JAR_DIR_FULL_PATH)/boot.art
再继续追DEXPREOPT_BOOT_JAR_DIR_FULL_PATH：
17DEXPREOPT_BOOT_JAR_DIR_FULL_PATH := $(DEXPREOPT_PRODUCT_DIR_FULL_PATH)/$(DEXPREOPT_BOOT_JAR_DIR)
先看后面的DEXPREOPT_BOOT_JAR_DIR，原来就是system/framework
16DEXPREOPT_BOOT_JAR_DIR := system/framework
再看前面的DEXPREOPT_PRODUCT_DIR_FULL_PATH，是out下的dex_bootjars
14DEXPREOPT_PRODUCT_DIR_FULL_PATH := $(PRODUCT_OUT)/dex_bootjars
最后--boot-image的值为out/dex_bootjars/system/framework/boot.art
dex文件和oat文件的路径
这个就不多说了
101 --dex-file=$(1) \
102 --dex-location=$(PRIVATE_DEX_LOCATION) \
103 --oat-file=$(2) \
104 --android-root=$(PRODUCT_OUT)/system \
指令集相关
105 --instruction-set=$($(PRIVATE_2ND_ARCH_VAR_PREFIX)DEX2OAT_TARGET_ARCH) \
追查：
604DEX2OAT_TARGET_ARCH := $(TARGET_ARCH)
这个板级驱动已经配好了。
106 --instruction-set-variant=$($(PRIVATE_2ND_ARCH_VAR_PREFIX)DEX2OAT_TARGET_CPU_VARIANT) \
107 --instruction-set-features=$($(PRIVATE_2ND_ARCH_VAR_PREFIX)DEX2OAT_TARGET_INSTRUCTION_SET_FEATURES) \
在同样的位置定义：
604DEX2OAT_TARGET_ARCH := $(TARGET_ARCH)
605ifeq ($(TARGET_CPU_VARIANT),)
606ifeq ($(TARGET_ARCH_VARIANT),)
607DEX2OAT_TARGET_CPU_VARIANT := default
608else
609DEX2OAT_TARGET_CPU_VARIANT := $(TARGET_ARCH_VARIANT)
610endif
611else
612DEX2OAT_TARGET_CPU_VARIANT := $(TARGET_CPU_VARIANT)
613endif
614DEX2OAT_TARGET_INSTRUCTION_SET_FEATURES := default
615
其他参数
108 --include-patch-information --runtime-arg -Xnorelocate --no-generate-debug-info \
109 --abort-on-hard-verifier-error \
110 $(PRIVATE_DEX_PREOPT_FLAGS)
111endef
include-patch-information兼runtime-arg -Xnorelocate，生成重定位的信息，因为后面还要走patchoat呢。
no-generate-debug-info，不生成调试信息
dex2oat的selinux权限配置
大家留神啊，现在已经是selinux的时代了，dex2oat也需要配置相关的权限：
# dex2oat
type dex2oat, domain;
type dex2oat_exec, exec_type, file_type;
allow dex2oat dalvikcache_data_file:file write;
# Read symlinks in /data/dalvik-cache
allow dex2oat dalvikcache_data_file:lnk_file read;
allow dex2oat installd:fd use;
# Read already open asec_apk_file file descriptors passed by installd.
# Also allow reading unlabeled files, to allow for upgrading forward
# locked APKs.
allow dex2oat asec_apk_file:file read;
allow dex2oat unlabeled:file read;
allow dex2oat oemfs:file read;
allow dex2oat apk_tmp_file:file read;
这还不算，在installd的权限配置/external/sepolicy/installd.te中，明确设置了
71# Run dex2oat in its own sandbox.
72domain_auto_trans(installd, dex2oat_exec, dex2oat)
时间： 2024-08-22 15:24:01