Building System之 get_abs_build_var() && get_build

点击打开链接

1、get_abs_build_var() 和 get_build_var()的实现都在build/envsetup.sh中。

2、在buld目录下grep这两个函数可知：这两个函数只在build/envsetup.sh脚本中使用。

言归正传，贴代码

[plain] view plain copy

# Get the value of a build variable as an absolute path.
function get_abs_build_var()
{
T=$(gettop)
if [ ! "$T" ]; then
echo "Couldn't locate the top of the tree. Try setting TOP." >&2
return
fi
(\cd $T; CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core \
command make --no-print-directory -f build/core/config.mk dumpvar-abs-$1)
}
# Get the exact value of a build variable.
function get_build_var()
{
T=$(gettop)
if [ ! "$T" ]; then
echo "Couldn't locate the top of the tree. Try setting TOP." >&2
return
fi
(\cd $T; CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core \
command make --no-print-directory -f build/core/config.mk dumpvar-$1)
}

这两个shell函数的实现很相似，都是通过make指定build/core/config.mk文件，唯一不同的地方是target目标不同。

接下来我们分析config.mk文件。

config.mk文件开头的注释：

[cpp] view plain copy

# This is included by the top-level Makefile.
# It sets up standard variables based on the
# current configuration and platform, which
# are not specific to what is being built.

根据注释，我们可知config.mk文件主要是配置变量。

而且，config.mk 文件最后一行包含的$(BUILD_SYSTEM)/dumpvar.mk用于获取一些变量。

接下来我们分析dumpvar.mk文件。

[plain] view plain copy

# ---------------------------------------------------------------
# the setpath shell function in envsetup.sh uses this to figure out
# what to add to the path given the config we have chosen.
ifeq ($(CALLED_FROM_SETUP),true) # 在get_abs_build_var() 和 get_build_var()函数中，CALLED_FROM_SETUP=true，走if分支。
ifneq ($(filter /%,$(HOST_OUT_EXECUTABLES)),)
# HOST_OUT_EXECUTABLES变量是在envsetup.mk文件中设置的。
ABP:=$(HOST_OUT_EXECUTABLES)
else
ABP:=$(PWD)/$(HOST_OUT_EXECUTABLES)
endif
ANDROID_BUILD_PATHS := $(ABP) # 应该是 out/host/linux-x86/bin
ANDROID_PREBUILTS := prebuilt/$(HOST_PREBUILT_TAG)
# HOST_PREBUILT_TAG变量是在envsetup.mk文件中设置的。应该是 linux-x86
ANDROID_GCC_PREBUILTS := prebuilts/gcc/$(HOST_PREBUILT_TAG)
# The "dumpvar" stuff lets you say something like
#
# CALLED_FROM_SETUP=true \
# make -f config/envsetup.make dumpvar-TARGET_OUT
# or
# CALLED_FROM_SETUP=true \
# make -f config/envsetup.make dumpvar-abs-HOST_OUT_EXECUTABLES
#
# The plain (non-abs) version just dumps the value of the named variable.
# The "abs" version will treat the variable as a path, and dumps an
# absolute path to it.
#
dumpvar_goals := \
$(strip $(patsubst dumpvar-%,%,$(filter dumpvar-%,$(MAKECMDGOALS))))
# MAKECMDGOALS 变量就是传进来的目标dumpvar-abs-$1或 dumpvar-$1。
ifdef dumpvar_goals
ifneq ($(words $(dumpvar_goals)),1)
$(error Only one "dumpvar-" goal allowed. Saw "$(MAKECMDGOALS)")
endif
# If the goal is of the form "dumpvar-abs-VARNAME", then
# treat VARNAME as a path and return the absolute path to it.
absolute_dumpvar := $(strip $(filter abs-%,$(dumpvar_goals)))
ifdef absolute_dumpvar
dumpvar_goals := $(patsubst abs-%,%,$(dumpvar_goals))
ifneq ($(filter /%,$($(dumpvar_goals))),)
DUMPVAR_VALUE := $($(dumpvar_goals))
else
DUMPVAR_VALUE := $(PWD)/$($(dumpvar_goals))
endif
dumpvar_target := dumpvar-abs-$(dumpvar_goals)
else
DUMPVAR_VALUE := $($(dumpvar_goals))
dumpvar_target := dumpvar-$(dumpvar_goals)
endif
.PHONY: $(dumpvar_target)
$(dumpvar_target):
@echo $(DUMPVAR_VALUE)
# DUMPVAR_VALE其实就是dumpvar-$1中的$1变量的值。
endif # dumpvar_goals
ifneq ($(dumpvar_goals),report_config)
# PRINT_BUILD_CONFIG 在envsetup.mk中被定义为true
PRINT_BUILD_CONFIG:=
endif
endif # CALLED_FROM_SETUP
ifneq ($(PRINT_BUILD_CONFIG),)
HOST_OS_EXTRA:=$(shell python -c "import platform; print(platform.platform())")
$(info ============================================)
$(info PLATFORM_VERSION_CODENAME=$(PLATFORM_VERSION_CODENAME))
$(info PLATFORM_VERSION=$(PLATFORM_VERSION))
$(info TARGET_PRODUCT=$(TARGET_PRODUCT))
$(info TARGET_BUILD_VARIANT=$(TARGET_BUILD_VARIANT))
$(info TARGET_BUILD_TYPE=$(TARGET_BUILD_TYPE))
$(info TARGET_BUILD_APPS=$(TARGET_BUILD_APPS))
$(info TARGET_ARCH=$(TARGET_ARCH))
$(info TARGET_ARCH_VARIANT=$(TARGET_ARCH_VARIANT))
$(info TARGET_CPU_VARIANT=$(TARGET_CPU_VARIANT))
$(info TARGET_2ND_ARCH=$(TARGET_2ND_ARCH))
$(info TARGET_2ND_ARCH_VARIANT=$(TARGET_2ND_ARCH_VARIANT))
$(info TARGET_2ND_CPU_VARIANT=$(TARGET_2ND_CPU_VARIANT))
$(info HOST_ARCH=$(HOST_ARCH))
$(info HOST_OS=$(HOST_OS))
$(info HOST_OS_EXTRA=$(HOST_OS_EXTRA))
$(info HOST_BUILD_TYPE=$(HOST_BUILD_TYPE))
$(info BUILD_ID=$(BUILD_ID))
$(info OUT_DIR=$(OUT_DIR))
$(info ============================================)
endif

