使用autotools建立Makefile简单实例解析

转自：http://blog.chinaunix.net/uid-9105154-id-2009272.html

本文中使用的实例仍为《手动建立makefile简单实例解析》中的5文件工程实例。

对于一个较大的项目而言，完全手动建立Makefile是一件费力而又容易出错的工作。autotools系列工具只需用户输入简单的目标文件、依赖文件、文件目录等就可以比较轻松地生成Makefile了。现在Linux上的软件开发一般都是用autotools来制作Makefile。

autotools工具主要有：aclocal、autoscan、autoconf、autoheader、automake。使用autotools主要就是利用各个工具的脚本文件来生成最后的Makefile。下面结合实例来介绍具体的流程。

第一步 autoscan

使用autoscan在给定目录及其子目录树中检查源文件，如果没有给出目录，就在当前目录及其子目录树中进行检查。最终生成两个文件：configure.scan、autoscan.log

[armlinux@lqm autotools - easy]$ tree
.
|-- main.c
|-- mytool1.c
|-- mytool1.h
|-- mytool2.c
` -- mytool2.h

0 directories, 5 files
[armlinux@lqm autotools - easy]$ autoscan
[armlinux@lqm autotools - easy]$ tree
.
|-- autoscan.log
|-- configure.scan
|-- main.c
|-- mytool1.c
|-- mytool1.h
|-- mytool2.c
` -- mytool2.h

0 directories, 7 files

其中，configure.scan是configure.in的原型文件。而configure.in是autoconf的脚本配置文件。所以下一步的工作就是要对configure.scan进行修改，将其转化为configure.in。

第二步   autoconf

configure.scan文件内容如下：

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

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

说明：

1、以“＃”号开始的是行为注释。
2、AC_PREREQ宏声明本文件要求的autoconf版本。
3、AC_INIT宏用来定义软件的名称和版本等信息，这里的BUG-REPORT-ADDRESS可以省略。
4、AC_CONFIG_SRCDIR宏用来侦测所指定的源码文件是否存在，来确定源码目录的有效性。这个参数一般不需要修改。
5、AC_CONFIG_HEADER宏用于生成config.h文件，以便autoheader使用。

修改时需要增加一个宏AM_INIT_AUTOMAKE(PACKAGE，VERSION)，还要把AC_CONFIG_HEADER更改为AM_CONFIG_HEADER。

AC_OUTPUT是输出文件，如果有多个目录需要产生Makefile如AC_OUTPUT(Makefile src/Makefile)

具体如下：

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

AC_PREREQ( 2.57 )
#AC_INIT(FULL - PACKAGE - NAME, VERSION, BUG - REPORT - ADDRESS)
AC_INIT(main, 1.0 )
AM_INIT_AUTOMAKE(main, 1.0 )
AC_CONFIG_SRCDIR([main.c])
AM_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.
AC_OUTPUT(Makefile)

第三步  autoheader

首先把configure.scan更改名称为configure.in。然后执行aclocal，autoconf，autoheader。

[armlinux@lqm autotools - easy]$ mv configure.scan configure. in
[armlinux@lqm autotools - easy]$ ls
autoscan.log  configure. in  main.c  mytool1.c  mytool1.h  mytool2.c  mytool2.h
[armlinux@lqm autotools - easy]$ aclocal
[armlinux@lqm autotools - easy]$ ls
aclocal.m4  autoscan.log  configure. in  main.c  mytool1.c  mytool1.h  mytool2.c  mytool2.h
[armlinux@lqm autotools - easy]$ autoconf
[armlinux@lqm autotools - easy]$ ls
aclocal.m4  autom4te.cache  autoscan.log  configure  configure. in  main.c  mytool1.c  mytool1.h  mytool2.c  mytool2.h
[armlinux@lqm autotools - easy]$ autoheader

第四步  automake

这是很重要的一步。automake需要的脚本配置文件是Makefile.am，这个文件需要自己建立。

AUTOMAKE_OPTIONS = foreign
bin_PROGRAMS = main
main_SOURCES = main.c mytool1.c mytool1.h mytool2.c mytool2.h

AUTOMAKE_OPTIONS为设置automake的选项。automake提供了3种软件等级：foreign、gnu、gnits，让用户选择使用，默认等级是gnu。现在使用的foreign只是检测必要的文件。

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

file_SOURCES定义file这个执行程序的依赖文件。同样的，对于多个执行文件，那就要定义相应的file_SOURCES。

