在较大项目中, 如果手动维护Makefile, 那将是一件复杂并痛苦的事情. 那么, 有没有一种轻松的手段生成Makefile呢? autotools系列工具正是在这样的呼声中诞生的. 它只需用户输入简单的目标文件, 依赖文件, 文件目录等就可以轻松地生成Makefile了. 另外, 这些工具还可以完成系统配置信息的收集, 从而可以方便地处理各种移植性问题.


autotools是系列工具, 它含有:

  • aclocal
  • autoscan
  • autoconf
  • autoheader
  • automake

autotools 使用流程

下面用一个简单的hello.c程序, 演示autotools的使用流程. hello.c如下:

wangsheng@pc01:~/work/train/make/automake$ ls

hello.c
wangsheng@pc01:~/work/train/make/automake$ cat hello.c
#include
int main()
{
printf("Hello, autotools!/n");
return 0;
}

(1) 使用autoscan命令自动生成configure.scan文件

它会在给定目录及其子目录树中检查源文件, 若没有给出目录, 就在当前目录及其子目录树中进行检查.它会搜索源文件以寻找一般的移植性问题并创建一个文件”configure.scan”, 该文件就是接下来autoconf要用到的”configure.in”原型.

wangsheng@pc01:~/work/train/make/automake$ autoscan

wangsheng@pc01:~/work/train/make/automake$ ls
autoscan.log configure.scan hello.c

(2)将configure.scan重命名为configure.in, 并做适当修改
configure.scan的内容:

wangsheng@pc01:~/work/train/make/automake$ cat configure.scan

# -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.

