automake的理解和实践总结

automake的背景和作用：一般情况下我们在做一个项目时需要编写一份Makefile文件来对整个项目的文件进行编译生成可执行文件，但是一般这样编写Makefile文件会相对比较复杂而且会存在不同编译环境时需要对Makefile文件做相应的修改。为了解决这个问题，所以就引入了automake。对于automake，用户只是需要编译和配置一些参数就可以了，其它所有的操作都可以通过automake的一系列命令来实现。

automake生成Makefile文件所需的工具：GUN Automake、GNU Autoconf、GNU m4、PERL、GNU Libtool

automake生成Makefile文件所需的文件：需要编译的源文件、configure.ac或者configure.in、Makefile.am

下图是我对整个automake过程理解整理的一张流程图，详细的描述了整个执行过程、所需要的文件和输出文件。

下面通过来详细说明每一步操作：

1、创建需要编译的源文件hello.c：

#include <stdio.h>

int main(void)
{
        printf("Test automake.\n");

        return 0;
}

2、准备automake所需要的文件configure.ac或者configure.in（两个文件的格式都是一样的知识命名不同），这个过程可以完全手动编写也可以通过aotoscan的帮助生成configure.scan文件，然后在configure.scan的文件基础上更改并命名为configure.ac或者configure.in。

autoscan会扫描源代码以搜寻普通的可移植性问题，比如检查编译器、库、头文件等，生成文件configure.scan，它是configure.ac或者configure.in的雏形。

执行autoscan：

configure.scan内容解释：

3、编辑configure.scan并命名为configure.in：

修改后的文档如下：

4、aclocal 是一个perl 脚本程序。aclocal 根据configure.in 文件的内容，自动生成aclocal.m4 和autom4te.cache文件。但是使用configure.in时会提示一个warning，为避免这个warning可以命名为configure.ac。

下面是以configure.in命令的结果：

下面则是以configure.ac命名的结果：

5、autoheader是创建configure头文件模板的操作，这一步执不执行与在configure.ac/configure.in中是否定义AC_CONFIG_HEADERS([config.h])有关，如果没有定义就不需要执行，如果定义了就一定需要执行。

如果没有定义AC_CONFIG_HEADERS([config.h])而执行的结果：

如果定义了AC_CONFIG_HEADERS([config.h])但是没有执行的则会在automake时提示错误。

6、创建Makefile.am文件：

7、automake根据 configure.in 中和config.h.in中的宏把Makefile.am 转成 Makefile.in 文件。其中config.h.in文件是否需要与是否定义AC_CONFIG_HEADERS([config.h])有关，定义了则需要没定义则不需要。--add-missing选项是让automake自动添加一些必需的脚本文件。

如果定义了AC_CONFIG_HEADERS([config.h])而没有执行autoheader的话就会提示下面的错误：

8、autoconf：是用来产生configure 文件的。configure 是一个脚本，它能设置源程序来适应各种不同的操作系统平台，并且根据不同的系统来产生合适的Makefile ，从而可以使你的源代码能在不同的操作系统平台上被编译出来。configure.in/configure.ac 文件的内容是一些宏，这些宏经过autoconf 处理后会变成检查系统特性、环境变量、软件必须的参数的shell 脚本。configure.in 文件中的宏的顺序并没有规定，但是你必须在所有宏的最前面和最后面分别加上AC_INIT 宏和AC_OUTPUT 宏。具体生成使需要依赖aclocal.m4、configure.ac/configure.in和config.h.in，其中config.h.in文件根据是否定义AC_CONFIG_HEADERS([config.h])有关。

下面是生成文件：

下面是缺少configure.ac的执行错误：

下面是缺少aclocal.m4的执行错误：

9、./configure：执行配置文件会依据Makefile.in和configure文件生成Makefile文件

但是我第一遍执行时出现了下面错误：

进过查找，原因是在AM_INIT_AUTOMAKE(hello, 1.0)前面存在空行导致的。

10、执行make和运行二进制文件

最后生成的Makefile文件支持的命令：

make:根据Makefile编译源代码，链接生成可执行文件

make clean:清除make生成的object文件和可执行文件

make dist：产生发布软件包文件（即distribution package ）。这个命令将会将可执行文件及相关文件打包成一个tar.gz 压缩的文件用来作为发布软件的软件包。

make install: 将编译成功的可执行文件安装到系统目录中，一般为/usr/local/bin 目录。

make distcheck: 生成发布软件包并对其进行测试检查，以确定发布包的正确性。这个操作将自动把压缩包文件解开，然后执行configure命令，并且执行make，来确认编译不出现错误，最后提示你软件包已经准备好，可以发布了。

make distclean：类似make clean ，但同时也将configure 生成的文件全部删除掉，包括Makefile 。