android
Source
Edit
History

Android 构建系统 源码分析

版本 aosp-5.1.1_r6

build/envsetup.sh

作用:

  • 找 vendorsetup.sh (收集 lunch combo)
  • 设置编译 JAVA_HOME
  • 设置其他shell参数
    • TARGET_PRODUCT
    • 不包括 TARGET_DEVICE(在product_config.mk定义)
    • TARGET_BUILD_VARIANT
    • TARGET_BUILD_TYPE
    • TARGET_BUILD_APPS
  • 定义快捷命令
    • lunch
    • croot
    • m
    • mm
    • mmm
    • mma
    • mmma
    • mgrep
    • jgrep
    • sgrep
    • resgrep
    • godir
1
2
3
4
5
6
7
8
9
10
11
找device和vendor目录下的vendorsetup.sh 并 source
addcompletions() 找 sdk/bash_completion 下 [a-z]*.bash 并 source
  function gettop{} 返回aosp编译根目录
  
  function lunch{}
    TARGET_PRODUCT=$product
    TARGET_BUILD_VARIANT=$variant
    TARGET_BUILD_TYPE=release
    aosp_strawberry-userdebug 其中 product==aosp_strawberry, variant==userdebug

设置shell变量, 如 $ANDROID_BUILD_TOP

调用关系(按先后顺序)

1
2
3
4
5
6
7
8
9
10
11
12
AndroidProducts.mk
<- build/core/product_config.mk 通过 $(get-all-product-makefils) 查找device,vendor下AndroidProducts.mk, 导入 all_product_configs

BoardConfig.mk
<- build/core/envsetup.mk 通过查找 device,vendor 下 $(TARGET_DEVICE)/BoardConfig.mk 包含进来, 设置到 board_config_mk
  <- TARGET_DEVICE 在 envsetup.mk 定义 TARGET_DEVICE := $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEVICE)
  <- INTERNAL_PRODUCT 在 product_config.mk 定义 INTERNAL_PRODUCT := $(call resolve-short-product-name, $(TARGET_PRODUCT))
  <- PRODUCT_DEVICE 由不同的 device 位置下定义

AndroidBoard.mk
<- build/target/board/Android.mk -include $(TARGET_DEVICE_DIR)/AndroidBoard.mk
<- TARGET_DEVICE_DIR 在 build/core/envsetup.mk 定义 TARGET_DEVICE_DIR := $(patsubst %/,%,$(dir $(board_config_mk)))

包含关系

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
$ANDROID_BUILD_TOP/Makefile
-> build/core/main.mk 定义 TOPDIR 为空, BUILD_SYSTEM := $(TOPDIR)build/core
  -> $(BUILD_SYSTEM)/help.mk
  -> $(BUILD_SYSTEM)/config.mk( 定义 BUILD_XXX 对应的各个mk, 供以后include )
    -> $(BUILD_SYSTEM)/envsetup.mk ( 定义 PRODUCT_OUT )
      -> $(BUILD_SYSTEM)/product_config.mk
        -> $(BUILD_SYSTEM)/node_fns.mk
        -> $(BUILD_SYSTEM)/product.mk
        -> $(BUILD_SYSTEM)/device.mk
        -> $(TARGET_PRODUCT)(来自envsetup.sh) 的 AndroidProducts.mk {
          call product.mk:import-products
            -> node_fns.mk:import-nodes(间接定义 PRODUCTS==目标mk文件列表, 同时PRODUCTS本身也用作一个前缀)
            -> _import-nodes-inner -> import-node -> include
          定义 INTERNAL_PRODUCT== $(TARGET_PRODUCT)扩展出来的目标mk文件
          }
  -> $(BUILD_SYSTEM)/cleanbuild.mk
  -> $(BUILD_SYSTEM)/definitions.mk
  -> $(BUILD_SYSTEM)/dex_preopt.mk
  -> build/core/pdk_config.mk

recovery

  • build/core/Makefile
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
公共资源路径
recovery_resources_common := $(call include-path-for, recovery)/res
include-path-for 定义在 pathmap.mk 中 pathmap_INCL
默认 recovery_resources_common := $(recovery_resources_common)-xhdpi

私有资源路径
recovery_resources_private := $(strip $(wildcard $(TARGET_DEVICE_DIR)/recovery/res))

编译依赖
recovery_resource_deps := $(shell find $(recovery_resources_common) $(recovery_resources_private) -type f)

拷贝 recovery 资源
$(INSTALLED_RECOVERY_IMAGE_TARGET): $(recovery_binary)... 等
        cp -rf $(recovery_resources_common)/* $(TARGET_RECOVERY_ROOT_OUT)/res
        $(foreach item,$(recovery_resouces_private), cp -rf $(item) $(TARGET_RECOVERY_ROOT_OUT)/)

apicheck

1
apicheck.mk { .PHONY checkapi; droidcore: checkapi }

Add-on

1
2
3
4
5
6
7
8
9
10
11
主mk: device/sample/products/sample_addon.mk
<- device/sample/products/AndroidProducts.mk
<- build/core/product.mk
  function  _find-android-products-files
  查找 device, vendor, $(SRC_TARGET_DIR)/product 目录下所有 AndroidProducts.mk
  <- function get-all-product-makefiles
     返回排序好的所有 AndroidProducts.mk 定义的 PRODUCT_MAKEFILES
    <- build/core/product_config.mk
       all_product_configs 从中找到对应 product 的 makefile
       all_product_makefiles 集合所有product的makefile
       call import-products 导入product的makefile

例:

1
2
3
4
5
6
7
8
9
10
device/sample/products/AndroidProducts.mk
PRODUCT_MAKEFILES := $(LOCAL_DIR)/sample_addon.mk
PRODUCT_PACKAGES := PlatformLibraryClient \
	com.example.android.platform_library \
	libplatform_library_jni

依赖 com.example.android.platform_library 来自
device/sample/frameworks/PlatformLibrary/Android.mk
<- device/sample/frameworks/Android.mk 引入所有子目录mk
<- device/sample/Android.mk 引入所有子目录mk

使用到的主mk: build/core/tasks/sdk-addon.mk

  1. MODULES 由 fils_to_copy 拷贝到 dest
  2. COPY_FILES 由 files_to_copy 拷贝到 dest
  3. TARGET_CPU_API对应的img 拷贝到 $(addon_dir_img)
  4. 修改 TARGET_CPU_API对应的 source.properties, 拷贝到 $(addon_dir_img)
  5. doc_module 拷贝到 $(OUT_DOCS)
  6. sdk打包, image打包
1
function module-installed-files 查找某个module在out目录安装位置

Overlay

TODO

Jack

1
2
java-to-jack(definitions.mk)
<- LOCAL_IS_STATIC_JAVA_LIBRARY 构建static javalib 时候 $(full_classes_jack)的命令 (static_java_library.mk)