AC_PREREQ([2.65])
AC_INIT([FULL-PACKAGE-NAME], [VERSION], [BUG-REPORT-ADDRESS])
AC_CONFIG_SRCDIR([hello.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

将configure.scan重命名为configure.in

wangsheng@pc01:~/work/train/make/automake$ mv configure.scan configure.in

根据具体情况, 适当修改, 以下加粗部分是修改的内容:

wangsheng@pc01:~/work/train/make/automake$ cat configure.in

# -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.

AC_PREREQ([2.65])
#AC_INIT([FULL-PACKAGE-NAME], [VERSION], [BUG-REPORT-ADDRESS])
AC_INIT(hello,1.0)
AM_INIT_AUTOMAKE(hello,1.0)

AC_CONFIG_SRCDIR([hello.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_CONFIG_FILES([Makefile])
AC_OUTPUT

说明:

  • 以”#”号开始的行为注释
  • AC_PREREQ宏声明本文要求的autoconf版本, 如本例中的版本 2.65
  • AC_INIT宏用来定义软件的名称和版本等信息, 在本例中省略了BUG-REPROT-ADDRESS, 一般为作者的E-mail
  • AM_INIT_AUTOMAKE是手动添加的, 它是automake所必备的宏, 也同前面一样, PACKAGE是所要产生软件套件的名称,VERSION是版本编号.
  • AC_CONFIG_SCRDIR宏用来侦测所指定的源码文件是否存在, 来确定源码目录的有效性. 在此处指当前目录下hello.c
  • AC_CONFIG_FILES宏用于生成相应的Makefile文件.

(3) 运行aclocal命令,生成”aclocal.m4″文件, 该文件主要处理本地的宏定义

wangsheng@pc01:~/work/train/make/automake$ aclocal

wangsheng@pc01:~/work/train/make/automake$ ls
aclocal.m4 autom4te.cache autoscan.log configure.in hello.c

(4) 运行autoconf命令生成configure可执行文件

wangsheng@pc01:~/work/train/make/automake$ autoconf

wangsheng@pc01:~/work/train/make/automake$ ls
aclocal.m4 autom4te.cache autoscan.log configure configure.in hello.c

(5) 运行autoheader命令, 生成config.h.in文件.
该工具通常会从”acconfig.h”文件中复制用户附加的符号定义. 本例中没有附加的符号定义, 所以不需要创建”acconfig.h”文件.

wangsheng@pc01:~/work/train/make/automake$ autoheader

wangsheng@pc01:~/work/train/make/automake$ ls
aclocal.m4 autom4te.cache autoscan.log config.h.in configure configure.in hello.c

(6) 运行automake命令, 生成Makefile.in文件
这一步是创建Makefile很重要的一步, automake要用的脚本配置文件是Makefile.am, 用户需要自己创建相应的文件. 之后, automake工具将自动转换成Makefile.in 本例中, 创建的文件为Makefile.am, 内容如下:

wangsheng@pc01:~/work/train/make/automake$ cat Makefile.am

AUTOMAKE_OPTIONS=foreign
bin_PROGRAMS=hello
hello_SOURCES=hello.c

说明:

  • 其中的AUTOMAKE_OPTIONS为设置automake的选项. 由于GNU对自己发布的软件有严格的规范, 比如必须附带许可证声明文件COPYING等, 否则automake执行时会报错. automake提供了3中软件等级:foreign, gnu和gnits, 供用户选择. 默认级别是gnu. 在本例中, 使用了foreign等级, 它只检测必须的文件.
  • bin_PROGRAMS定义要产生的执行文件名. 如果要产生多个执行文件, 每个文件名用空格隔开
  • hello_SOURCES 定义”hello”这个可执行程序所需的原始文件. 如果”hello”这个程序是由多个源文件所产生的, 则必须把它所用到的所有源文件都列出来, 并用空格隔开. 如果要定义多个可执行程序, 那么需要对每个可执行程序建立对应的file_SOURCES.

在这里使用”–add-missiing”选项可以让automake自动添加一些必须的脚本文件.

wangsheng@pc01:~/work/train/make/automake$ automake --add-missing

configure.in:7: installing `./install-sh'
configure.in:7: installing `./missing'
Makefile.am: installing `./depcomp'
wangsheng@pc01:~/work/train/make/automake$ ls
aclocal.m4 autoscan.log configure depcomp install-sh Makefile.in
autom4te.cache config.h.in configure.in hello.c Makefile.am missing

(7)运行configure, 生成Makfefile文件

wangsheng@pc01:~/work/train/make/automake$ ./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... gawk
checking whether make sets $(MAKE)... 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 for style of include used by make... GNU
checking dependency style of gcc... gcc3
configure: creating ./config.status
config.status: creating Makefile
config.status: creating config.h
config.status: executing depfiles commands
wangsheng@pc01:~/work/train/make/automake$ ls
aclocal.m4 config.h config.status depcomp Makefile missing
autom4te.cache config.h.in configure hello.c Makefile.am stamp-h1
autoscan.log config.log configure.in install-sh Makefile.in

autotools生成Makefile流程图如下:

使用由autotools生成的Makefile

autotools生成的Makefile具有以下主要功能:
(1) make

编译源程序, 键入make, 默认执行”make all”命令

wangsheng@pc01:~/work/train/make/automake$ make

make all-am
make[1]: Entering directory `/home/wangsheng/work/train/make/automake'
gcc -DHAVE_CONFIG_H -I. -g -O2 -MT hello.o -MD -MP -MF .deps/hello.Tpo -c -o hello.o hello.c
mv -f .deps/hello.Tpo .deps/hello.Po
gcc -g -O2 -o hello hello.o
make[1]: Leaving directory `/home/wangsheng/work/train/make/automake'

此时在本目录下就生成了可执行文件”hello”, 运行”./hello”就能看到程序的执行结果:

wangsheng@pc01:~/work/train/make/automake$ ./hello

Hello, autotools!

(2) make install
执行该命令, 可以把程序安装到系统目录中

wangsheng@pc01:~/work/train/make/automake$ sudo make install

此时, 直接在console输入hello, 就可以看到程序的运行结果

(3) make clean
清除之前所编译的可执行文件及目标文件

wangsheng@pc01:~/work/train/make/automake$ make clean

test -z "hello" || rm -f hello
rm -f *.o

(4) make dist
将程序和相关的文档打包为一个压缩文档以供发布

wangsheng@pc01:~/work/train/make/automake$ make dist

wangsheng@pc01:~/work/train/make/automake$ ls -l hello-1.0.tar.gz
hello-1.0.tar.gz

可见该命令生成了一个hello-1.0.tar.gz的压缩文档.