接下来就是使用automake对其生成configure.in文件。这里可以使用选项--adding-missing让automake自动添加一些必要的脚本文件。

第五步  运行configure

[armlinux@lqm autotools - easy]$ automake -- add - missing
[armlinux@lqm autotools - easy]$ . / configure
checking for a BSD - compatible install... / usr / bin / install - c
checking whether build environment is sane... yes
checking for gawk... gawk
checking whether make sets $(MAKE)... yes
checking for gcc... gcc
checking for C compiler default output... 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 ANSI C... 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: config.h is unchanged
config.status: executing depfiles commands

这样就完成了Makefile的制作。这是具有的功能：make、make install、make uninstall、make clean、make distclean、make dist。

1、键入make默认执行make all。其目标体为all。

[armlinux@lqm autotools - easy]$ make
make  all - am
make[ 1 ]: Entering directory ` / home / armlinux / program / autotools - easy '
source = ' main.c ' object = ' main.o ' libtool = no
depfile = ' .deps/main.Po ' tmpdepfile = ' .deps/main.TPo '
depmode = gcc3 / bin / sh . / depcomp
gcc - DHAVE_CONFIG_H - I. - I. - I.     - g - O2 - c `test - f ' main.c ' || echo ' ./ ' `main.c
source = ' mytool1.c ' object = ' mytool1.o ' libtool = no
depfile = ' .deps/mytool1.Po ' tmpdepfile = ' .deps/mytool1.TPo '
depmode = gcc3 / bin / sh . / depcomp
gcc - DHAVE_CONFIG_H - I. - I. - I.     - g - O2 - c `test - f ' mytool1.c ' || echo ' ./ ' `mytool1.c
source = ' mytool2.c ' object = ' mytool2.o ' libtool = no
depfile = ' .deps/mytool2.Po ' tmpdepfile = ' .deps/mytool2.TPo '
depmode = gcc3 / bin / sh . / depcomp
gcc - DHAVE_CONFIG_H - I. - I. - I.     - g - O2 - c `test - f ' mytool2.c ' || echo ' ./ ' `mytool2.c
gcc   - g - O2   - o main  main.o mytool1.o mytool2.o  
make[ 1 ]: Leaving directory ` / home / armlinux / program / autotools - easy '

2、make install（uninstall）

3、make clean （distclean）

make clean仅仅是清除之前编译的可执行文件及配置文件。而make distclean要清除所有生成的文件。

[armlinux@lqm autotools - easy]$ make clean
test - z " main " || rm - f main
rm - f * .o core * .core
[armlinux@lqm autotools - easy]$ make distclean
test - z " main " || rm - f main
rm - f * .o core * .core
rm - f * .tab.c
rm - rf . / .deps
rm - f Makefile
rm - f config.h stamp - h1
rm - f TAGS ID GTAGS GRTAGS GSYMS GPATH
rm - f config.status config.cache config.log configure.lineno

4、make dist

将所有的程序和相关的文档打包为一个压缩文件以供发布。

[armlinux@lqm autotools - easy]$ make dist
{ test ! - d main - 1.0 || { find main - 1.0 - type d ! - perm - 200 - exec chmod u + w {} ' ; ' && rm - fr main - 1.0 ; }; }
mkdir main - 1.0
find main - 1.0 - type d ! - perm - 777 - exec chmod a + rwx {} ; - o
! - type d ! - perm - 444 - links 1 - exec chmod a + r {} ; - o
! - type d ! - perm - 400 - exec chmod a + r {} ; - o
! - type d ! - perm - 444 - exec / bin / sh / home / armlinux / program / autotools - easy / install - sh - c - m a + r {} {} ;
|| chmod - R a + r main - 1.0
/ bin / sh / home / armlinux / program / autotools - easy / missing -- run tar chof - main - 1.0 | GZIP =-- best gzip - c > main - 1.0 .tar.gz
{ test ! - d main - 1.0 || { find main - 1.0 - type d ! - perm - 200 - exec chmod u + w {} ' ; ' && rm - fr main - 1.0 ; }; }
[armlinux@lqm autotools - easy]$ ls
aclocal.m4      config.h     config.status  depcomp     main - 1.0 .tar.gz  Makefile     missing        mytool1.h  mytool2.h
autom4te.cache  config.h. in  configure      install - sh  main.c           Makefile.am  mkinstalldirs  mytool1.o  mytool2.o
autoscan.log    config.log   configure. in   main        main.o           Makefile. in  mytool1.c      mytool2.c  stamp - h1