定義
在Unix 上寫過程式的人一般都遇到過 Makefile,尤其是用 C 來開發程式的人。用 make 來開發和編譯程式的確很方便,可是要寫出一個MakeFile就不那么簡單了。偏偏介紹 Makefile 的檔案不多,GNU Make 那份印出來要幾百頁的檔案,光看完 Overview 自己就快要先Over了,難怪許多人聞 Unix色變。本文將介紹如何利用 GNU Autoconf 及 Automake 這兩套軟體來幫助『自動』產生 Makefile 檔案,並且讓開發出來的的軟體可以象 Apache, MySQL 和常見的 GNU 軟體一樣,只要會 ``./configure'', ``make'', ``make install'' 就可以把程式安裝到系統中。如果您有心開發 Open Source 的軟體,或只是想在 Unix 系統下寫寫程式。希望這份介紹檔案能幫助您輕鬆的進入 Unix Programming 的殿堂。
介紹
Makefile 基本上就是『目標』(target), 『關聯』(dependencies) 和『動作』三者所組成的一系列規則。而 make 就會根據 Makefile 的規則來決定如何編譯 (compile) 和連線 (link) 程式。實際上,make 可做的不只是編譯和連線程式,例如 FreeBSD 的 port collection 中,Makefile還可以做到自動下載遠程程式,解壓縮 (extract) , 打補丁 (patch),設定,然後編譯,安裝到系統中。
Makefile 基本結構雖然很簡單,但是妥善運用這些規則就可以變換出許多不同的花樣。卻也因為這樣,許多剛剛開始學習寫Makefile 時會覺得沒有規範可以遵循,每個人寫出來的Makefile都不大一樣,不知道從哪裡下手,而且常常會受到自己的開發環境的限制,只要環境參數不同或者路徑更改,可能 Makefile 就得跟著修改修改。雖然有 GNU Makefile Conventions (GNU Makefile慣例例)訂出一些使用 GNU 程式設計時撰寫 Makefile 的一些標準和規範,但是內容很長而且很複雜,並且經常作一些調整,為了減輕程式開發人員維護Makefile 的負擔,因此出現了Automake。
程式設計者只需要寫一些預先定義好的宏 (macro),提交給Automake處理後會產生一個可以供 Autoconf 使用的 Makefile.in檔案。再配合利用 Autoconf產生的自動培植設定檔案 configure 即可產生一份符合符合 GNU Makefile 慣例的 Makeifle 了。
上路之前
在開始使用 Automake 之前,首先確認你的系統安裝有如下軟體:
1.GNU Automake
2.GNU Autoconf
3.GNU m4
4.perl
5.GNU Libtool (如果你需要產生 shared library)
建議最好也使用 GNU C/C++ 編譯器 、GNU Make 以及其它 GNU 的工具程式來作為開發的環境,這些工具都是屬於 Open Source Software 不但免費而且功能強大。如果你是使用 Red Hat Linux 可以找到所有上述軟體的 rpm 檔案,FreeBSD 也有現成的 package 可以直接安裝,或也可以自行下載這些軟體的原始碼回來安裝。下面的示例是在Red Hat Linux 5.2 + CLE2 的環境下所完成的。
簡單的例子
Automake 所產生的 Makefile 除了可以做到程式的編譯和連線,也已經把如何產生程式檔案 (如 manual page, info 檔案及 dvi 檔案) 的動作,還有把源碼檔案包裝起來以供發布都考慮進去了,所以程式原始碼所存放的目錄結構最好符合GNU 的標準慣例,接下來就用一個hello.c 來做為例子。
在工作目錄下建立一個新的子目錄"devel"',再在 devel 下建立一個"hello"' 的子目錄,這個目錄將作為存放 hello這個程式及其相關檔案的地方:
% mkdir devel
% cd devel
% mkdir hello
% cd hello
用編輯器寫一個hello.c檔案,
#include
int main(int argc, char** argv) {
printf(``Hello, GNU!\n'');
return 0;
}
接下來就要用 Autoconf 及 Automake 來產生 Makefile 檔案了,
1.
用 autoscan 產生一個 configure.in 的原型,執行autoscan 後會產生一個configure.scan 的檔案,可以用它作為 configure.in檔案的藍本。
% autoscan
% ls
configure.scan hello.c
2.
編輯 configure.scan檔案,如下所示,並且改名為configure.in
dnl Process this file with autoconf to produce a configure script. AC_INIT(hello.c) AM_INIT_AUTOMAKE(hello, 1.0)
dnl Checks for programs.
AC_PROG_CC
dnl Checks for libraries.
dnl Checks for header files.
dnl Checks for typedefs, structures, and compiler characteristics.
dnl Checks for library functions.
AC_OUTPUT(Makefile)
3.
執行 aclocal 和 autoconf ,分別會產生 aclocal.m4 及 configure 兩個檔案
% aclocal
% autoconf
% ls
aclocal.m4 configure configure.in hello.c
4.
編輯 Makefile.am 檔案,內容如下
AUTOMAKE_OPTIONS= foreign
bin_PROGRAMS= hello
hello_SOURCES= hello.c
5.
執行 automake --add-missing ,Automake 會根據Makefile.am 檔案產生一些檔案,包含最重要的 Makefile.in
% automake --add-missing automake: configure.in: installing `./install-sh' automake: configure.in: installing `./mkinstalldirs' automake: configure.in: installing `./missing'
6.
最後執行 ./configure ,
% ./configure creating cache ./config.cache checking for a BSD compatible install... /usr/bin/install -c checking whether build environment is sane... yes checking whether make sets $... yes checking for working aclocal... found checking for working autoconf... found checking for working automake... found checking for working autoheader... found checking for working makeinfo... found checking for gcc... gcc checking whether the C compiler (gcc ) works... yes checking whether the C compiler (gcc ) is a cross-compiler... no checking whether we are using GNU C... yes checking whether gcc accepts -g... yes updating cache ./config.cache creating ./config.status creating Makefile
現在你的目錄下已經產生了一個 Makefile 檔,下個 ``make'' 指令就可以開始編譯 hello.c 成執行檔,執行 ./hello 和 GNU 打聲招呼吧!
% make gcc -DPACKAGE=\"hello\" -DVERSION=\"1.0\" -I. -I. -g -O2 -c hello.c gcc -g -O2 -o hello hello.o % ./hello Hello! GNU!
你還可以試試 ``make clean'',''make install'',''make dist'' 看看會有什麼結果。你也可以把產生出來的 Makefile 秀給你的老闆,讓他從此對你刮目相看 :-)
追根問底
上述產生Makefile 的過程和以往自行編寫的方式非常不一樣,捨棄傳統自定義make 的規則,使用 Automake 只需用到一些已經定義好的宏就可以了。我們把宏及目標 (target)寫在Makefile.am 檔案內,Automake 讀入 Makefile.am 檔案後會把這一串已經定義好的宏展開並產生相對應的 Makefile.in 檔案,然後再由 configure這個 shell script 根據 Makefile.in 產生合適的Makefile。
利用 autoconf 及 automake產生Makefile 的流程
上圖表示在上一範例中要使用的檔案檔案及產生出來的檔案,有星號 (*) 者代表執行檔。在此示例中可由 Autoconf 及 Automake 工具所產生的額外檔案有 configure.scan、aclocal.m4、configure、Makefile.in,需要自行加入設定的有configure.in 及 Makefile.am。
4.1 編輯 configure.in 檔案
Autoconf 是用來產生 'configure'檔案的工具。'configure' 是一個 shell script,它可以自動設定原始程式以符合各種不同平台上Unix 系統的特性,並且根據系統參數及環境產生合適的Makefile檔案或C 的頭檔案(header file),讓原始程式可以很方便地在不同的平台上進行編譯。Autoconf會讀取 configure.in 檔案然後產生'configure' 這個 shell script。
configure.in 檔案內容是一系列GNU m4 的宏,這些宏經autoconf處理後會變成檢查系統特性的shell scripts。 configure.in 內宏的順序並沒有特別的規定,但是每一個configure.in 檔案必須在所有宏前加入 AC_INIT 宏,然後在所有宏的最後加上 AC_OUTPUT宏。可先用 autoscan 掃描原始檔案以產生一個 configure.scan 檔案,再對 configure.scan 做些修改成 configure.in 檔案。在範例中所用到的宏如下:
dnl
這個宏後面的字不會被處理,可以視為注釋
AC_INIT(FILE)
該宏用來檢查原始碼所在路徑,autoscan 會自動產生,一般無須修改它。
AM_INIT_AUTOMAKE(PACKAGE,VERSION)
這個是使用 Automake 所必備的宏,PACKAGE 是所要產生軟體套件的名稱,VERSION 是版本編號。
AC_PROG_CC
檢查系統可用的C編譯器,若原始碼是用C寫的就需要這個宏。
AC_OUTPUT(FILE)
設定 configure 所要產生的檔案,若是Makefile ,configure 便會把它檢查出來的結果帶入 Makefile.in 檔案後產生合適的 Makefile。
實際上,這裡使用 Automake 時,還需要一些其他的宏,這些額外的宏我們用 aclocal來幫助產生。執行 aclocal會產生aclocal.m4 檔案,如果無特別的用途,可以不需要修改它,用 aclocal 所產生的宏會告訴 Automake如何動作。
有了 configure.in 及 aclocal.m4兩個檔案以後,便可以執行 autoconf來產生 configure 檔案了。
4.2 編輯Makefile.am 檔案
接下來要編輯Makefile.am 檔案,Automake 會根據 configure.in 中的宏把Makefile.am 轉成 Makefile.in 檔案。 Makefile.am 檔案定義所要產生的目標:
AUTOMAKE_OPTIONS
設定 automake 的選項。Automake 主要是幫助開發 GNU 軟體的人員來維護軟體,所以在執行 automake 時,會檢查目錄下是否存在標準 GNU 軟體中應具備的檔案,例如 'NEWS'、'AUTHOR'、'ChangeLog' 等檔案。設定 foreign 時,automake 會改用一般軟體的標準來檢查。
bin_PROGRAMS
定義要產生的執行檔案名稱。如果要產生多個執行檔案,每個檔案名稱用空白符隔開。
hello_SOURCES
定義 'hello' 這個執行程式所需要的原始檔案。如果 'hello'這個程式是由多個原始檔案所產生,必須把它所用到的所有原始檔案都列出來,以空白符隔開。假設 'hello' 還需要 'hello.c'、'main.c'、'hello.h' 三個檔案的話,則定義
hello_SOURCES= hello.c main.c hello.h
如果定義多個執行檔案,則對每個執行程式都要定義相對的filename_SOURCES。
編輯好 Makefile.am 檔案,就可以用 automake --add-missing來產生 Makefile.in。加上 --add-missing 選項來告訴 automake順便假如包裝一個軟體所必須的檔案。Automake產生生出來的 Makefile.in 檔案是完全符合 GNU Makefile 的慣例,只要執行 configure這個shell script 便可以產生合適的 Makefile 檔案了。
4.3 使用 Makefile
利用 configure 所產生的 Makefile檔案有幾個預先設定的目標可供使用,這裡只用幾個簡述如下:
make all
產生設定的目標,既次範例中的執行檔案。只敲入make 也可以,此時會開始編譯原始碼,然後連線並產生執行檔案。
make clean
清除之前所編譯的執行檔案及目標檔案(object file, *.o)。
make distclean
除了清除執行檔案和目的檔案以外,也把 configure 所產生的 Makefile 清除掉。
make install
將程式安裝到系統中,若源碼編譯成功,且執行結果正確,便可以把程式安裝到系統預先設定的執行檔案存放路徑中,若用 bin_PROGRAMS 宏的話,程式會被安裝到 /usr/local/bin下。
make dist
將程式和相關的文檔包裝為一個壓縮文檔以供發布 (distribution) 。執行完在目錄下會產生一個以PACKAGE-VERSION.tar.gz 為名稱的檔案。PACKAGE 和 VERSION 這兩個參數是根據 configure.in 檔案中 AM_INIT_AUTOMAKE(PACKAGE, VERSION) 的定義。在此範例中會產生 'hello-1.0.tar.gz' 的檔案。
make distcheck
和 make dist 類似,但是加入檢查包裝以後的壓縮檔案是否正常,這個目標除了把程式和相關文檔包裝成 tar.gz 檔案外,還會自動把這個壓縮檔案解開,執行 configure,並執行 make all ,確認編譯無錯誤以後,戶顯示這個 tar.gz 檔案已經準備好可以發布了。這個檢查非常有用,檢查過關的套件,基本上可以給任何具備 GNU 開發環境的人去重新編譯成功。就 hello-1.tar.gz 這個範例而言,除了在Red Hat Linux 上,在 FreeBSD 2.2.x 也可以正確編譯。
要注意的是,利用 Autoconf 及 Automake 所產生出來的軟體套件是可以在沒有安裝 Autoconf 及 Automake 的環境使用的,因為 configure 是一個 shell script,它己被設計為可以在一般 Unix 的 sh 這個 shell 下執行。但是如果要修改 configure.in 及 Makefile.am 檔案再產生新的 configure 及 Makefile.in 檔案時就一定要有 Autoconf 及 Automake 了。
相關資料
Autoconf 和 Automake 功能十分強大,可以從它們附帶的 info 穩當4中找到詳細的使用方法說明。你也可以從許多現有的GNU 軟體或 Open Source 軟體中找到相關的 configure.in 或 Makefile.am 檔案,他們是學習 Autoconf 及 Automake 更多技巧的最佳範例。
這個簡介只用到了 Autoconf 及 Automake 的皮毛罷了,如果你有心加入 Open Source 軟體開發的行列,希望這篇文章可以幫助你對產生 Makefile 有個簡單的了解。其它有關開發 GNU 程式或 C 程式設計及 Makefile 的詳細運用及技巧,建議從 GNU Coding Standards (GNU 編碼規定) 讀起,裡面包含了 GNU Makefile 慣例,及開發 GNU 軟體的標準程式和慣例。這些 GNU 軟體的線上說明檔案可以在 http://www.gnu.org/ 上找到。
6. 結束語
利用 Autoconf 及 Automake,產生一個 Makefile 似乎不再象以前那么困難了,而使用 Autoconf 也使得我們在不同平台上或各家 Unix 之間發布及便宜程式變的簡單,這對於在Unix 系統上程式開發員來說減輕了許多負擔。妥善運用這些 GNU 的工具軟體,可以幫助我們更容易的去開發程式,而且更容易維護原始碼。