跟我一起寫 Makefile（六）

書寫指令

————

每條規則中的指令和作業系統Shell的指令行是一緻的。make會一按順序一條一條的執行指令，每條指令的開頭必須以[Tab]鍵開頭，除非，指令是緊跟在依賴規則後面的分号後的。在指令行之間中的空格或是空行會被忽略，但是如果該空格或空行是以Tab鍵開頭的，那麼make會認為其是一個空指令。

我們在UNIX下可能會使用不同的Shell，但是make的指令預設是被“/bin/sh”——UNIX的标準Shell解釋執行的。除非你特别指定一個其它的Shell。Makefile中，“#”是注釋符，很像C/C++中的“//”，其後的本行字元都被注釋。

一、顯示指令

通常，make會把其要執行的指令行在指令執行前輸出到螢幕上。當我們用“@”字元在指令行前，那麼，這個指令将不被make顯示出來，最具代表性的例子是，我們用這個功能來像螢幕顯示一些資訊。如：

    @echo 正在編譯XXX子產品......

當make執行時，會輸出“正在編譯XXX子產品......”字串，但不會輸出指令，如果沒有“@”，那麼，make将輸出：

    echo 正在編譯XXX子產品......

    正在編譯XXX子產品......

如果make執行時，帶入make參數“-n”或“--just-print”，那麼其隻是顯示指令，但不會執行指令，這個功能很有利于我們調試我們的Makefile，看看我們書寫的指令是執行起來是什麼樣子的或是什麼順序的。

而make參數“-s”或“--slient”則是全面禁止指令的顯示。

二、指令執行

當依賴目标新于目标時，也就是當規則的目标需要被更新時，make會一條一條的執行其後的指令。需要注意的是，如果你要讓上一條指令的結果應用在下一條指令時，你應該使用分号分隔這兩條指令。比如你的第一條指令是cd指令，你希望第二條指令得在cd之後的基礎上運作，那麼你就不能把這兩條指令寫在兩行上，而應該把這兩條指令寫在一行上，用分号分隔。如：

    示例一：

        exec:

                cd /home/hchen

                pwd

    示例二：

                cd /home/hchen; pwd

當我們執行“make exec”時，第一個例子中的cd沒有作用，pwd會列印出目前的Makefile目錄，而第二個例子中，cd就起作用了，pwd會列印出“/home/hchen”。

make一般是使用環境變量SHELL中所定義的系統Shell來執行指令，預設情況下使用UNIX的标準Shell——/bin/sh來執行指令。但在MS-DOS下有點特殊，因為MS-DOS下沒有SHELL環境變量，當然你也可以指定。如果你指定了UNIX風格的目錄形式，首先，make會在SHELL所指定的路徑中找尋指令解釋器，如果找不到，其會在目前盤符中的目前目錄中尋找，如果再找不到，其會在PATH環境變量中所定義的所有路徑中尋找。MS-DOS中，如果你定義的指令解釋器沒有找到，其會給你的指令解釋器加上諸如“.exe”、“.com”、“.bat”、“.sh”等字尾。

三、指令出錯

每當指令運作完後，make會檢測每個指令的傳回碼，如果指令傳回成功，那麼make會執行下一條指令，當規則中所有的指令成功傳回後，這個規則就算是成功完成了。如果一個規則中的某個指令出錯了（指令退出碼非零），那麼make就會終止執行目前規則，這将有可能終止所有規則的執行。

有些時候，指令的出錯并不表示就是錯誤的。例如mkdir指令，我們一定需要建立一個目錄，如果目錄不存在，那麼mkdir就成功執行，萬事大吉，如果目錄存在，那麼就出錯了。我們之是以使用mkdir的意思就是一定要有這樣的一個目錄，于是我們就不希望mkdir出錯而終止規則的運作。

為了做到這一點，忽略指令的出錯，我們可以在Makefile的指令行前加一個減号“-”（在Tab鍵之後），标記為不管指令出不出錯都認為是成功的。如：

   clean:

            -rm -f *.o

還有一個全局的辦法是，給make加上“-i”或是“--ignore-errors”參數，那麼，Makefile中所有指令都會忽略錯誤。而如果一個規則是以“.IGNORE”作為目标的，那麼這個規則中的所有指令将會忽略錯誤。這些是不同級别的防止指令出錯的方法，你可以根據你的不同喜歡設定。

還有一個要提一下的make的參數的是“-k”或是“--keep-going”，這個參數的意思是，如果某規則中的指令出錯了，那麼就終目該規則的執行，但繼續執行其它規則。

