Transform recursive make to non-recursive make

工作上有個 repo 使用 recursive make 來 build，剛接手時因為不熟悉，就先照著他的流程使用。使用的過程中發現他有個缺點，需要在每個單獨 build 的 makefile 中寫出所有需要的 include path。照 GNU make 的說明是有方法可以把參數傳進 sub makefile 中的，不過這邊沒有這樣用，這邊使用的方式是把建立 parent path 的 makefile include 進所有的 sub makefile，在依照各個 lib 的需要自己處理 header path。這樣的做法會在各 sub makefile 中發現很多重複的 header path 設定。感覺很阿雜。

最近終於有點時間，project 沒有這麼趕了，就打算把這個問題修一下，之前有考慮過就傳進去就好，但是因為也想要可以使用 -j 來加速，以及改進下 output 的目錄結構來減少一些 maintain multiple core debugger script 的工作，就想改成 non-recursive 的結構順便練一下功。

主要碰到的問題有幾個，

1. How to collect compile options in sub makefile?
2. How to collect sources/headers in sub-directories?
3. How to keep original build method? (build sub-dir as lib, then link them all)

在改的過程中有看到幾篇文章很有幫助，
[1] http://make.mad-scientist.net/papers/how-not-to-use-vpath/
[2] http://make.mad-scientist.net/papers/multi-architecture-builds/#single
[3] https://www.oreilly.com/library/view/managing-projects-with/0596006101/ch06.html#nonrecursive_make
[4] https://www.oreilly.com/library/view/managing-projects-with/0596006101/ch07.html#managing_programs_and_files

問題 1 & 2 的動作有兩個，一個是如何找到 makefile ，另一個是如何記住 makefile 中的資訊。

找檔案的手法有很多，這次是採用 wildcard 的方式，因為已經知道是在哪些目錄下了，這樣找也挺方便的。

	MKFILE := $(foreach d, $(SUBDIRS), $(wildcard $(D_ROOT)/$(d)/makefile)
	MKFILE += $(foreach d, $(SUBDIRS), $(wildcard $(D_ROOT)/drivers/$(d)/makefile)

view raw wildcard.mk hosted with ❤ by GitHub

再來就是如何記住，參考 [3] 的方法，這邊的重點是要記得先宣告參數，

	# in parent makefile
	ALL_SRC :=

view raw accu_var_parent.mk hosted with ❤ by GitHub

之後在 sub makefile 中就可以把 source 或者是 compile option 累加進 var 中，

ALL_SRC += $(LOCAL_SRC)

view raw accu_var_child.mk hosted with ❤ by GitHub

最後問題 3 的需求，主要的問題是如何跟 make 說有哪些 lib 要 build。這邊因為我是每個 sub makefile 都是一個 lib，所以就可以在每個 sub makefile 中加入下面的 rule，這樣每當 sub makefile 被 include 時，就會為每個 sub makefile 建立這個 rule 來 build 出我要的 lib。

	# OBJS are inside $(D_OBJ)
	$(LOCAL_LIB)： $(C_OBJS) $(A_OBJS)
	$(AR) $(ARFLAGS) $@ $(patsubst %,$(D_OBJ)/%, $^)

view raw sub-lib.mk hosted with ❤ by GitHub