小结：

大多数的变量配置都是在config.mk中设置的，尤其是其包含的envsetup.mk文件。所以，就在config.mk的最后包含dumpvar.mk文件，该文件执行@echo $(DUMPVAR_VALUE)输出$1变量值。

Examples:

1、get_abs_build_var ANDROID_GCC_PREBUILTS

[plain] view plain copy

#####################
# file：envsetup.mk #
#####################
34 # ---------------------------------------------------------------
35 # Set up configuration for host machine. We don't do cross-
36 # compiles except for arm/mips, so the HOST is whatever we are
37 # running on
38
39 UNAME := $(shell uname -sm)
40
41 # HOST_OS
42 ifneq (,$(findstring Linux,$(UNAME)))
43 <u><strong>HOST_OS</strong></u> := linux
44 endif
45 ifneq (,$(findstring Darwin,$(UNAME)))
46 HOST_OS := darwin
47 endif
48 ifneq (,$(findstring Macintosh,$(UNAME)))
49 HOST_OS := darwin
50 endif
51 ifneq (,$(findstring CYGWIN,$(UNAME)))
52 HOST_OS := windows
53 endif
108 # We don't want to move all the prebuilt host tools to a $(HOST_OS)-x86_64 dir.
109 HOST_PREBUILT_ARCH := x86
110 # This is the standard way to name a directory containing prebuilt host
111 # objects. E.g., prebuilt/$(HOST_PREBUILT_TAG)/cc
112 ifeq ($(HOST_OS),windows)
113 HOST_PREBUILT_TAG := windows
114 else
115 HOST_PREBUILT_TAG := $(HOST_OS)-$(HOST_PREBUILT_ARCH)
116 endif
##############
# dumpvar.mk #
##############
./dumpvar.mk:ANDROID_GCC_PREBUILTS := prebuilts/gcc/$(HOST_PREBUILT_TAG)

2、get_abs_build_var PRODUCT_OUT

[plain] view plain copy