四、嵌套執行make

在一些大的工程中，我們會把我們不同子產品或是不同功能的源檔案放在不同的目錄中，我們可以在每個目錄中都書寫一個該目錄的Makefile，這有利于讓我們的Makefile變得更加地簡潔，而不至于把所有的東西全部寫在一個Makefile中，這樣會很難維護我們的Makefile，這個技術對于我們子產品編譯和分段編譯有着非常大的好處。

例如，我們有一個子目錄叫subdir，這個目錄下有個Makefile檔案，來指明了這個目錄下檔案的編譯規則。那麼我們總控的Makefile可以這樣書寫：

    subsystem:

            cd subdir && $(MAKE)

其等價于：

            $(MAKE) -C subdir

定義$(MAKE)宏變量的意思是，也許我們的make需要一些參數，是以定義成一個變量比較利于維護。這兩個例子的意思都是先進入“subdir”目錄，然後執行make指令。

我們把這個Makefile叫做“總控Makefile”，總控Makefile的變量可以傳遞到下級的Makefile中（如果你顯示的聲明），但是不會覆寫下層的Makefile中所定義的變量，除非指定了“-e”參數。

如果你要傳遞變量到下級Makefile中，那麼你可以使用這樣的聲明：

    export <variable ...>

如果你不想讓某些變量傳遞到下級Makefile中，那麼你可以這樣聲明：

    unexport <variable ...>

如：

        export variable = value

        其等價于：

        variable = value

        export variable

        export variable := value

        variable := value

        export variable += value

        variable += value

如果你要傳遞所有的變量，那麼，隻要一個export就行了。後面什麼也不用跟，表示傳遞所有的變量。

需要注意的是，有兩個變量，一個是SHELL，一個是MAKEFLAGS，這兩個變量不管你是否export，其總是要傳遞到下層Makefile中，特别是MAKEFILES變量，其中包含了make的參數資訊，如果我們執行“總控Makefile”時有make參數或是在上層Makefile中定義了這個變量，那麼MAKEFILES變量将會是這些參數，并會傳遞到下層Makefile中，這是一個系統級的環境變量。

但是make指令中的有幾個參數并不往下傳遞，它們是“-C”,“-f”,“-h”“-o”和“-W”（有關Makefile參數的細節将在後面說明），如果你不想往下層傳遞參數，那麼，你可以這樣來：

            cd subdir && $(MAKE) MAKEFLAGS=

如果你定義了環境變量MAKEFLAGS，那麼你得确信其中的選項是大家都會用到的，如果其中有“-t”,“-n”,和“-q”參數，那麼将會有讓你意想不到的結果，或許會讓你異常地恐慌。

還有一個在“嵌套執行”中比較有用的參數，“-w”或是“--print-directory”會在make的過程中輸出一些資訊，讓你看到目前的工作目錄。比如，如果我們的下級make目錄是“/home/hchen/gnu/make”，如果我們使用“make -w”來執行，那麼當進入該目錄時，我們會看到：

    make: Entering directory `/home/hchen/gnu/make'.

而在完成下層make後離開目錄時，我們會看到：

    make: Leaving directory `/home/hchen/gnu/make'

當你使用“-C”參數來指定make下層Makefile時，“-w”會被自動打開的。如果參數中有“-s”（“--slient”）或是“--no-print-directory”，那麼，“-w”總是失效的。

五、定義指令包

如果Makefile中出現一些相同指令序列，那麼我們可以為這些相同的指令序列定義一個變量。定義這種指令序列的文法以“define”開始，以“endef”結束，如：

    define run-yacc

    yacc $(firstword $^)

    mv y.tab.c $@

    endef

這裡，“run-yacc”是這個指令包的名字，其不要和Makefile中的變量重名。在“define”和“endef”中的兩行就是指令序列。這個指令包中的第一個指令是運作Yacc程式，因為Yacc程式總是生成“y.tab.c”的檔案，是以第二行的指令就是把這個檔案改改名字。還是把這個指令包放到一個示例中來看看吧。

    foo.c : foo.y

            $(run-yacc)

我們可以看見，要使用這個指令包，我們就好像使用變量一樣。在這個指令包的使用中，指令包“run-yacc”中的“$^”就是“foo.y”，“$@”就是“foo.c”（有關這種以“$”開頭的特殊變量，我們會在後面介紹），make在執行指令包時，指令包中的每個指令會被依次獨立執行。

本文轉自 haoel 51CTO部落格，原文連結：http://blog.51cto.com/haoel/124651，如需轉載請自行聯系原作者