轉(zhuǎn)載自：Makefile.am 規(guī)則和實例詳解--鵬博客
編寫Linux C 程序的時候，自己來寫Makefile著實的讓人很頭疼沃疮，如果是簡單的項目自己寫寫也就罷了，但是如果遇到大項目自己寫Makefile，那是要弄死人的街图，所以最近在研究Autotools工具自動生成Makefile莺匠，在用到autotools工具生成Makefile的時候金吗，還是有一部分需要自己來完成的，那就是Makefile.am文件趣竣。
項目中寫在源文件里的Makefile.am是一種比我們了解的Makefile更高層次的編譯規(guī)則摇庙，它可以和編寫的configure.in（了解更多configure.in的規(guī)則請閱讀《configure.ac (configure.in)詳解》）文件一起通過調(diào)用automake命令，來生成Makefile.in文件期贫，然后再調(diào)用./configure跟匆，將Makefile.in文件自動的生成Makefile文件。所以Makefile.am文件是要自動生成Makefile必不可少的元素通砍，下面鵬博客就來和大家著重的學(xué)習(xí)下Makefile.am的寫法和規(guī)則玛臂。
先來說下Makefile.am中常見的文件編譯類型，詳細的編譯類型和全局變量鵬博客會在下面在圖表中列出：
PROGRAMS ? ? ? ? ? 表示可執(zhí)行文件
SOURCES ? ? ? ? ? ? ?表示源文件
HEADERS ? ? ? ? ? ? ?頭文件封孙。
LIBRARIES ? ? ? ? ? ? 表示庫文件
LTLIBRARIES ? ? ? ? 這也是表示庫文件迹冤，前面的LT表示libtool。
DATA ? ? ? ? ? ? ? ? ? ? ? 數(shù)據(jù)文件虎忌，不能執(zhí)行泡徙。
SCRIPTS ? ? ? ? ? ? ? ?腳本文件，這個可以被用于執(zhí)行膜蠢。如：example_SCRIPTS堪藐，如果用這樣的話莉兰，需要我們自己定義安裝目錄下的example目錄，很容易的礁竞，往下看糖荒。
一、基本寫法
下面就直接引入一個例子進行詳細講解模捂，如下：
AUTOMAKE_OPTIONS = foreign
bin_PROGRAMS?=?client
client_SOURCES?=?key.c?connect.c?client.c?main.c?session.c?hash.c
client_CPPFLAGS?=?-DCONFIG_DIR=\“$(sysconfdir)\”?-DLIBRARY_DIR=\”$(pkglibdir)\”
client_LDFLAGS?=?-export-dynamic?-lmemcached
noinst_HEADERS?=?client.h
INCLUDES?=?-I/usr/local/libmemcached/include/
client_LDADD?=?$(top_builddir)/sx/libsession.la?\
$(top_builddir)/util/libutil.la
上面就是一個Makefile.am示例文件捶朵，這個文件是用于生成client可執(zhí)行應(yīng)用程序，引用了兩個靜態(tài)庫和MC等動態(tài)庫的連接狂男。
先來看個圖表一（列出了可執(zhí)行文件综看、靜態(tài)庫、頭文件和數(shù)據(jù)文件岖食，四種書寫Makefile.am文件個一般格式红碑。）：
對于可執(zhí)行文件和靜態(tài)庫類型，如果只想編譯县耽，不想安裝到系統(tǒng)中句喷，可以用noinst_PROGRAMS代替bin_PROGRAMS，noinst_LIBRARIES代替lib_LIBRARIES兔毙。以此類推唾琼。
根據(jù)這個圖表一來分析下具體內(nèi)容：
AUTOMAKE_OPTIONS：這個是用來設(shè)定automake的選項。automake主要是幫助開發(fā)GNU軟件的人員維護軟件套件澎剥，一般在執(zhí)行automake時會檢查目錄下是否存在標準GNU套件中應(yīng)具備的文件檔案锡溯，例如NEWS、AUTHOR哑姚、ChangeLog等祭饭，設(shè)成foreign時，automake會改用一般軟件套件標準來檢查叙量，而gnu是缺省設(shè)置倡蝙，該級別下將盡可能地檢查包是否服從GNU標準，gnits是嚴格標準绞佩，不推薦寺鸥。
bin_PROGRAMS：表示要生成的可執(zhí)行應(yīng)用程序文件，這里的bin表示可執(zhí)行文件在安裝時需要被安裝到系統(tǒng)中品山，如果只是想編譯胆建。不想被安裝到系統(tǒng)中，可以用noinst_PROGRAMS來代替肘交。
那么整個第一行?bin_PROGRAMS=client 詳細表示什么意思那笆载，解釋如下：
PROGRAMS知道這是一個可執(zhí)行文件。
client表示編譯的目標文件。
bin表示目錄文件被安裝到系統(tǒng)的目錄凉驻。
如程序和圖片所示腻要，包括頭文件，靜態(tài)庫的定義等等都是這種形式沿侈，如lib_LIBRARIES=util闯第，表示將util庫安裝到lib目錄下。
繼續(xù)解釋文件內(nèi)容：
client_SOURCES：表示生成可執(zhí)行應(yīng)用程序所用的所有源文件源文件缀拭，多個就空格隔開，我們注意到client_是由前面的bin_PROGRAMS指定的填帽，如果前面是生成example, 那么這里也就變成example_SOURCES蛛淋，其它的規(guī)則類似標識也是一樣。
client_CPPFLAGS：這個和我們寫Makefile的時候意思是一樣的篡腌，都表示C語言的預(yù)處理器參數(shù)褐荷，這里指定了DCONFIG_DIR，以后在程序中嘹悼，就可以直接使用CONFIG_DIR,不要把這個和另一個CFLAGS混淆叛甫，后者表示編譯器參數(shù)。
client_LDFLAGS：表示在連接時所需要的庫文件選項標識杨伙。這個也就是對應(yīng)一些如-l,-shared等選項其监。
noinst_HEADERS：表示該頭文件只是參加可執(zhí)行文件的編譯，而不用安裝到安裝目錄下限匣。如果需要安裝到系統(tǒng)中抖苦，可以用include_HEADERS來代替。
INCLUDES：表示連接時所需要的頭文件米死。
client_LDADD：表示連接時所需要的庫文件,這里表示需要兩個庫文件的支持锌历，下面會看到這個庫文件又是怎么用Makefile.am文件后成的。
如圖表二：
全局變量峦筒，可能有人注意到文件中的$(top_builddir)等全局變量究西，其實這個是Makefile.am系統(tǒng)定義的一個基本路徑變量，表示生成目標文件的最上層目錄物喷，如果這個Makefile.am文件變成其它的Makefile.am文件卤材，那么這個就表示其它的目錄，而不是這個當前目錄脯丝。我們還可以使用$(top_srcdir)商膊，這個表示工程的最頂層目錄，其實也是第一個Makefile.am的入口目錄宠进，因為Makefile.am文件可以被遞歸性的調(diào)用晕拆。
如圖表三：（在Makefile.am中盡量使用相對路徑，系統(tǒng)預(yù)定義了兩個基本路徑）
$(sysconfdir)：在系統(tǒng)安裝工具的時候，我們經(jīng)常能遇到配置安裝路徑的命令实幕，如：./configure –prefix=/install/apache ?其實在調(diào)用這個之后吝镣，就定義了一個變量$(prefix), 表示安裝的路徑，如果沒有指定安裝的路徑昆庇，會被安裝到默認的路徑末贾，一般都是/usr/local。在定義$(prefix)整吆，還有一些預(yù)定義好的目錄,其實這一些定義都可以在頂層的Makefile文件中可以看到拱撵，如下面一些值：
bindir = $(prefix)/bin。
libdir = $(prefix)/lib表蝙。
datadir=$(prefix)/share拴测。
sysconfdir=$(prefix)/etc。
includedir=$(prefix)/include府蛇。
這些量還可以用于定義其它目錄集索，例如我想將client.h安裝到include/client目錄下，這樣寫Makefile.am文件：
clientincludedir=$(includedir)/client
clientinclude_HEADERS=$(top_srcdir)/client/client.h
這就達到了我的目的汇跨，相當于定義了一個安裝類型务荆，這種安裝類型是將文件安裝到include/client目錄下。
我們自己也可以定義新的安裝目錄下的路徑穷遂，如我在應(yīng)用中簡單定義的：
devicedir?=?${prefix}/device
device_DATA?=?package
這樣的話函匕，package文件會作為數(shù)據(jù)文件安裝到device目錄之下，這樣一個可執(zhí)行文件就定義好了塞颁。注意浦箱，這也相當于定義了一種安裝類型：devicedir，所以你想怎么安裝就怎么安裝祠锣，后面的XXXXXdir酷窥，dir是固定不變的。
二伴网、配置靜態(tài)庫
下面我們來說下編譯靜態(tài)庫和編譯動態(tài)庫蓬推，我們說下靜態(tài)庫，下面這個例子比較簡單澡腾。直接指定 XXXX_LTLIBRARIES或者XXXX_LIBRARIES就可以了沸伏。同樣如果不需要安裝到系統(tǒng)，將XXXX換成noinst就可以动分。
一般推薦使用libtool庫編譯目標毅糟，因為automake包含libtool，這對于跨平臺可移植的庫來說澜公，是一個很好的事情姆另。
看例子如下：
noinst_LTLIBRARIES?=?libutil.la
oinst_HEADERS?=?inaddr.h?util.h?compat.h?pool.h?xhash.h?url.h?device.h
ibutil_la_SOURCES?=?access.c?config.c?datetime.c?hex.c?inaddr.c?log.c?device.c?pool.c?rate.c?sha1.c?stanza.c?str.c?xhash.c
ibutil_la_LIBADD?=?@LDFLAGS@
第一行的noinst_LTLIBRARIES，這里要注意的是LTLIBRARIES，另外還有LIBRARIES迹辐，兩個都表示庫文件蝶防。前者表示libtool庫，用法上基本是一樣的明吩。如果需要安裝到系統(tǒng)中的話间学，用lib_LTLIBRARIES。
.la為libtool自動生成的一些共享庫印荔，vi編輯查看低葫，主要記錄了一些配置信息∪月桑可以用如下命令查看*.la文件的格式?? $file *.la
.a為靜態(tài)庫,是好多個.o合在一起,用于靜態(tài)連接
如果想編譯 .a 文件氮采，那么上面的配置就改成如下結(jié)果：
noinst_LTLIBRARIES?=?libutil.a
oinst_HEADERS?=?inaddr.h?util.h?compat.h?pool.h?xhash.h?url.h?device.h
ibutil_a_SOURCES?=?access.c?config.c?datetime.c?hex.c?inaddr.c?log.c?device.c?pool.c?rate.c?sha1.c?stanza.c?str.c?xhash.c
ibutil_a_LIBADD?=?@LDFLAGS@
注意：靜態(tài)庫編譯連接時需要其它的庫的話，采用XXXX_LIBADD選項染苛，而不是前面的XXXX_LDADD。編譯靜態(tài)庫是比較簡單的主到，因為直接可以指定其類型茶行。
三、配置動態(tài)庫
如果想要編譯XXX.so動態(tài)庫文件登钥，需要用到_PROGRAMS類型畔师，有一個關(guān)于安裝路徑的問題，如果希望將動態(tài)庫安裝到lib目錄下牧牢，按照前面所說的看锉，只需要寫成lib_PROGRAMS就可以了，lib表示安裝的路徑塔鳍，但是automake不允許這樣直接定義伯铣，所以可以采用下面的辦法，同樣是將動態(tài)庫安裝到lib目錄下：
projectlibdir=$(libdir)//新建一個目錄轮纫，就是該目錄就是lib目錄
projectlib_PROGRAMS=project.so
project_so_SOURCES=xxx.C
project_so_LDFLAGS=-shared?-fpic//GCC編譯動態(tài)庫的選項
這個動態(tài)庫的編譯寫法是鵬博客網(wǎng)上總結(jié)的腔寡，希望有要的人自己來驗證下。
四掌唾、SUBDIRS功能用法
SUBDIRS這是一個很重要的詞放前，我們前面生成了一個目標文件，但是一個大型的工程項目是由許多個可執(zhí)行文件和庫文件組成糯彬，也就是包含多個目錄凭语，每個目錄下都有用于生成該目錄下的目標文件的Makefile.am文件，但頂層目錄是如何調(diào)用撩扒，才能使下面各個目錄分別生成自己的目標文件呢似扔？就是SUBDIRS關(guān)鍵詞的用法了。
看一下我的工程項目，這是頂層的Makefile.am文件
EXTRA_DIST?=?Doxyfile.in?README.win32?README.protocol?contrib?UPGRADE
devicedir?=?${prefix}/device
device_DATA?=?package
SUBDIRS?=?etc?man
ifUSE_LIBSUBST
SUBDIRS?+=?subst
endif
SUBDIRS?+=?tools?io?sessions?util?client?dispatch?server?hash?storage?sms
SUBDIRS表示在處理目錄之前虫几，要遞歸處理哪些子目錄锤灿，要注意處理的順序。比如配置中的client對sessions和utils這兩上目標文件有依賴關(guān)系辆脸，就在client之前需要處理這兩個目標文件但校。
EXTRA_DIST：將哪些文件一起打包。
五啡氢、打包處理
Automake會自動的打包状囱，自動打包的內(nèi)容如下：
所有程序的源文件。
所有子目錄里的的Makefile.am文件倘是。
Makefile.am中包含的文件亭枷。
./configure所要讀取的文件。
EXTRA_DIST所指定的文件搀崭。
dist和nodist指定的文件叨粘，也可將其中一個源文件指定為不打包：
例如： nodist_client_SOURCES = client.c
六、最后
這里是鵬博客總結(jié)的一些比較實用的Makefile.am的寫法和規(guī)則瘤睹，看完了這篇文章已經(jīng)可以很詳細的理解這個文件的內(nèi)容升敲，寫起來也應(yīng)該不會陌生，但automake還有許多其他的規(guī)則需要掌握轰传，鵬博客將會繼續(xù)全面的總結(jié)關(guān)于autotools 的一些規(guī)則和寫法驴党，希望對大家有用處。也歡迎大家指出問題获茬，幫我完善這個博客港庄，希望大家支持！
