automake

[GNU 的软件风格]
一个标准的 GNU 软件，编译安装都是使用下面三个步骤:

$ ./configure
$ make
$ make install

configure 脚本运行时可以侦测系统的环境，确定软件安装目录，然后生成 Makefile 文
件make 调用系统中的编译器进行编译和连接make install 将软件安装到设定的目录

用户执行 configure 时可以通过它的命令行参数指定自己所需的编译选项，比如安装目录
通过 --prefix=PREFIX 设置，如果不指定，缺省情况下 PREFIX 是 /usr/local默认安
装时，执行文件安装到 /usr/local/bin 目录，库安装到 /usr/local/lib 目录，数据文
件安装到 /usr/local/share 目录

由于 GNU 的软件风格方便易用，通用性好，可移植性高，现在大多数 Unix/Linux 系统上
的自由软件都采用这种方式分发软件

[准备 autotools]

autotools是个系列工具，首先确认你的Ubuntu系统是否安装了以下工具（可以通过which命令查看）：

    aclocal
    autoscan
    autoconf
    autoheader
    automake

  安装方法：
       root@ubuntu:~# sudo apt-get install autoconf

[第一步]
在~/work/test目录下创建一个文件main.c,其内容如下：
------------------------------------------------
#include <stdio.h>
int main(int argc, char** argv)

{
    printf("Hello, Auto Makefile!\n");
    return 0;
}
------------------------------------------------
此时状态如下：
zhouxiang@workpc1:~/work/test$ ls
main.c
zhouxiang@workpc1:~/work/test$

[第二步]
运行autoscan, 自动创建两个文件： autoscan.log configure.scan
此时状态如下：
zhouxiang@workpc1:~/work/test$ autoscan
zhouxiang@workpc1:~/work/test$ ls
autoscan.log  configure.scan  main.c
zhouxiang@workpc1:~/work/test$

[第三步]
修改configure.scan的文件名为configure.ac，查看configure.ac的内容：
------------------------------------------------
#                                               -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.

AC_PREREQ([2.69])
AC_INIT([FULL-PACKAGE-NAME], [VERSION], [BUG-REPORT-ADDRESS])
AC_CONFIG_SRCDIR([main.c])
AC_CONFIG_HEADERS([config.h])

# Checks for programs.
AC_PROG_CC

# Checks for libraries.

# Checks for header files.

# Checks for typedefs, structures, and compiler characteristics.

# Checks for library functions.

AC_OUTPUT
------------------------------------------------

解读以上的文件：
# 确保使用的是足够新的Autoconf版本。如果用于创建configure的Autoconf的版
# 本比version 要早，就在标准错误输出打印一条错误消息并不会创建configure。
AC_PREREQ([2.69])

#
# 初始化,定义软件的基本信息,包括设置包的全称,版本号以及报告BUG时需要用的邮箱地址
#
AC_INIT(FULL-PACKAGE-NAME, VERSION, BUG-REPORT-ADDRESS)

#
# 用来侦测所指定的源码文件是否存在，来确定源码目录的有效性
#
AC_CONFIG_SRCDIR([main.c])

#
# 用于生成config.h文件，以便autoheader使用
#
AC_CONFIG_HEADER([config.h])

# Checks for programs.

AC_PROG_CC

# Checks for libraries.

# Checks for header files.

# Checks for typedefs, structures, and compiler characteristics.

# Checks for library functions.

#
# 创建输出文件。在`configure.ac'的末尾调用本宏一次。
#
AC_OUTPUT


修改动作:

    1.修改AC_INIT里面的参数:
    2.添加宏AM_INIT_AUTOMAKE, 它是automake所必备的宏，也同前面一样，PACKAGE是所要产生软件套件的名称，VERSION是版本编号。
    3.在AC_OUTPUT后添加输出文件Makefile

修改后的结果:
------------------------------------------------
#                                               -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.

AC_PREREQ([2.69])
AC_INIT(main, 1.0, zhouxiang@163.com)
AC_CONFIG_SRCDIR([main.c])
AC_CONFIG_HEADERS([config.h])

AM_INIT_AUTOMAKE(main,1.0)

# Checks for programs.
AC_PROG_CC

# Checks for libraries.

# Checks for header files.

# Checks for typedefs, structures, and compiler characteristics.

# Checks for library functions.
AC_OUTPUT([Makefile])
------------------------------------------------

[第四步]
运行aclocal, 生成一个“aclocal.m4”文件和一个缓冲文件夹autom4te.cache，该文件主要处理本地的宏定义。
此时的状态是：
zhouxiang@workpc1:~/work/test$ aclocal
zhouxiang@workpc1:~/work/test$ ls
aclocal.m4  autom4te.cache  autoscan.log  configure.ac  main.c
zhouxiang@workpc1:~/work/test$

[第五步]
运行autoconf, 目的是生成 configure
此时的状态是：
zhouxiang@workpc1:~/work/test$ autoconf
zhouxiang@workpc1:~/work/test$ ls
aclocal.m4  autom4te.cache  autoscan.log  configure  configure.ac  main.c
zhouxiang@workpc1:~/work/test$