#####################
# file：envsetup.mk #
#####################
192 # the target build type defaults to release
193 ifneq ($(TARGET_BUILD_TYPE),debug)
194 TARGET_BUILD_TYPE := release
195 endif
196
197 # ---------------------------------------------------------------
198 # figure out the output directories
199
200 ifeq (,$(strip $(OUT_DIR)))
201 ifeq (,$(strip $(OUT_DIR_COMMON_BASE)))
202 OUT_DIR := $(TOPDIR)out
203 else
204 OUT_DIR := $(OUT_DIR_COMMON_BASE)/$(notdir $(PWD))
205 endif
206 endif207
208 DEBUG_OUT_DIR := $(OUT_DIR)/debug
209
210 # Move the host or target under the debug/ directory
211 # if necessary.
212 TARGET_OUT_ROOT_release := $(OUT_DIR)/target
213 TARGET_OUT_ROOT_debug := $(DEBUG_OUT_DIR)/target
214 TARGET_OUT_ROOT := $(TARGET_OUT_ROOT_$(TARGET_BUILD_TYPE))
227 TARGET_PRODUCT_OUT_ROOT := $(TARGET_OUT_ROOT)/product
232 PRODUCT_OUT := $(TARGET_PRODUCT_OUT_ROOT)/$(TARGET_DEVICE)
#####################
# product_config.mk #
#####################
./product_config.mk:TARGET_DEVICE := $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEVICE)
# 该变量的分析将独立写一篇文章介绍。

3、get_abs_build_var HOST_OUT

[javascript] view plain copy

#####################
# file: envsetup.mk #
#####################
1 # Variables we check:
2 # HOST_BUILD_TYPE = { release debug }
3 # TARGET_BUILD_TYPE = { release debug }
4 # and we output a bunch of variables, see the case statement at
5 # the bottom for the full list
6 # OUT_DIR is also set to "out" if it's not already set.
7 # this allows you to set it to somewhere else if you like
97 # the host build defaults to release, and it must be release or debug
98 ifeq ($(HOST_BUILD_TYPE),)
99 HOST_BUILD_TYPE := release
100 endif
101
102 ifneq ($(HOST_BUILD_TYPE),release)
103 ifneq ($(HOST_BUILD_TYPE),debug)
104 $(error HOST_BUILD_TYPE must be either release or debug, not '$(HOST_BUILD_TYPE)')
105 endif
106 endif
216 HOST_OUT_ROOT_release := $(OUT_DIR)/host # OUT_DIR 见2的分析。
217 HOST_OUT_ROOT_debug := $(DEBUG_OUT_DIR)/host # DEBUG_OUT_DIR 见2的分析。
220 # We want to avoid two host bin directories in multilib build.
221 HOST_OUT_release := $(HOST_OUT_ROOT_release)/$(HOST_OS)-$(HOST_PREBUILT_ARCH)
# HOST_OS 见 1 的分析。
222 HOST_OUT_debug := $(HOST_OUT_ROOT_debug)/$(HOST_OS)-$(HOST_PREBUILT_ARCH)
# HOST_PREBUILT_ARCH 见 1 的分析。
223 HOST_OUT := $(HOST_OUT_$(HOST_BUILD_TYPE))

4、get_build_var TARGET_DEVICE

[plain] view plain copy

#####################
# product_config.mk #
#####################
./product_config.mk:TARGET_DEVICE := $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEVICE)
# 该变量的分析将独立写一篇文章介绍。

5、get_build_var TARGET_GCC_VERSION

[plain] view plain copy

TARGET_GCC_VERSION是在combo/TARGET_linux-$(TARGET_ARCH).mk文件中赋的值。
而TARGET_linux-$(TARGET_ARCH).mk文件是有config.mk -> combo/select.mk文件选择性包含进来的。

6、get_build_var 2ND_TARGET_GCC_VERSION

[plain] view plain copy

./core/envsetup.mk:254:HOST_2ND_ARCH_VAR_PREFIX := 2ND_
./core/envsetup.mk:297:TARGET_2ND_ARCH_VAR_PREFIX := $(HOST_2ND_ARCH_VAR_PREFIX)
./core/config.mk:156:include $(BUILD_SYSTEM)/envsetup.mk
./core/config.mk:230:combo_2nd_arch_prefix :=
./core/config.mk:236:combo_2nd_arch_prefix := $(HOST_2ND_ARCH_VAR_PREFIX)
./core/config.mk:244:combo_2nd_arch_prefix :=
./core/config.mk:250:combo_2nd_arch_prefix := $(TARGET_2ND_ARCH_VAR_PREFIX)
$(combo_2nd_arch_prefix)TARGET_GCC_VERSION的赋值是在combo/TARGET_linux-$(TARGET_ARCH).mk 文件中赋的值。

