+
+In dumpvar mode, print the value of the legacy make variable VAR to stdout
+
+'report_config' is a special case that prints the human-readable config banner
+from the beginning of the build.
+```
+
+"--dumpvars-mode" 对应 soong_ui 的 dumpVars 函数
+
+```
+usage: soong_ui --dumpvars-mode [--vars=\"VAR VAR ...\
+In dumpvars mode, dump the values of one or more legacy make variables, in
+shell syntax. The resulting output may be sourced directly into a shell to
+set corresponding shell variables.
+
+'report_config' is a special case that dumps a variable containing the
+human-readable config banner from the beginning of the build.
+
+```
+
+这两个函数差不多，区别仅在于 dump 的 var 的个数多少。内部核心都是调用的 `build.DumpMakeVars()`, 具体的代码实现在 `./build/soong/ui/build/dumpvars.go`
+
+而 `build.DumpMakeVars()` 内部最终封装的 `build.dumpMakeVars()`, 注意对于 "--make-mode" 内部如果要 BuildProductConfig 也会调用 `build.dumpMakeVars()` 这个函数。
+
+`build.dumpMakeVars()` 这个函数就非常有趣了，看它的代码实际上是用命令行的方式去执行一个叫做 `build/make/core/config.mk` 的脚本。
+
+这个脚本是从 Android 原先的 make 系统里遗留下来的，从该文件的最前面注释上来看，原先的 Android 的 build 系统中，top-level Makefile 会包含这个 config.mk 文件，这个文件根据 platform 的不同以及一些 configration 的不同设置了一些 standard variables，这些变量 `are not specific to what is being built`。
+
+这个 config.mk 会 include 大量的其他 mk 文件，这些文件存放在 BUILD_SYSTEM（`./build/make/common`) 和 BUILD_SYSTEM（`./build/make/core`） 下
+
+注意在这个 config.mk 的最后 include 了这么两个文件
+```
+ifeq ($(CALLED_FROM_SETUP),true)
+include $(BUILD_SYSTEM)/ninja_config.mk
+include $(BUILD_SYSTEM)/soong_config.mk
+endif
+```
+
+其中 `soong_config.mk` 里将大量 Soong 需要的，但原先定义在 mk 文件中的变量打印输出到 `out/soong/soong.variables` 这个文件中，这是一个 json 格式的文件，这也是我们所谓的 dump Make Vars 的含义。dump 出来后我们就可以随时使用了。生成的 jason 语法格式为：
+
+```
+$(call add_json_str, BuildId, $(BUILD_ID))
+$(call add_json_val, Platform_sdk_version, $(PLATFORM_SDK_VERSION))
+$(call add_json_csv, Platform_version_active_codenames, $(PLATFORM_VERSION_ALL_CODENAMES))
+$(call add_json_bool, Allow_missing_dependencies, $(ALLOW_MISSING_DEPENDENCIES))
+$(call add_json_list, ProductResourceOverlays, $(PRODUCT_PACKAGE_OVERLAYS))
+```
+
+对应打印生成的例子为：
+```
+"BuildId": "QP1A.191105.004",
+"Platform_sdk_version": 29,
+"Platform_version_active_codenames": ["REL"],
+"Allow_missing_dependencies": false,
+"ProductResourceOverlays": ["device/generic/goldfish/overlay"],
+```
+
+这个地方对于理解 Android 中从 make 到 Soong 的转换非常重要，看上去 Android 的思路还是先保留了原先 Make 的一套核心的 setup 逻辑，然后导出为 soong variables 供新的 Soong 使用，完成了转换。
+
+### 2.2.2. `soong_ui` 的 "--make-mode" 参数
+
+现在来看 `build.Build()` 这个核心函数, 源码在 `./soong/ui/build/build.go`, 略去所有辅助的步骤，只保留核心的步骤
+
+
+func Build(ctx Context, config Config, what int) {
+ ......
+
+ // what 传入的是 BuildAll = BuildProductConfig | BuildSoong | BuildKati | BuildNinja
+ // runMakeProductConfig 这个函数定义在 `./soong/ui/build/dumpvars.go`
+ // 对 config 设置环境变量，为下面 runKati/runNinja 做准备
+ // 具体的 runMakeProductConfig() 逻辑看上一节有关 dumpMakeVars 的分析
+ if what&BuildProductConfig != 0 {
+ // Run make for product config
+ runMakeProductConfig(ctx, config)
+ }
+
+ ......
+
+ // runSoong() 这个函数定义在 `./soong/ui/build/soong.go` 中,
+ // 是 Soong 系统的重点函数！！！
+ if what&BuildSoong != 0 {
+ // Run Soong
+ runSoong(ctx, config)
+ }
+ if what&BuildKati != 0 {
+ // Run ckati
+ // ......
+ }
+ // Write combined ninja file
+ createCombinedBuildNinjaFile(ctx, config)
+ if what&RunBuildTests != 0 {
+ testForDanglingRules(ctx, config)
+ }
+ if what&BuildNinja != 0 {
+ if !config.SkipMake() {
+ installCleanIfNecessary(ctx, config)
+ }
+ // Run ninja
+ runNinja(ctx, config)
+ }
+}
+
+
+对 Build 这个核心函数的分析来看，其实最重要的是 `runSoong()`, 这个函数最终生成了 `./out/soong/build.ninja`, `runNinja()` 啥的都是以这个最终的 ninja 文件作为输入，在这个基础上执行编译构建的工作。
+
+## 2.3. `build.runSoong()`
+
+参考 `./soong/ui/build/soong.go`
+
+这个函数中的每一步，都要搞清楚，否则没法彻底搞清楚基于 Soong 的 Android 构建过程。
+
+
+
+func runSoong(ctx Context, config Config) {
+ ctx.BeginTrace(metrics.RunSoong, "soong")
+ defer ctx.EndTrace()
+
+ // 本质上就是执行 `build/blueprint/bootstrap.bash -t` 这个脚本， “-t“ 表示执行测试
+ // BOOTSTRAP/BLUEPRINTDIR，我们获得了 blueprint 的源码位置
+ // BUILDDIR 确定了生成输出的二进制程序的位置在 out/soong 目录下
+ // NINJA_BUILDDIR 存放的是生成 .ninja_log/.ninja_deps 的位置
+ // GOROOT 指向 go 编译器的位置
+ // 查看 `build/blueprint/bootstrap.bash` 其主要工作流程：
+ // - 创建目录 $BUILDDIR/.minibootstrap，
+ // - 在上面创建的目录下创建一系列文件，最主要的包括
+ // - $BUILDDIR/.minibootstrap/build.ninja：这个文件的内容很关键，
+ // 是生成下一个阶段 bootstrap 的 目标的 ninja build 文件
+ // - $BUILDDIR/.minibootstrap/build-globs.ninja: 内容为空
+ // - $BUILDDIR/.blueprint.bootstrap:
+ // - ${BUILDDIR}/.out-dir
+ // - 拷贝了一个 $WRAPPER 到 $BUILDDIR 下, 具体的这个变量为空，所以没有什么动作
+ func() {
+ ctx.BeginTrace(metrics.RunSoong, "blueprint bootstrap")
+ defer ctx.EndTrace()
+ cmd := Command(ctx, config, "blueprint bootstrap", "build/blueprint/bootstrap.bash", "-t")
+ cmd.Environment.Set("BLUEPRINTDIR", "./build/blueprint")
+ cmd.Environment.Set("BOOTSTRAP", "./build/blueprint/bootstrap.bash")
+ cmd.Environment.Set("BUILDDIR", config.SoongOutDir())
+ cmd.Environment.Set("GOROOT", "./"+filepath.Join("prebuilts/go", config.HostPrebuiltTag()))
+ cmd.Environment.Set("BLUEPRINT_LIST_FILE", filepath.Join(config.FileListDir(), "Android.bp list"))
+ cmd.Environment.Set("NINJA_BUILDDIR", config.OutDir())
+ cmd.Environment.Set("SRCDIR", ".")
+ cmd.Environment.Set("TOPNAME", "Android.bp")
+ cmd.Sandbox = soongSandbox
+ cmd.RunAndPrintOrFatal()
+ }()
+
+ // 环境检查， 运行了一个 soong_env 的 程序, 实际测试好像也没有生成，也没有运行
+ func() {
+ ctx.BeginTrace(metrics.RunSoong, "environment check")
+ defer ctx.EndTrace()
+ envFile := filepath.Join(config.SoongOutDir(), ".soong.environment")
+ envTool := filepath.Join(config.SoongOutDir(), ".bootstrap/bin/soong_env")
+ if _, err := os.Stat(envFile); err == nil {
+ if _, err := os.Stat(envTool); err == nil {
+ cmd := Command(ctx, config, "soong_env", envTool, envFile)
+ cmd.Sandbox = soongSandbox
+ var buf strings.Builder
+ cmd.Stdout = &buf
+ cmd.Stderr = &buf
+ if err := cmd.Run(); err != nil {
+ ctx.Verboseln("soong_env failed, forcing manifest regeneration")
+ os.Remove(envFile)
+ }
+ if buf.Len() > 0 {
+ ctx.Verboseln(buf.String())
+ }
+ } else {
+ ctx.Verboseln("Missing soong_env tool, forcing manifest regeneration")
+ os.Remove(envFile)
+ }
+ } else if !os.IsNotExist(err) {
+ ctx.Fatalf("Failed to stat %f: %v", envFile, err)
+ }
+ }()
+
+ var cfg microfactory.Config
+ cfg.Map("github.com/google/blueprint", "build/blueprint")
+
+ cfg.TrimPath = absPath(ctx, ".")
+
+ // 利用 blueprint 的 microfactory 创建 minibp 这个可执行程序
+ // minibp 的源码在 `build/blueprint/bootstrap/minibp`
+ func() {
+ ctx.BeginTrace(metrics.RunSoong, "minibp")
+ defer ctx.EndTrace()
+ minibp := filepath.Join(config.SoongOutDir(), ".minibootstrap/minibp")
+ if _, err := microfactory.Build(&cfg, minibp, "github.com/google/blueprint/bootstrap/minibp") err != nil {
+ ctx.Fatalln("Failed to build minibp:", err)
+ }
+ }()
+
+ // 利用 blueprint 的 microfactory 创建 bpglob 这个可执行程序
+ // bpglob 的源码在 `build/blueprint/bootstrap/bpglob`
+ func() {
+ ctx.BeginTrace(metrics.RunSoong, "bpglob")
+ defer ctx.EndTrace()
+ bpglob := filepath.Join(config.SoongOutDir(), ".minibootstrap/bpglob")
+ if _, err := microfactory.Build(&cfg, bpglob, "github.com/google/blueprint/bootstrap/ pglob") err != nil {
+ ctx.Fatalln("Failed to build bpglob:", err)
+ }
+ }()
+
+ // 这里是定义一个匿名函数 ninja
+ ninja := func(name, file string) {
+ ctx.BeginTrace(metrics.RunSoong, name)
+ defer ctx.EndTrace()
+ fifo := filepath.Join(config.OutDir(), ".ninja_fifo")
+ nr := status.NewNinjaReader(ctx, ctx.Status.StartTool(), fifo)
+ defer nr.Close()
+ cmd := Command(ctx, config, "soong "+name,
+ config.PrebuiltBuildTool("ninja"),
+ "-d", "keepdepfile",
+ "-w", "dupbuild=err",
+ "-j", strconv.Itoa(config.Parallel()),
+ "--frontend_file", fifo,
+ "-f", filepath.Join(config.SoongOutDir(), file))
+ cmd.Sandbox = soongSandbox
+ cmd.RunAndPrintOrFatal()
+ }
+
+ // 利用 ninja，输入 `.minibootstrap/build.ninja`, 输出 `out/soong/.bootstrap/build.ninja`
+ // 至此可以认为 minibootstrap 阶段结束
+ ninja("minibootstrap", ".minibootstrap/build.ninja")
+
+ // 利用 ninja，输入 `out/soong/.bootstrap/build.ninja`， 输出 `out/soong/build.ninja`
+ ninja("bootstrap", ".bootstrap/build.ninja")
+}
+
+