[第六步]
运行autoheader，它负责生成config.h.in文件。该工具通常会从“acconfig.h”文件中复制用户附加的符号定义，因此此处没有附加符号定义，所以不需要创建“acconfig.h”文件。
此时的状态是：
zhouxiang@workpc1:~/work/test$ autoheader
zhouxiang@workpc1:~/work/test$ ls
aclocal.m4  autom4te.cache  autoscan.log  config.h.in  configure  configure.ac  main.c
zhouxiang@workpc1:~/work/test$


[第七步]
下面即将运行automake, 但在此之前应该做一下准备工作!

首先
创建一个Makefile.am.这一步是创建Makefile很重要的一步，automake要用的脚本配置文件是Makefile.am，用户需要自己创建相应的文件。之后，automake工具转换成Makefile.in。

这个Makefile.am的内容如下：
------------------------------------------------
AUTOMAKE_OPTIONS=foreign
bin_PROGRAMS=main
main_SOURCES=main.c
------------------------------------------------

下面对该脚本文件的对应项进行解释。

    其中的AUTOMAKE_OPTIONS为设置automake的选项。由于GNU对自己发布的软件有严格的规范，比如必须附带许可证声明文件COPYING等，否则automake执行时会报错。automake提供了三种软件等级：foreign、gnu和gnits，让用户选择采用，默认等级为gnu。在本例使用foreign等级，它只检测必须的文件。

    bin_PROGRAMS定义要产生的执行文件名。如果要产生多个执行文件，每个文件名用空格隔开。

    main_SOURCES定义“main”这个执行程序所需要的原始文件。如果”main”这个程序是由多个原始文件所产生的，则必须把它所用到的所有原 始文件都列出来，并用空格隔开。例如：若目标体“main”需要“main.c”、“sunq.c”、“main.h”三个依赖文件，则定义 main_SOURCES=main.c sunq.c main.h。要注意的是，如果要定义多个执行文件，则对每个执行程序都要定义相应的file_SOURCES。

其次
使用automake对其生成“configure.in”文件，在这里使用选项“—adding-missing”可以让automake自动添加有一些必需的脚本文件。

zhouxiang@workpc1:~/work/test$ automake --add-missing
configure.ac:8: warning: AM_INIT_AUTOMAKE: two- and three-arguments forms are deprecated.  For more info, see:
configure.ac:8: http://www.gnu.org/software/automake/manual/automake.html#Modernize-AM_005fINIT_005fAUTOMAKE-invocation
configure.ac:11: installing './compile'
configure.ac:8: installing './install-sh'
configure.ac:8: installing './missing'
Makefile.am: installing './depcomp'
zhouxiang@workpc1:~/work/test$ ls
aclocal.m4      autoscan.log  config.h.in  configure.ac  install-sh  Makefile.am  missing
autom4te.cache  compile       configure    depcomp       main.c      Makefile.in
zhouxiang@workpc1:~/work/test$

[第八步]
运行configure，在这一步中，通过运行自动配置设置文件configure，把Makefile.in变成了最终的Makefile。
运行的结果如下：
zhouxiang@workpc1:~/work/test$ ./configure
checking for a BSD-compatible install... /usr/bin/install -c
checking whether build environment is sane... yes
checking for a thread-safe mkdir -p... /bin/mkdir -p
checking for gawk... no
checking for mawk... mawk
checking whether make sets $(MAKE)... yes
checking whether make supports nested variables... yes
checking for gcc... gcc
checking whether the C compiler works... yes
checking for C compiler default output file name... a.out
checking for suffix of executables...
checking whether we are cross compiling... no
checking for suffix of object files... o
checking whether we are using the GNU C compiler... yes
checking whether gcc accepts -g... yes
checking for gcc option to accept ISO C89... none needed
checking whether gcc understands -c and -o together... yes
checking for style of include used by make... GNU
checking dependency style of gcc... gcc3
checking that generated files are newer than configure... done
configure: creating ./config.status
config.status: creating Makefile
config.status: creating config.h
config.status: executing depfiles commands
zhouxiang@workpc1:~/work/test$ ls
aclocal.m4      autoscan.log  config.h     config.log     configure     depcomp     main.c    Makefile.am  missing
autom4te.cache  compile       config.h.in  config.status  configure.ac  install-sh  Makefile  Makefile.in  stamp-h1
zhouxiang@workpc1:~/work/test$

[第九步]
运行make，对配置文件Makefile进行测试一下
此时的状态如下:
zhouxiang@workpc1:~/work/test$ make
make  all-am
make[1]: 正在进入目录 `/home/zhouxiang/work/test'
gcc -DHAVE_CONFIG_H -I.     -g -O2 -MT main.o -MD -MP -MF .deps/main.Tpo -c -o main.o main.c
mv -f .deps/main.Tpo .deps/main.Po
gcc  -g -O2   -o main main.o  
make[1]:正在离开目录 `/home/zhouxiang/work/test'
zhouxiang@workpc1:~/work/test$ ls
aclocal.m4      autoscan.log  config.h     config.log     configure     depcomp     main    main.o    Makefile.am  missing
autom4te.cache  compile       config.h.in  config.status  configure.ac  install-sh  main.c  Makefile  Makefile.in  stamp-h1
zhouxiang@workpc1:~/work/test$

[第十步]
运行生成的文件main：
zhouxiang@workpc1:~/work/test$ ./main
Hello, Auto Makefile!
zhouxiang@workpc1:~/work/test$