Android原始碼編譯命令m/mm/mmm/make分析
在前文中,我們分析了Android編譯環境的初始化過程。android編譯環境初始化完成後,我們就可以用m/mm/mmm/make命令編譯原始碼了。當然,這要求每一個模組都有一個Android.mk檔案。Android.mk實際上是一個Makefile指令碼,用來描述模組編譯資訊。Android編譯系統通過整合Android.mk檔案完成編譯過程。本文就對Android原始碼的編譯過程進行詳細分析。
《Android系統原始碼情景分析》一書正在進擊的程式設計師網(http://0xcc0xcd.com)中連載,點選進入!
函式m的實現如下所示:
- function m()
- {
- T=$(gettop)
- if [ "$T" ]; then
- make -C $T [email protected]
- else
- echo "Couldn't locate the top of the tree. Try setting TOP."
- fi
- }
函式mm的實現如下所示:
- function mm()
- {
- # If we're sitting in the root of the build tree, just do a
- # normal make.
- if [ -f build/core/envsetup.mk -a -f Makefile ]; then
- make [email protected]
- else
- # Find the closest Android.mk file.
- T=$(gettop)
- local M=$(findmakefile)
- # Remove the path to top as the makefilepath needs to be relative
- local M=`echo $M|sed 's:'$T'/::'`
- if [ ! "$T" ]; then
- echo "Couldn't locate the top of the tree. Try setting TOP."
- elif [ ! "$M" ]; then
- echo "Couldn't locate a makefile from the current directory."
- else
- ONE_SHOT_MAKEFILE=$M make -C $T all_modules [email protected]
- fi
- fi
- }
由於接下來執行make命令時,我們需要指定的是要編譯的Android.mk檔案的相對於Android原始碼根目錄路徑,因此函式mm需要將剛才找到的Android.mk絕對檔案路徑M中與Android原始碼根目錄T相同的那部分路徑去掉。這是通過sed命令來實現的,也就是將字串M前面與字串T相同的子串刪掉。
最後,將找到的Android.mk檔案的相對路徑設定給環境變數ONE_SHOT_MAKE,表示接下來要對它進行編譯。另外,函式mm還將make命令目標設定為all_modules。這是什麼意思呢?我們知道,一個Android.mk檔案同時可以定義多個模組,因此,all_modules就表示要對前面指定的Android.mk檔案中定義的所有模組進行編譯。
函式mmm的實現如下所示:
- function mmm()
- {
- T=$(gettop)
- if [ "$T" ]; then
- local MAKEFILE=
- local MODULES=
- local ARGS=
- local DIR TO_CHOP
- local DASH_ARGS=$(echo "[email protected]" | awk -v RS=" " -v ORS=" " '/^-.*$/')
- local DIRS=$(echo "[email protected]" | awk -v RS=" " -v ORS=" " '/^[^-].*$/')
- for DIR in $DIRS ; do
-
MODULES=`echo $DIR | sed -n -e 's/.*:
.∗$ /\1/p' | sed 's/,/ /'` - if [ "$MODULES" = "" ]; then
- MODULES=all_modules
- fi
- DIR=`echo $DIR | sed -e 's/:.*//' -e 's:/$::'`
- if [ -f $DIR/Android.mk ]; then
- TO_CHOP=`(cd -P -- $T && pwd -P) | wc -c | tr -d ' '`
- TO_CHOP=`expr $TO_CHOP + 1`
- START=`PWD= /bin/pwd`
- MFILE=`echo $START | cut -c${TO_CHOP}-`
- if [ "$MFILE" = "" ] ; then
- MFILE=$DIR/Android.mk
- else
- MFILE=$MFILE/$DIR/Android.mk
- fi
- MAKEFILE="$MAKEFILE $MFILE"
- else
- if [ "$DIR" = snod ]; then
- ARGS="$ARGS snod"
- elif [ "$DIR" = showcommands ]; then
- ARGS="$ARGS showcommands"
- elif [ "$DIR" = dist ]; then
- ARGS="$ARGS dist"
- elif [ "$DIR" = incrementaljavac ]; then
- ARGS="$ARGS incrementaljavac"
- else
- echo "No Android.mk in $DIR."
- return 1
- fi
- fi
- done
- ONE_SHOT_MAKEFILE="$MAKEFILE" make -C $T $DASH_ARGS $MODULES $ARGS
- else
- echo "Couldn't locate the top of the tree. Try setting TOP."
- fi
- }
首先,命令mmm可以這樣執行:
- $ mmm <dir-1> <dir-2> ... <dir-N>[:module-1,module-2,...,module-M]
知道了命令mmm的使用方法之後 ,我們就可以分析函式mmm的執行邏輯了:
1. 呼叫函式gettop獲得Android原始碼根目錄。
2. 通過命令awk將執行命令mmm時指定的選項引數提取出來,也就是將以橫線“-”開頭的字串提取出來,並且儲存在變數DASH_ARGS中。
3. 通過命令awk將執行命令mmm時指定的非選項引數提取出來,也就是將非以橫線“-”開頭的字串提取出來,並且儲存在變數DIRS中。這裡得到的實際上就是跟在命令mmm後面的字串“<dir-1> <dir-2> ... <dir-N>[:module-1,module-2,...,module-M]”。
4. 變數DIRS儲存的字串可以看成是一系以空格分隔的子字串,因此,就可以通過一個for迴圈來對這些子字府串進行遍歷。每一個子字串DIR描述的都是一個包含有Android.mk檔案的目錄。對每一個目錄DIR執行以下操作:
4.1 由於目錄DIR後面可能會通過冒號指定有模組名稱,因此就先通過兩個sed命令來獲得這些模組名稱。第一個sed命令獲得的是一系列以逗號分隔的模組名稱列表,第二個sed命令用來將前面獲得的以逗號分隔的模組名稱列表轉化為以空格分隔的模組名稱列表。最後,獲得的以空格分隔的模組名稱列表儲存在變數MODULES中。由於目錄DIR後面也可能不指定有模組名稱,因此前面得到的變數MODULES的值就會為空。在這種情況下,需要將變數MODULES的值設定為“all_modules”,表示要編譯的是所有模組。
4.2 通過兩個sed命令獲得真正的目錄DIR。第一個sed命令將原來DIR字串後面的冒號以及冒號後面的模組列表字串刪掉。第二個sed命令將執行前面一個sed命令獲得的目錄後面的"/"斜線去掉,最後就得到一個末尾不帶有斜線“/”的路徑,並且儲存在變數DIR中。
4.3 如果變數DIR描述的是一個真正的路徑,也就是在該路徑下存在一個Android.mk檔案,那麼就進行以下處理:
4.3.1 統計Android原始碼根目錄T包含的字元數,並且將這個字元數加1,得到的值儲存在變數TO_CHOP中。
4.3.2 通過執行/bin/pwd命令獲得當前執行命令mmm的目錄START。
4.3.3 通過cut命令獲得當前目錄START相對於Android原始碼根目錄T的路徑,並且儲存在變數MFILE中。
4.3.4 如果變數MFILE的值等於空,就表明是在Android原始碼根目錄T中執行mmm命令,這時候就表明變數DIR描述的就是相對Android原始碼根目錄T的一個目錄,這時候指定的Android.mk檔案相對於Android原始碼根目錄T的路徑就為$DIR/Android.mk。
4.3.5 如果變數MFILE的值不等於空,就表明是在Android原始碼根目錄T的某一個子目錄中執行mmm命令,這時候$MFILE/$DIR/Android.mk表示的Android.mk檔案路徑才是相對於Android原始碼根目錄T的。
4.3.6 將獲得的Android.mk路徑MFILE附加在變數MAKEFILE描述的字串的後面,並且以空格分隔。
4.4 如果變數DIR描述的不是一個真正的路徑,並且它的值等於"snod"、"showcomands"、“dist”或者“incrementaljavac”,那麼它描述的其實是make修飾命令。這四個修飾命令的含義分別如下所示:
4.4.1 snod是“systemimage with no dependencies”的意思,表示忽略依賴性地重新打包system.img。
4.4.2 showcommands表示顯示編譯過程中執行的命令。
4.4.3 dist表示將編譯後產生的釋出檔案拷貝到out/dist目錄中。
4.4.4 incrementaljavac表示對Java原始檔採用增量式編譯,也就是如果一個Java檔案如果沒有修改過,那麼就不要重新生成對應的class檔案。
5. 上面的for迴圈執行完畢,變數MAKEFILE儲存的是要編譯的Android.mk檔案列表,它們都是相對於Android原始碼根目錄的路徑,變數DASH_ARGS儲存的是原來執行mmm命令時帶的選項引數,變數MODULES儲存的是指定要編譯的模組名稱,變數ARGS儲存的是修飾命令。其中,變數MAKEFILE的內容通過環境變數ONE_SHOT_MAKEFILE傳遞給make命令,而其餘變數都是通過引數的形式傳遞給make命令,並且變數MODULES作為make命令的目標。
明白了函式m、mm和mmm的實現之後,我們就可以知道:
1. mm和mmm命令是類似的,它們都是用來編譯某些模組。
2. m命令用來編譯所有模組。
如果我們理解了mm或者mmm命令的編譯過程,那麼自然也會明白m命令的編譯過程,因為所有模組的編譯過程就等於把每一個模組的編譯都編譯出來,因此,接下來我們就選擇具有代表性的、常用的編譯命令mmm來分析Android原始碼的編譯過程,如圖1所示:
圖1 mmm命令的編譯過程
函式mmm在Android原始碼根目錄執行make命令的時候,沒有通過-f指定Makefile檔案,因此預設就使用Android原始碼根目錄下的Makefile檔案,它的內容如下所示:
- ### DO NOT EDIT THIS FILE ###
- include build/core/main.mk
- ### DO NOT EDIT THIS FILE ###
它僅僅是將build/core/main.mk檔案載入進來。build/core/main.mk是Android編譯系統的入口檔案,它通過載入其它的mk檔案來對Android原始碼中的各個模組進行編譯,以及將編譯出來的檔案打包成各種映象檔案。以下就是build/core/main.mk檔案的主要內容:
- ......
- # This is the default target. It must be the first declared target.
- .PHONY: droid
- DEFAULT_GOAL := droid
- $(DEFAULT_GOAL):
- ......
- # Set up various standard variables based on configuration
- # and host information.
- include $(BUILD_SYSTEM)/config.mk
- ......
- # Bring in standard build system definitions.
- include $(BUILD_SYSTEM)/definitions.mk
- ......
- # These targets are going to delete stuff, don't bother including
- # the whole directory tree if that's all we're going to do
- ifeq ($(MAKECMDGOALS),clean)
- dont_bother := true
- endif
- ifeq ($(MAKECMDGOALS),clobber)
- dont_bother := true
- endif
- ifeq ($(MAKECMDGOALS),dataclean)
- dont_bother := true
- endif
- ifeq ($(MAKECMDGOALS),installclean)
- dont_bother := true
- endif
- # Bring in all modules that need to be built.