[轉貼]Linux下Makefile的automake生成全攻略[三]

 文/餘濤

轉自：http://tech.sina.com.cn/s/2004-10-19/1115443045.shtml

　　四、深入淺出

　　針對上面提到的各個指令，我們再做些詳細的介紹。

　　1、 autoscan

　　autoscan是用來掃描源代碼目錄生成configure.scan檔案的。autoscan可以用目錄名做為參數，但如果你不使用參數的話，那麼autoscan将認為使用的是目前目錄。autoscan将掃描你所指定目錄中的源檔案，并建立configure.scan檔案。

　　2、 configure.scan

　　configure.scan包含了 系統配置的基本選項，裡面都是一些宏定義。我們需要将它改名為configure.in

　　3、 aclocal

　　aclocal是一個perl 腳本程式。aclocal根據configure.in檔案的内容，自動生成aclocal.m4檔案。aclocal的定義是：“aclocal - create aclocal.m4 by scanning configure.ac”。

　　4、 autoconf

　　autoconf是用來産生configure檔案的。configure是一個腳本，它能設定源程式來适應各種不同的作業系統平台，并且根據不同的系統來産生合适的Makefile，進而可以使你的源代碼能在不同的作業系統平台上被編譯出來。

　　configure.in檔案的内容是一些宏，這些宏經過autoconf 處理後會變成檢查系統特性、環境變量、軟體必須的參數的shell腳本。configure.in檔案中的宏的順序并沒有規定，但是你必須在所有宏的最前面和最後面分别加上AC_INIT宏和AC_OUTPUT宏。

　　在configure.ini中：

　　#号表示注釋，這個宏後面的内容将被忽略。

　　AC_INIT(FILE)

　　這個宏用來檢查源代碼所在的路徑。

AM_INIT_AUTOMAKE(PACKAGE, VERSION)

　　 這個宏是必須的，它描述了我們将要生成的軟體包的名字及其版本号：PACKAGE是軟體包的名字，VERSION是版本号。當你使用make dist指令時，它會給你生成一個類似helloworld-1.0.tar.gz的軟體發行包，其中就有對應的軟體包的名字和版本号。

AC_PROG_CC

　　這個宏将檢查系統所用的C編譯器。

AC_OUTPUT(FILE)

　　這個宏是我們要輸出的Makefile的名字。

　　我們在使用automake時，實際上還需要用到其他的一些宏，但我們可以用aclocal 來幫我們自動産生。執行aclocal後我們會得到aclocal.m4檔案。

　　産生了configure.in和aclocal.m4 兩個宏檔案後，我們就可以使用autoconf來産生configure檔案了。

　　5、 Makefile.am

　　Makefile.am是用來生成Makefile.in的，需要你手工書寫。Makefile.am中定義了一些内容：

AUTOMAKE_OPTIONS

　　這個是automake的選項。在執行automake時，它會檢查目錄下是否存在标準GNU軟體包中應具備的各種檔案，例如AUTHORS、ChangeLog、NEWS等檔案。我們将其設定成foreign時，automake會改用一般軟體包的标準來檢查。

bin_PROGRAMS

　　這個是指定我們所要産生的可執行檔案的檔案名。如果你要産生多個可執行檔案，那麼在各個名字間用空格隔開。

helloworld_SOURCES

　　這個是指定産生“helloworld”時所需要的源代碼。如果它用到了多個源檔案，那麼請使用空格符号将它們隔開。比如需要helloworld.h，helloworld.c那麼請寫成helloworld_SOURCES= helloworld.h helloworld.c。

　　如果你在bin_PROGRAMS定義了多個可執行檔案，則對應每個可執行檔案都要定義相對的filename_SOURCES。

　　6、 automake

　　我們使用automake --add-missing來産生Makefile.in。

　　選項--add-missing的定義是“add missing standard files to package”，它會讓automake加入一個标準的軟體包所必須的一些檔案。

　　我們用automake産生出來的Makefile.in檔案是符合GNU Makefile慣例的，接下來我們隻要執行configure這個shell 腳本就可以産生合适的 Makefile 檔案了。

　　7、 Makefile

　　在符合GNU Makefiel慣例的Makefile中，包含了一些基本的預先定義的操作：

make

　　根據Makefile編譯源代碼，連接配接，生成目标檔案，可執行檔案。

make clean

　　清除上次的make指令所産生的object檔案（字尾為“.o”的檔案）及可執行檔案。

make install

　　将編譯成功的可執行檔案安裝到系統目錄中，一般為/usr/local/bin目錄。

make dist

　　産生釋出軟體封包件（即distribution package）。這個指令将會将可執行檔案及相關檔案打包成一個tar.gz壓縮的檔案用來作為釋出軟體的軟體包。

　　它會在目前目錄下生成一個名字類似“PACKAGE-VERSION.tar.gz”的檔案。PACKAGE和VERSION，是我們在configure.in中定義的AM_INIT_AUTOMAKE(PACKAGE, VERSION)。

make distcheck

　　生成釋出軟體包并對其進行測試檢查，以确定釋出包的正确性。這個操作将自動把壓縮封包件解開，然後執行configure指令，并且執行make，來确認編譯不出現錯誤，最後提示你軟體包已經準備好，可以釋出了。

=============================================== helloworld-1.0.tar.gz is ready for distribution =============================================== make distclean

　　類似make clean，但同時也将configure生成的檔案全部删除掉，包括Makefile。

　　 五、結束語

　　通過上面的介紹，你應該可以很容易地生成一個你自己的符合GNU慣例的Makefile檔案及對應的項目檔案。

　　如果你想寫出更複雜的且符合慣例的Makefile，你可以參考一些開放代碼的項目中的configure.in和Makefile.am檔案，比如：嵌入式資料庫sqlite，單元測試cppunit。