7、get_build_var TARGET_ARCH

[plain] view plain copy

TARGET_ARCH是在BoardConfig.mk文件中赋的值。
BoardConfig.mk文件是由config.mk -> envsetup.mk中的$(board_config_mk)变量包含进来的。

8、get_build_var ANDROID_BUILD_PATHS

[plain] view plain copy

./core/envsetup.mk:238:HOST_OUT_EXECUTABLES := $(HOST_OUT)/bin
# HOST_OUT 见 3 的分析。
##############
# dumpvar.mk #
##############
ifneq ($(filter /%,$(HOST_OUT_EXECUTABLES)),)
ABP:=$(HOST_OUT_EXECUTABLES)
else
ABP:=$(PWD)/$(HOST_OUT_EXECUTABLES)
endif
ANDROID_BUILD_PATHS := $(ABP)

9、get_build_var report_config

[plain] view plain copy

在dumpvar.mk中，目标是report_config的代码流程如下：
ifneq ($(dumpvar_goals),report_config)
PRINT_BUILD_CONFIG:=
endif
endif # CALLED_FROM_SETUP
ifneq ($(PRINT_BUILD_CONFIG),)
HOST_OS_EXTRA:=$(shell python -c "import platform; print(platform.platform())")
$(info ============================================)
$(info PLATFORM_VERSION_CODENAME=$(PLATFORM_VERSION_CODENAME))
# ./core/version_defaults.mk:62: PLATFORM_VERSION_CODENAME := REL
$(info PLATFORM_VERSION=$(PLATFORM_VERSION))
# ./core/version_defaults.mk:44: PLATFORM_VERSION := 5.1
$(info TARGET_PRODUCT=$(TARGET_PRODUCT))
# 是lunch时选择的<product_name>
# ./envsetup.sh: export TARGET_PRODUCT=$product
$(info TARGET_BUILD_VARIANT=$(TARGET_BUILD_VARIANT))
# 是lunch时选择的<product_variant>
# ./envsetup.sh: export TARGET_BUILD_VARIANT=$variant
$(info TARGET_BUILD_TYPE=$(TARGET_BUILD_TYPE))
# 是lunch时默认指定的，release
# ./envsetup.sh: export TARGET_BUILD_TYPE=release
$(info TARGET_BUILD_APPS=$(TARGET_BUILD_APPS))
# 是lunch时默认指定的，空值
# ./envsetup.sh: export TARGET_BUILD_APPS=
$(info TARGET_ARCH=$(TARGET_ARCH)) # TARGET_ARCH 见 7 的分析。
$(info TARGET_ARCH_VARIANT=$(TARGET_ARCH_VARIANT))
# 是在$(board_config_mk)即 BoardConfig.mk文件中赋的值。
$(info TARGET_CPU_VARIANT=$(TARGET_CPU_VARIANT))
# 是在$(board_config_mk)即 BoardConfig.mk文件中赋的值。
$(info TARGET_2ND_ARCH=$(TARGET_2ND_ARCH))
# 是在$(board_config_mk)即 BoardConfig.mk文件中赋的值。
$(info TARGET_2ND_ARCH_VARIANT=$(TARGET_2ND_ARCH_VARIANT))
# 是在$(board_config_mk)即 BoardConfig.mk文件中赋的值。
$(info TARGET_2ND_CPU_VARIANT=$(TARGET_2ND_CPU_VARIANT))
# 是在$(board_config_mk)即 BoardConfig.mk文件中赋的值。
$(info HOST_ARCH=$(HOST_ARCH))
# ./core/envsetup.mk:79: HOST_ARCH := x86_64
$(info HOST_OS=$(HOST_OS)) # HOST_OS 见 1 的分析。
$(info HOST_OS_EXTRA=$(HOST_OS_EXTRA)) # ifneq 的第一行。
$(info HOST_BUILD_TYPE=$(HOST_BUILD_TYPE)) # HOST_BUILD_TYPE 见 3 的分析。
$(info BUILD_ID=$(BUILD_ID))
# ./core/build_id.mk:21:export BUILD_ID=LMY47D
$(info OUT_DIR=$(OUT_DIR)) # OUT_DIR 见 2 的分析。
$(info ============================================)
endif

巴特西

Building System之 get_abs_build_var() && get_build_var()

最新文章

热门文章