Autoconf、automake工具组使用简单介绍
Autoconf、automake工具组是Unix/Linux下编译大型项目的有力工具。使用它们可以省去我们手工编写makefile文件的麻烦,而且还能提高可靠性和项目移植性。在这里简单介绍automake工具组的使用。
以大家都熟知的helloworld为例,首先建立专门的目录,如helloworld,
$ mkdir helloworld
$ cd helloworld/
$ vi helloworld.c
1 #include<stdio.h>
2 int main()
3 {
4 printf("Hello,World!\n");
5 return 0;
6 }
运行autoscan:
$ autoscan
$ ls
autoscan.log configure.scan helloworld.c
$ vi configure.scan
1 # -*- Autoconf -*-
2 # Process this file with autoconf to produce a configure script.
3
4 AC_PREREQ([2.63]) //autoconf版本号
5 AC_INIT([FULL-PACKAGE-NAME], [VERSION], [BUG-REPORT-ADDRESS]) //软件名称、版本和提交bug报告的邮箱等信息
6 AC_CONFIG_SRCDIR([helloworld.c]) //侦测指定的源码文件文件是否存在,来确定源码目录的有效性。此处为当前目录下的helloworld.c
7 AC_CONFIG_HEADERS([config.h]) //用以生成config.h文件,以便autoheader使用
8
9 # Checks for programs.
10 AC_PROG_CC //指定编译器,默认指定gcc
11
12 # Checks for libraries.
13
14 # Checks for header files.
15
16 # Checks for typedefs, structures, and compiler characteristics.
17
18 # Checks for library functions.
19
20 AC_OUTPUT //用来设定configure所要产生的文件,如果是makefile,configure会把它检查出来的结果带入makefile.in文件,产生合适的makefile。
configure.scan似乎只是个模板,还要根据自己的情况填写修改相应内容。修改后的内容为:
1 # -*- Autoconf -*-
2 # Process this file with autoconf to produce a configure script.
3
4 AC_PREREQ([2.63])
5 AC_INIT(helloworld, 1.0)
6 AC_CONFIG_SRCDIR(helloworld.c)
7 AC_CONFIG_HEADERS(config.h)
8 AM_INIT_AUTOMAKE(helloworld,1.0) //添加该宏用于automake,参数分别是程序的名字和版本
9
10 # Checks for programs.
11 AC_PROG_CC
12
13 # Checks for libraries.
14
15 # Checks for header files.
16
17 # Checks for typedefs, structures, and compiler characteristics.
18
19 # Checks for library functions.
20
21 AC_OUTPUT(Makefile)
修改configure.scan的名字为configure.in:
$ mv configure.scan configure.in
$ ls
autoscan.log configure.in helloworld.c
有的文章是改为configure.ac,可能是automake工具组不同版本的问题吧。
之后运行autoheader命令:
$ autoheader
ll
总计 20
drwxr-xr-x 2 zhl zhl 4096 09-23 23:17 autom4te.cache
-rw-rw-r-- 1 zhl zhl 0 09-23 22:37 autoscan.log
-rw-rw-r-- 1 zhl zhl 471 09-23 23:17 config.h.in
-rw-rw-r-- 1 zhl zhl 474 09-23 23:08 configure.in
-rw-rw-r-- 1 zhl zhl 71 09-23 22:36 helloworld.c
-rw-rw-r-- 1 zhl zhl 79 09-23 23:12 Makefile.am
接着,创建Makefile.am文件,为生成Makefile.in文件做准备:
$ vi Makefile.am
1 AUTOMAKE_OPTIONS=foreign
2 bin_PROGRAMS=helloworld
3 helloworld_SOURCES=helloworld.c
其中:
1、 AUTOMAKE_OPTIONS为设置automake的选项。GNU对自己发布的软件有严格的规范,比如必须附带许可证声明文件COPYING等,否则automake执行时会报错。automake提供了3种软件等级:foreign、gnu和gnits,供用户选择,默认等级为gnu。本例使用foreign等级,它只检测必须的文件。
2、 bin_PROGRAMS定义要产生的执行文件名。如果要产生多个执行文件,每个文件名用空格隔开。
3、 helloworld_SOURCES定义“helloworld”这个执行程序所需要的原始文件。如果“helloworld”这个程序是由多个原始文件所产生的,则必须把它用到的所有原始文件都列出来,并用空格隔开。例如:若目标体“helloworld”需要“helloworld.c”、“helloworld.h”两个依赖文件,则定义helloworld_SOURCES=helloworld.c helloworld.h。
继续运行aclocal命令:
$ aclocal
$ ls
aclocal.m4 autoscan.log configure.in Makefile.am
autom4te.cache config.h.in helloworld.c
运行autoconf命令:
$ autoconf
$ ls
aclocal.m4 autoscan.log configure helloworld.c
autom4te.cache config.h.in configure.in Makefile.am
使用automake命令生成Makefile.in文件,使用选项“—add-missing”可以让automake自动添加一些必需的脚本文件。
$ automake --add-missing
configure.in:8: installing `./install-sh'
configure.in:8: installing `./missing'
$ ls
aclocal.m4 autoscan.log configure helloworld.c Makefile.am missing
autom4te.cache config.h.in configure.in install-sh Makefile.in
此时,运行自动配置文件configure,就可以把Makefile.in变成最终的Makefile文件了。
$ ./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 for C compiler default output file name... a.out
checking whether the C compiler works... yes
checking whether we are cross compiling... no
checking for suffix of executables...
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... none
configure: creating ./config.status
config.status: creating Makefile
config.status: creating config.h
config.status: executing depfiles commands
$ ls
aclocal.m4 config.h config.status helloworld.c Makefile.am stamp-h1
autom4te.cache config.h.in configure install-sh Makefile.in
autoscan.log config.log configure.in Makefile missing
可以看到Makefile文件已经产生出来了,之后就可以使用方便的使用make命令了。
$ make
make all-am
make[1]: Entering directory `/home/zhl/pthread/helloworld'
gcc -DHAVE_CONFIG_H -I. -g -O2 -MT helloworld.o -MD -MP -MF .deps/helloworld.Tpo -c -o helloworld.o helloworld.c
mv -f .deps/helloworld.Tpo .deps/helloworld.Po
gcc -g -O2 -o helloworld helloworld.o
make[1]: Leaving directory `/home/zhl/pthread/helloworld'
$ ls
aclocal.m4 config.h.in configure helloworld install-sh Makefile.in
autom4te.cache config.log configure.in helloworld.c Makefile missing
config.h config.status depcomp helloworld.o Makefile.am stamp-h1
可以看到已经生成可执行文件helloworld。
另外,我们还可以执行以下符合GNU Makefile惯例的Makefile预定义操作:
make clean:清除上次的make命令所产生的object文件(后缀为“.o”的文件)及可执行的文件。
make install:将编译成功的可执行文件安装到系统目录中,一般为/usr/local/bin目录。
make dist:产生发布软件包文件(即distribution package)。这个命令将会将可执行文件及相关文件打包成一个tar.gz压缩的文件用来作为发布软件的软件包。
它会在当前目录下生成一个名字类似“PACKAGE-VERSION.tar.gz”的文件。PACKAGE和VERSION,是我们在configure.in中定义的AM_INIT_AUTOMAKE(PACKAGE,VERSION)。
make distcheck:生成发布软件包并对其进行测试检查,以确定发布包的正确性。这个操作将自动把压缩包文件解开,然后执行configure命令,并且执行make来确定编译不出现错误,最后提示你软件包已经准备好,可以发布了。
make distclean:类似make clean,但同时也将configure生成的文件全部删除掉,包括Makefile。
总结:本文章只能算抛砖引玉,使大家对automake有个大致的了解。automake工具组的使用绝不仅仅这么简单,还有许多复杂的配置,需要查询更多的资料。上面的讲解中使用了好几个文件和命令,它们之间的关系可能一时难以搞清楚。所以用一幅图来表示它们之间的关系。