Makefile.am是一種比Makefile更高層次的編譯規則，可以和configure.in檔案一起通過呼叫automake命令，生成Makefile.in檔案，再呼叫./configure的時候，就將Makefile.in檔案自動生成Makefile檔案了。所以Makefile.am檔案是比Makefile檔案更高的抽象。

下面我根據自己的工作中的一些應用，來討論Makefile.am的編寫。我覺得主要是要注意的問題是將編譯什麼檔案？這個檔案會不會安裝？這個檔案被安裝到什麼目錄下？可以將檔案編譯成可執行檔案來安裝，也可以編譯成靜態庫檔案安裝，常見的檔案編譯型別有下面幾種：

1. PROGRAMS。表示可執行檔案
2. LIBRARIES。表示庫檔案
3. LTLIBRARIES。這也是表示庫檔案，前面的LT表示libtool。
4. HEADERS。標頭檔案。
5. SCRIPTS。指令碼檔案，這個可以被用於執行。如：example_SCRIPTS，如果用這樣的話，需要我們自己定義安裝目錄下的example目錄，很容易的，往下看。
6. DATA。資料檔案，不能執行。

一，可執行檔案

先看一個例項：

1. bin_PROGRAMS = client  
2. client_SOURCES = key.c connect.c client.c main.c session.c hash.c  
3. client_CPPFLAGS = -DCONFIG_DIR=\"$(sysconfdir)\" -DLIBRARY_DIR=\"$(pkglibdir)\"
4. client_LDFLAGS = -export-dynamic -lmemcached  
5. noinst_HEADERS = client.h  
6. INCLUDES = -I/usr/local/libmemcached/include/  
7. client_LDADD = $(top_builddir)/sx/libsession.la \  
8.             $(top_builddir)/util/libutil.la  

<span style="font-size:12px;">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</span>
 

bin_PROGRAMS：表示指定要生成的可執行應用程式檔案，這表示可執行檔案在安裝時需要被安裝到系統中，如果只是想編譯。不想被安裝到系統中，可以用noinst_PROGRAMS來代替。

一個簡單的問題是：bin_PROGRAMS=client 這一行表示什麼意思？解釋如下：

1. PROGRAMS知道這是一個可執行檔案。
2. client表示編譯的目標檔案。
3. bin表示目錄檔案被安裝到系統的目錄。

client_SOURCES：表示生成可執行應用程式所用的原始檔，這裡注意，client_是由前面的bin_PROGRAMS指定的，如果前面是生成example,那麼這裡就是example_SOURCES，其它的類似標識也是一樣。

client_CPPFLAGS：這和Makefile檔案中一樣，表示C語言前處理器引數，這裡指定了DCONFIG_DIR，以後在程式中，就可以直接使用CONFIG_DIR,不要把這個和另一個CFLAGS混淆，後者表示編譯器引數。

client_LDFLAGS：這個表示在連線時所需要的庫檔案選項標識。這個也就是對應一些如-l,-shared等選項。

noinst_HEADERS：這個表示該標頭檔案只是參加可執行檔案的編譯，而不用安裝到安裝目錄下。如果需要安裝到系統中，可以用include_HEADERS來代替。

INCLUDES：連線時所需要的標頭檔案。

client_LDADD：連線時所需要的庫檔案,這裡表示需要兩個庫檔案的支援，下面會看到這個庫檔案又是怎麼用Makefile.am檔案後成的。

再談談關於上文中的全域性變數引用，可能有人注意到$(top_builddir)等全域性變數（因為這個檔案之前沒有定義），其實這個變數是Makefile.am系統定義的一個基本路徑變數，表示生成目標檔案的最上層目錄，如果這個Makefile.am檔案被其它的Makefile.am檔案，這個會表示其它的目錄，而不是這個當前目錄。還可以使用$(top_srcdir)，這個表示工程的最頂層目錄，其實也是第一個Makefile.am的入口目錄，因為Makefile.am檔案可以被遞迴性的呼叫。

下面再說一下上文中出現的$(sysconfdir)，在系統安裝時，我們都記得先配置安裝路徑，如./configure --prefix=/install/apache 其實在呼叫這個之後，就定義了一個變數$(prefix),表示安裝的路徑，如果沒有指定安裝的路徑，會被安裝到預設的路徑，一般都是/usr/local。在定義$(prefix)，還有一些預定義好的目錄,其實這一些定義都可以在頂層的Makefile檔案中可以看到，如下面一些值：

bindir = $(prefix)/bin。

libdir = $(prefix)/lib。

datadir=$(prefix)/share。

sysconfdir=$(prefix)/etc。

