Makefile.am文件配置

Makefile.am

Makefile.am是一种比Makefile更高层次的编译规则，能够和configure.in文件一块儿经过调用automake命令，生成Makefile.in文件，再调用./configure的时候，就将Makefile.in文件自动生成Makefile文件了。因此Makefile.am文件是比Makefile文件更高的抽象。

下面我根据本身的工做中的一些应用，来讨论Makefile.am的编写。我以为主要是要注意的问题是将编译什么文件？这个文件会不会安装？这个文件被安装到什么目录下？能够将文件编译成可执行文件来安装，也能够编译成静态库文件安装，常见的文件编译类型有下面几种：

• PROGRAMS。表示可执行文件
• LIBRARIES。表示库文件
• LTLIBRARIES。这也是表示库文件，前面的LT表示libtool。
• HEADERS。头文件。
• SCRIPTS。脚本文件，这个能够被用于执行。如：example_SCRIPTS，若是用这样的话，须要咱们本身定义安装目录下的example目录，很容易的，往下看。
• DATA。数据文件，不能执行。

可执行文件

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可执行应用程序，引用了两个静态库和MC等动态库的链接。分析一下：

• bin_PROGRAMS：表示指定要生成的可执行应用程序文件，这表示可执行文件在安装时须要被安装到系统中，若是只是想编译。不想被安装到系统中，能够用noinst_PROGRAMS来代替。
  • bin_PROGRAMS=client 这一行表示什么意思？解释以下：
    • PROGRAMS知道这是一个可执行文件。
    • client表示编译的目标文件。
    • 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文件：

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

这就达到了个人目的，至关于定义了一个安装类型，这种安装类型是将文件安装到include/client目录下。
咱们本身也能够定义新的安装目录下的路径，如我在应用中简单定义的：

devicedir = ${prefix}/device  
device_DATA = package

这样的话，package文件会做为数据文件安装到device目录之下，这样一个可执行文件就定义好了。注意，这也至关于定义了一种安装类型：devicedir，因此你想怎么安装就怎么安装，后面的XXXXXdir，dir是固定不变的。

静态库文件

编译静态库和编译动态库是不同的，咱们先看静态库的例子，这个比较简单。直接指定 XXXX_LTLIBRARIES或者XXXX_LIBRARIES就能够了。若是不须要安装到系统，将XXXX换成noinst就能够。仍是再罗嗦一下：

通常推荐使用libtool库编译目标，由于automake包含libtool，这对于跨平台可移植的库来讲，确定是一个福音。
看例子以下：

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 = @LDFLAGS@

第一行的noinst_LTLIBRARIES，这里要注意的是LTLIBRARIES，另外还有LIBRARIES，两个都表示库文件。前者表示libtool库，用法上基本是同样的。若是须要安装到系统中的话，用lib_LTLIBRARIES。
注意：静态库编译链接时须要其它的库的话，采用XXXX_LIBADD选项，而不是前面的XXXX_LDADD。编译静态库是比较简单的，由于直接能够指定其类型。

动态库文件

想要编译XXX.so文件，须要用_PROGRAMS类型，这里一个关于安装路径要注意的问题是，咱们通常但愿将动态库安装到lib目录下，按照前面所讨论的，只须要写成lib_PROGRAMS就能够了，由于前面的lib表示安装路径，可是automake不容许这么直接定义，能够采用下面的办法，也是将动态库安装到lib目录下

projectlibdir=$(libdir) //新建一个目录，就是该目录就是lib目录  
projectlib_PROGRAMS=project.so  
project_so_SOURCES=xxx.C  
project_so_LDFLAGS=-shared -fpic //GCC编译动态库的选项

SUBDIRS的用法

这是一个很重要的关键词，咱们前面生成了一个一个的目标文件，可是一个大型的工程项目是由许多个可执行文件和库文件组成，也就是包含多个目录，每一个目录下都有用于生成该目录下的目标文件的Makefile.am文件，但顶层目录是如何调用，才能使下面各个目录分别生成本身的目标文件呢？就是SUBDIRS关键词的用法了。

看一下个人工程项目，这是顶层的Makefile.am文件

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

UBDIRS表示在处理目录以前，要递归处理哪些子目录，这里还要注意处理的顺序。好比个人client对sessions和utils这两上目标文件有依赖，就在client以前须要处理这两个目标文件。 EXTRA_DIST：将哪些文件一块儿打包。