（转帖整理）Linux下的Autoconf和AutoMake(理论篇) 1

在搜索网上资料过程中，这是感觉最简洁有效的一篇文章，特进行转帖记录，并根据情况对部分内容进行了修改。
原帖传送门：Linux下的Autoconf和AutoMake

1、工具安装
在开始使用autoconf和automake之前，首先确认你的系统安装有GNU的如下软件： automake/autoconf/m4/perl。
如果你需要产生共享库（shared library）则还需要GNU Libtool。
如果使用RedHat的Linux版本，这几个工具会自动安装，我试验中用SUSE11也安装了所有程序。
(可以对每个软件查询版本号来确认是否已经进行了安装)

①autoconf：是一个shell脚本的工具，可以自动地配置软件源代码包以适应多种UNIX类系统。
由autoconf生成的配置脚本在运行的时候不需要用户的手工干预；通常它们甚至不需要手工给出参数以确定系统的类型。
其中autoconf需要用到m4，便于生成脚本。

②automake：是一个从文件Makefile.am自动生成Makefile.in的工具。每个Makefile.am基本上是一系列make的宏定义。生成的Makefile.in，服从GNU Makefile标准。
为了生成Makefile.in，automake还需用到perl（它本身就是一个perl程序）。

2、使用流程(此图完美分解了整个流程！)

①由你的源文件通过autoscan命令，生成configure.scan文件，然后修改configure.scan文件并重命名为configure.in。
configure.in文件的内容是一些宏，这些宏经过autoconf 处理后会变成检查系统特性、环境变量、软件必须的参数的shell脚本。
configure.in文件中的宏的顺序并没有规定，但是你必须在所有宏的最前面和最后面分别加上AC_INIT宏和AC_OUTPUT宏。
(在AC_INIT之前还可以有AC_PREREQ宏，表示autoconf的版本要求)

②由aclocal命令，从configure.in生成aclocal.m4

③由autoconf命令，生成configure

④编辑各个Makefile.am文件，并由automake —-add-missing 命令生成Makefile.in文件

⑤运行configure命令，从Makefile.in文件生成Makefile

⑥运行make命令，生成文件

4、如何编写makefile.am文件
在makefile.am档中需要定义要产生的目标，具体包括：
①AUTOMAKE_OPTIONS：设定automake的选项。automake主要是帮助开发GNU软件的人员维护软件套件，一般在执行automake时会检查目录下是否存在标准GNU套件中应具备的文件档案，例如NEWS、AUTHOR、ChangeLog等，设成foreign时，automake会改用一般软件套件标准来检查，而gnu是缺省设置，该级别下将尽可能地检查包是否服从GNU标准，gnits是严格标准，不推荐。
②bin_PROGRAMS：定义要产生执行档的名称(也就是生成文件的名称)。产生多个执行档的话，需要用空格符隔开。
③hello_SOURCES：定义hello这个执行档的源文件(这个hello前缀根据具体项目生成文件名称确定)，如果该程序由多个原始档产生，必须把所用到的原始档都列出来，空格符隔开，例如hello_SOURCES = hello.c main.c hello.h(列出所有的头文件和源文件)。如果定义了多个执行档，则对每个执行档都要定义相对的filename_SOURCES。

举例：
④
noinst_LIBRARIES=libhello.a #第一行noinst 表示生成的是静态库。如果要把静态库生成到其他地方，可以在=后面加上路径。
libhello_a_SOURCES=test.c #第二行表示用来生成静态库的源文件。
AUTOMAKE_OPTIONS=foreign #第三行AUTOMAKE_OPTIONS 是Automake 的选项。

⑤
AUTOMAKE_OPTIONS=foreign
lib_LTLIBRARIES=libhello.la #这里用la就表示是生成动态库了
libhello_la_SOURCES=test.c

⑥
AUTOMAKE_OPTIONS=foreign
INCLUDES= -I../include #第二行指定头文件的位置，-I 是idirafter 的缩写。
bin_PROGRAMS=hello #第三行指定生成可执行文件名hello，在这里可执行文件生成在src 下
hello_SOURCES=hello.c #第四行指定生成可执行文件hello 的源代码文件
hello_LDADD=../lib/libhello.a #第五行指定需要使用静态库的位置。

备注说明第三行：
如需要把可执行文件生成到/root/test 目录下，则写法为：bin_PROGRAMS=/root/test/hello
后面的第四、五行也相对应地变为：
_root_test_hello_SOURCES=hello.c
_root_test_hello_LDADD=../lib/libhello.a

5、产生的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 发展环境的人去重新编译。

6、其他
其它有关开发 GNU 程序或 C 程序设计及 Makefile 的详细运用及技巧，建议从 GNU Coding Standards3 (GNU 编码标准规定) 读起，里面包含了 GNU Makefile 惯例，还有发展 GNU 软体套件的标准程序和惯例。这些 GNU 软体的线上说明文件可以在 http://www.gnu.org/ 这个网站上找到。

《CentOS下的Autoconf和AutoMake(实践篇) 2》

《CentOS下的Autoconf和AutoMake(完善篇) 3》