Makefile 书写命令
生活随笔
收集整理的這篇文章主要介紹了
Makefile 书写命令
小編覺得挺不錯的,現(xiàn)在分享給大家,幫大家做個參考.
每條規(guī)則中的命令和操作系統(tǒng)Shell的命令行是一致的。make會一按順序一條一條的執(zhí)行命令，每條命令的開頭必須以[Tab]鍵開頭，除非，命令是緊跟在依賴規(guī)則后面的分號后的。在命令行之間中的空格或是空行會被忽略，但是如果該空格或空行是以Tab鍵開頭的，那么make會認(rèn)為其是一個空命令。
我們在UNIX下可能會使用不同的Shell，但是make的命令默認(rèn)是被“/bin/sh”——UNIX的標(biāo)準(zhǔn)Shell解釋執(zhí)行的。除非你特別指定一個其它的Shell。Makefile中，“#”是注釋符，很像C/C++中的“//”，其后的本行字符都被注釋。
一、顯示命令
通常，make會把其要執(zhí)行的命令行在命令執(zhí)行前輸出到屏幕上。當(dāng)我們用“@”字符在命令行前，那么，這個命令將不被make顯示出來，最具代表性的例子是，我們用這個功能來像屏幕顯示一些信息。如：
????@echo?正在編譯XXX模塊......
當(dāng)make執(zhí)行時，會輸出“正在編譯XXX模塊......”字串，但不會輸出命令，如果沒有“@”，那么，make將輸出：
????echo?正在編譯XXX模塊......
????正在編譯XXX模塊......
如果make執(zhí)行時，帶入make參數(shù)“-n”或“--just-print”，那么其只是顯示命令，但不會執(zhí)行命令，這個功能很有利于我們調(diào)試我們的Makefile，看看我們書寫的命令是執(zhí)行起來是什么樣子的或是什么順序的。
而make參數(shù)“-s”或“--slient”則是全面禁止命令的顯示。
?
二、命令執(zhí)行
當(dāng)依賴目標(biāo)新于目標(biāo)時，也就是當(dāng)規(guī)則的目標(biāo)需要被更新時，make會一條一條的執(zhí)行其后的命令。需要注意的是，如果你要讓上一條命令的結(jié)果應(yīng)用在下一條命令時，你應(yīng)該使用分號分隔這兩條命令。比如你的第一條命令是cd命令，你希望第二條命令得在cd之后的基礎(chǔ)上運(yùn)行，那么你就不能把這兩條命令寫在兩行上，而應(yīng)該把這兩條命令寫在一行上，用分號分隔。如：
????示例一：
????????exec:
????????????????cd?/home/hchen
????????????????pwd
????示例二：
????????exec:
????????????????cd?/home/hchen;?pwd
當(dāng)我們執(zhí)行“make?exec”時，第一個例子中的cd沒有作用，pwd會打印出當(dāng)前的Makefile目錄，而第二個例子中，cd就起作用了，pwd會打印出“/home/hchen”。
make一般是使用環(huán)境變量SHELL中所定義的系統(tǒng)Shell來執(zhí)行命令，默認(rèn)情況下使用UNIX的標(biāo)準(zhǔn)Shell——/bin/sh來執(zhí)行命令。但在MS-DOS下有點(diǎn)特殊，因?yàn)?/span>MS-DOS下沒有SHELL環(huán)境變量，當(dāng)然你也可以指定。如果你指定了UNIX風(fēng)格的目錄形式，首先，make會在SHELL所指定的路徑中找尋命令解釋器，如果找不到，其會在當(dāng)前盤符中的當(dāng)前目錄中尋找，如果再找不到，其會在PATH環(huán)境變量中所定義的所有路徑中尋找。MS-DOS中，如果你定義的命令解釋器沒有找到，其會給你的命令解釋器加上諸如“.exe”、“.com”、“.bat”、“.sh”等后綴。
三、命令出錯
每當(dāng)命令運(yùn)行完后，make會檢測每個命令的返回碼，如果命令返回成功，那么make會執(zhí)行下一條命令，當(dāng)規(guī)則中所有的命令成功返回后，這個規(guī)則就算是成功完成了。如果一個規(guī)則中的某個命令出錯了（命令退出碼非零），那么make就會終止執(zhí)行當(dāng)前規(guī)則，這將有可能終止所有規(guī)則的執(zhí)行。
有些時候，命令的出錯并不表示就是錯誤的。例如mkdir命令，我們一定需要建立一個目錄，如果目錄不存在，那么mkdir就成功執(zhí)行，萬事大吉，如果目錄存在，那么就出錯了。我們之所以使用mkdir的意思就是一定要有這樣的一個目錄，于是我們就不希望mkdir出錯而終止規(guī)則的運(yùn)行。
為了做到這一點(diǎn)，忽略命令的出錯，我們可以在Makefile的命令行前加一個減號“-”（在Tab鍵之后），標(biāo)記為不管命令出不出錯都認(rèn)為是成功的。如：
???clean:
????????????-rm?-f?*.o
還有一個全局的辦法是，給make加上“-i”或是“--ignore-errors”參數(shù)，那么，Makefile中所有命令都會忽略錯誤。而如果一個規(guī)則是以“.IGNORE”作為目標(biāo)的，那么這個規(guī)則中的所有命令將會忽略錯誤。這些是不同級別的防止命令出錯的方法，你可以根據(jù)你的不同喜歡設(shè)置。
還有一個要提一下的make的參數(shù)的是“-k”或是“--keep-going”，這個參數(shù)的意思是，如果某規(guī)則中的命令出錯了，那么就終目該規(guī)則的執(zhí)行，但繼續(xù)執(zhí)行其它規(guī)則。
四、嵌套執(zhí)行make
在一些大的工程中，我們會把我們不同模塊或是不同功能的源文件放在不同的目錄中，我們可以在每個目錄中都書寫一個該目錄的Makefile，這有利于讓我們的Makefile變得更加地簡潔，而不至于把所有的東西全部寫在一個Makefile中，這樣會很難維護(hù)我們的Makefile，這個技術(shù)對于我們模塊編譯和分段編譯有著非常大的好處。
例如，我們有一個子目錄叫subdir，這個目錄下有個Makefile文件，來指明了這個目錄下文件的編譯規(guī)則。那么我們總控的Makefile可以這樣書寫：
????subsystem:
????????????cd?subdir?&&?$(MAKE)
其等價于：
????subsystem:
????????????$(MAKE)?-C?subdir
定義$(MAKE)宏變量的意思是，也許我們的make需要一些參數(shù)，所以定義成一個變量比較利于維護(hù)。這兩個例子的意思都是先進(jìn)入“subdir”目錄，然后執(zhí)行make命令。
我們把這個Makefile叫做“總控Makefile”，總控Makefile的變量可以傳遞到下級的Makefile中（如果你顯示的聲明），但是不會覆蓋下層的Makefile中所定義的變量，除非指定了“-e”參數(shù)。
如果你要傳遞變量到下級Makefile中，那么你可以使用這樣的聲明：
????export?<variable?...>;
如果你不想讓某些變量傳遞到下級Makefile中，那么你可以這樣聲明：?
????unexport?<variable?...>;
如：
????
????示例一：
????????export?variable?=?value
????????其等價于：
????????variable?=?value
????????export?variable
????????其等價于：
????????export?variable?:=?value
????????其等價于：
????????variable?:=?value
????????export?variable
????示例二：
????????export?variable?+=?value
????????其等價于：
????????variable?+=?value
????????export?variable
如果你要傳遞所有的變量，那么，只要一個export就行了。后面什么也不用跟，表示傳遞所有的變量。
需要注意的是，有兩個變量，一個是SHELL，一個是MAKEFLAGS，這兩個變量不管你是否export，其總是要傳遞到下層Makefile中，特別是MAKEFILES變量，其中包含了make的參數(shù)信息，如果我們執(zhí)行“總控Makefile”時有make參數(shù)或是在上層Makefile中定義了這個變量，那么MAKEFILES變量將會是這些參數(shù)，并會傳遞到下層Makefile中，這是一個系統(tǒng)級的環(huán)境變量。
但是make命令中的有幾個參數(shù)并不往下傳遞，它們是“-C”,“-f”,“-h”“-o”和“-W”（有關(guān)Makefile參數(shù)的細(xì)節(jié)將在后面說明），如果你不想往下層傳遞參數(shù)，那么，你可以這樣來：
????subsystem:
????????????cd?subdir?&&?$(MAKE)?MAKEFLAGS=
如果你定義了環(huán)境變量MAKEFLAGS，那么你得確信其中的選項(xiàng)是大家都會用到的，如果其中有“-t”,“-n”,和“-q”參數(shù)，那么將會有讓你意想不到的結(jié)果，或許會讓你異常地恐慌。
還有一個在“嵌套執(zhí)行”中比較有用的參數(shù)，“-w”或是“--print-directory”會在make的過程中輸出一些信息，讓你看到目前的工作目錄。比如，如果我們的下級make目錄是“/home/hchen/gnu/make”，如果我們使用“make?-w”來執(zhí)行，那么當(dāng)進(jìn)入該目錄時，我們會看到：
????make:?Entering?directory?`/home/hchen/gnu/make'.
而在完成下層make后離開目錄時，我們會看到：
????make:?Leaving?directory?`/home/hchen/gnu/make'
當(dāng)你使用“-C”參數(shù)來指定make下層Makefile時，“-w”會被自動打開的。如果參數(shù)中有“-s”（“--slient”）或是“--no-print-directory”，那么，“-w”總是失效的。
五、定義命令包
如果Makefile中出現(xiàn)一些相同命令序列，那么我們可以為這些相同的命令序列定義一個變量。定義這種命令序列的語法以“define”開始，以“endef”結(jié)束，如：
????define?run-yacc
????yacc?$(firstword?$^)
????mv?y.tab.c?$@
????endef
這里，“run-yacc”是這個命令包的名字，其不要和Makefile中的變量重名。在“define”和“endef”中的兩行就是命令序列。這個命令包中的第一個命令是運(yùn)行Yacc程序，因?yàn)?/span>Yacc程序總是生成“y.tab.c”的文件，所以第二行的命令就是把這個文件改改名字。還是把這個命令包放到一個示例中來看看吧。
????foo.c?:?foo.y
????????????$(run-yacc)
我們可以看見，要使用這個命令包，我們就好像使用變量一樣。在這個命令包的使用中，命令包“run-yacc”中的“$^”就是“foo.y”，“$@”就是“foo.c”（有關(guān)這種以“$”開頭的特殊變量，我們會在后面介紹），make在執(zhí)行命令包時，命令包中的每個命令會被依次獨(dú)立執(zhí)行。
我們在UNIX下可能會使用不同的Shell，但是make的命令默認(rèn)是被“/bin/sh”——UNIX的標(biāo)準(zhǔn)Shell解釋執(zhí)行的。除非你特別指定一個其它的Shell。Makefile中，“#”是注釋符，很像C/C++中的“//”，其后的本行字符都被注釋。
一、顯示命令
通常，make會把其要執(zhí)行的命令行在命令執(zhí)行前輸出到屏幕上。當(dāng)我們用“@”字符在命令行前，那么，這個命令將不被make顯示出來，最具代表性的例子是，我們用這個功能來像屏幕顯示一些信息。如：
????@echo?正在編譯XXX模塊......
當(dāng)make執(zhí)行時，會輸出“正在編譯XXX模塊......”字串，但不會輸出命令，如果沒有“@”，那么，make將輸出：
????echo?正在編譯XXX模塊......
????正在編譯XXX模塊......
如果make執(zhí)行時，帶入make參數(shù)“-n”或“--just-print”，那么其只是顯示命令，但不會執(zhí)行命令，這個功能很有利于我們調(diào)試我們的Makefile，看看我們書寫的命令是執(zhí)行起來是什么樣子的或是什么順序的。
而make參數(shù)“-s”或“--slient”則是全面禁止命令的顯示。
?
二、命令執(zhí)行
當(dāng)依賴目標(biāo)新于目標(biāo)時，也就是當(dāng)規(guī)則的目標(biāo)需要被更新時，make會一條一條的執(zhí)行其后的命令。需要注意的是，如果你要讓上一條命令的結(jié)果應(yīng)用在下一條命令時，你應(yīng)該使用分號分隔這兩條命令。比如你的第一條命令是cd命令，你希望第二條命令得在cd之后的基礎(chǔ)上運(yùn)行，那么你就不能把這兩條命令寫在兩行上，而應(yīng)該把這兩條命令寫在一行上，用分號分隔。如：
????示例一：
????????exec:
????????????????cd?/home/hchen
????????????????pwd
????示例二：
????????exec:
????????????????cd?/home/hchen;?pwd
當(dāng)我們執(zhí)行“make?exec”時，第一個例子中的cd沒有作用，pwd會打印出當(dāng)前的Makefile目錄，而第二個例子中，cd就起作用了，pwd會打印出“/home/hchen”。
make一般是使用環(huán)境變量SHELL中所定義的系統(tǒng)Shell來執(zhí)行命令，默認(rèn)情況下使用UNIX的標(biāo)準(zhǔn)Shell——/bin/sh來執(zhí)行命令。但在MS-DOS下有點(diǎn)特殊，因?yàn)?/span>MS-DOS下沒有SHELL環(huán)境變量，當(dāng)然你也可以指定。如果你指定了UNIX風(fēng)格的目錄形式，首先，make會在SHELL所指定的路徑中找尋命令解釋器，如果找不到，其會在當(dāng)前盤符中的當(dāng)前目錄中尋找，如果再找不到，其會在PATH環(huán)境變量中所定義的所有路徑中尋找。MS-DOS中，如果你定義的命令解釋器沒有找到，其會給你的命令解釋器加上諸如“.exe”、“.com”、“.bat”、“.sh”等后綴。
三、命令出錯
每當(dāng)命令運(yùn)行完后，make會檢測每個命令的返回碼，如果命令返回成功，那么make會執(zhí)行下一條命令，當(dāng)規(guī)則中所有的命令成功返回后，這個規(guī)則就算是成功完成了。如果一個規(guī)則中的某個命令出錯了（命令退出碼非零），那么make就會終止執(zhí)行當(dāng)前規(guī)則，這將有可能終止所有規(guī)則的執(zhí)行。
有些時候，命令的出錯并不表示就是錯誤的。例如mkdir命令，我們一定需要建立一個目錄，如果目錄不存在，那么mkdir就成功執(zhí)行，萬事大吉，如果目錄存在，那么就出錯了。我們之所以使用mkdir的意思就是一定要有這樣的一個目錄，于是我們就不希望mkdir出錯而終止規(guī)則的運(yùn)行。
為了做到這一點(diǎn)，忽略命令的出錯，我們可以在Makefile的命令行前加一個減號“-”（在Tab鍵之后），標(biāo)記為不管命令出不出錯都認(rèn)為是成功的。如：
???clean:
????????????-rm?-f?*.o
還有一個全局的辦法是，給make加上“-i”或是“--ignore-errors”參數(shù)，那么，Makefile中所有命令都會忽略錯誤。而如果一個規(guī)則是以“.IGNORE”作為目標(biāo)的，那么這個規(guī)則中的所有命令將會忽略錯誤。這些是不同級別的防止命令出錯的方法，你可以根據(jù)你的不同喜歡設(shè)置。
還有一個要提一下的make的參數(shù)的是“-k”或是“--keep-going”，這個參數(shù)的意思是，如果某規(guī)則中的命令出錯了，那么就終目該規(guī)則的執(zhí)行，但繼續(xù)執(zhí)行其它規(guī)則。
四、嵌套執(zhí)行make
在一些大的工程中，我們會把我們不同模塊或是不同功能的源文件放在不同的目錄中，我們可以在每個目錄中都書寫一個該目錄的Makefile，這有利于讓我們的Makefile變得更加地簡潔，而不至于把所有的東西全部寫在一個Makefile中，這樣會很難維護(hù)我們的Makefile，這個技術(shù)對于我們模塊編譯和分段編譯有著非常大的好處。
例如，我們有一個子目錄叫subdir，這個目錄下有個Makefile文件，來指明了這個目錄下文件的編譯規(guī)則。那么我們總控的Makefile可以這樣書寫：
????subsystem:
????????????cd?subdir?&&?$(MAKE)
其等價于：
????subsystem:
????????????$(MAKE)?-C?subdir
定義$(MAKE)宏變量的意思是，也許我們的make需要一些參數(shù)，所以定義成一個變量比較利于維護(hù)。這兩個例子的意思都是先進(jìn)入“subdir”目錄，然后執(zhí)行make命令。
我們把這個Makefile叫做“總控Makefile”，總控Makefile的變量可以傳遞到下級的Makefile中（如果你顯示的聲明），但是不會覆蓋下層的Makefile中所定義的變量，除非指定了“-e”參數(shù)。
如果你要傳遞變量到下級Makefile中，那么你可以使用這樣的聲明：
????export?<variable?...>;
如果你不想讓某些變量傳遞到下級Makefile中，那么你可以這樣聲明：?
????unexport?<variable?...>;
如：
????
????示例一：
????????export?variable?=?value
????????其等價于：
????????variable?=?value
????????export?variable
????????其等價于：
????????export?variable?:=?value
????????其等價于：
????????variable?:=?value
????????export?variable
????示例二：
????????export?variable?+=?value
????????其等價于：
????????variable?+=?value
????????export?variable
如果你要傳遞所有的變量，那么，只要一個export就行了。后面什么也不用跟，表示傳遞所有的變量。
需要注意的是，有兩個變量，一個是SHELL，一個是MAKEFLAGS，這兩個變量不管你是否export，其總是要傳遞到下層Makefile中，特別是MAKEFILES變量，其中包含了make的參數(shù)信息，如果我們執(zhí)行“總控Makefile”時有make參數(shù)或是在上層Makefile中定義了這個變量，那么MAKEFILES變量將會是這些參數(shù)，并會傳遞到下層Makefile中，這是一個系統(tǒng)級的環(huán)境變量。
但是make命令中的有幾個參數(shù)并不往下傳遞，它們是“-C”,“-f”,“-h”“-o”和“-W”（有關(guān)Makefile參數(shù)的細(xì)節(jié)將在后面說明），如果你不想往下層傳遞參數(shù)，那么，你可以這樣來：
????subsystem:
????????????cd?subdir?&&?$(MAKE)?MAKEFLAGS=
如果你定義了環(huán)境變量MAKEFLAGS，那么你得確信其中的選項(xiàng)是大家都會用到的，如果其中有“-t”,“-n”,和“-q”參數(shù)，那么將會有讓你意想不到的結(jié)果，或許會讓你異常地恐慌。
還有一個在“嵌套執(zhí)行”中比較有用的參數(shù)，“-w”或是“--print-directory”會在make的過程中輸出一些信息，讓你看到目前的工作目錄。比如，如果我們的下級make目錄是“/home/hchen/gnu/make”，如果我們使用“make?-w”來執(zhí)行，那么當(dāng)進(jìn)入該目錄時，我們會看到：
????make:?Entering?directory?`/home/hchen/gnu/make'.
而在完成下層make后離開目錄時，我們會看到：
????make:?Leaving?directory?`/home/hchen/gnu/make'
當(dāng)你使用“-C”參數(shù)來指定make下層Makefile時，“-w”會被自動打開的。如果參數(shù)中有“-s”（“--slient”）或是“--no-print-directory”，那么，“-w”總是失效的。
五、定義命令包
如果Makefile中出現(xiàn)一些相同命令序列，那么我們可以為這些相同的命令序列定義一個變量。定義這種命令序列的語法以“define”開始，以“endef”結(jié)束，如：
????define?run-yacc
????yacc?$(firstword?$^)
????mv?y.tab.c?$@
????endef
這里，“run-yacc”是這個命令包的名字，其不要和Makefile中的變量重名。在“define”和“endef”中的兩行就是命令序列。這個命令包中的第一個命令是運(yùn)行Yacc程序，因?yàn)?/span>Yacc程序總是生成“y.tab.c”的文件，所以第二行的命令就是把這個文件改改名字。還是把這個命令包放到一個示例中來看看吧。
????foo.c?:?foo.y
????????????$(run-yacc)
我們可以看見，要使用這個命令包，我們就好像使用變量一樣。在這個命令包的使用中，命令包“run-yacc”中的“$^”就是“foo.y”，“$@”就是“foo.c”（有關(guān)這種以“$”開頭的特殊變量，我們會在后面介紹），make在執(zhí)行命令包時，命令包中的每個命令會被依次獨(dú)立執(zhí)行。
轉(zhuǎn)載于:https://www.cnblogs.com/papam/archive/2009/08/26/1554565.html
總結(jié)
以上是生活随笔為你收集整理的Makefile 书写命令的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 2009-08 台湾印象
- 下一篇： Android实例剖析笔记（二）