includedir=$(prefix)/include。

這些量還可以用於定義其它目錄，例如我想將client.h安裝到include/client目錄下，這樣寫Makefile.am檔案：

1. clientincludedir=$(includedir)/client  
2. clientinclude_HEADERS=$(top_srcdir)/client/client.h  

<span style="font-size:12px;">clientincludedir=$(includedir)/client
clientinclude_HEADERS=$(top_srcdir)/client/client.h</span>

我們自己也可以定義新的安裝目錄下的路徑，如我在應用中簡單定義的：

1. devicedir = ${prefix}/device  
2. device_DATA = package  

<span style="font-size:12px;">devicedir = ${prefix}/device
device_DATA = package</span>

二，靜態庫檔案

編譯靜態庫和編譯動態庫是不一樣的，我們先看靜態庫的例子，這個比較簡單。直接指定 XXXX_LTLIBRARIES或者XXXX_LIBRARIES就可以了。如果不需要安裝到系統，將XXXX換成noinst就可以。還是再羅嗦一下：

• 一般推薦使用libtool庫編譯目標，因為automake包含libtool，這對於跨平臺可移植的庫來說，肯定是一個福音。

看例子如下：

1. noinst_LTLIBRARIES = libutil.la  
2. noinst_HEADERS = inaddr.h util.h compat.h pool.h xhash.h url.h device.h   
3. libutil_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  
4. libutil_la_LIBADD = @[email protected]  

<span style="font-size:12px;">noinst_LTLIBRARIES = libutil.la

noinst_HEADERS = inaddr.h util.h compat.h pool.h xhash.h url.h device.h 

libutil_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

libutil_la_LIBADD = @[email protected]
</span>

注意：靜態庫編譯連線時需要其它的庫的話，採用XXXX_LIBADD選項，而不是前面的XXXX_LDADD。編譯靜態庫是比較簡單的，因為直接可以指定其型別。

三，動態庫檔案

想要編譯XXX.so檔案，需要用_PROGRAMS型別，這裡一個關於安裝路徑要注意的問題是，我們一般希望將動態庫安裝到lib目錄下，按照前面所討論的，只需要寫成lib_PROGRAMS就可以了，因為前面的lib表示安裝路徑，但是automake不允許這麼直接定義，可以採用下面的辦法，也是將動態庫安裝到lib目錄下

1. projectlibdir=$(libdir) //新建一個目錄，就是該目錄就是lib目錄
2. projectlib_PROGRAMS=project.so  
3. project_so_SOURCES=xxx.C  
4. project_so_LDFLAGS=-shared -fpic //GCC編譯動態庫的選項

<span style="font-size:12px;">projectlibdir=$(libdir) //新建一個目錄，就是該目錄就是lib目錄
projectlib_PROGRAMS=project.so
project_so_SOURCES=xxx.C
project_so_LDFLAGS=-shared -fpic //GCC編譯動態庫的選項</span>

四，SUBDIRS的用法

這是一個很重要的關鍵詞，我們前面生成了一個一個的目標檔案，但是一個大型的工程專案是由許多個可執行檔案和庫檔案組成，也就是包含多個目錄，每個目錄下都有用於生成該目錄下的目標檔案的Makefile.am檔案，但頂層目錄是如何呼叫，才能使下面各個目錄分別生成自己的目標檔案呢？就是SUBDIRS關鍵詞的用法了。

看一下我的工程專案，這是頂層的Makefile.am檔案

1. EXTRA_DIST = Doxyfile.in README.win32 README.protocol contrib UPGRADE  
2. devicedir = ${prefix}/device  
3. device_DATA = package  
4. SUBDIRS = etc man  
5. if USE_LIBSUBST  
6. SUBDIRS += subst  
7. endif  
8. SUBDIRS += tools io sessions util client dispatch server hash storage sms  

<span style="font-size:12px;">EXTRA_DIST = Doxyfile.in README.win32 README.protocol contrib UPGRADE

devicedir = ${prefix}/device
device_DATA = package

SUBDIRS = etc man
if USE_LIBSUBST
SUBDIRS += subst
endif
SUBDIRS += tools io sessions util client dispatch server hash storage sms</span>

EXTRA_DIST：將哪些檔案一起打包。

五，關於打包

Automake會自動的打包，自動打包的內容如下：

1. 所有原始檔。
2. 所有的Makefile.am檔案。
3. configure讀取的檔案。
4. Makefile.am中包含的檔案。
5. EXTRA_DIST指定的檔案。
   
6. 採用dist及nodist指定的檔案，如可以將某一原始檔指定為不打包：
   nodist_client_SOURCES = client.c