欧美不卡视频一区,亚洲激情自拍,欧美高清成人

makefile info!

T.S Liu — Fri, 27 Jun 2008 16:05:00 GMT

Make工程��理�?br>到此为止�Q�读者已了解了如何在Linux下��用编辑器�~�写代码�Q�如何��用Gcc把代码编译成可执行文档，�q�学习了如何使用Gdb来调试程式，那么�Q��Q何的工作看似已完成了�Q��ؓ什么还需要Make�q�个工程��理器呢�Q?br>所谓工�E�管理器�Q�顾名思义�Q�是指管理较多的文档的。读者能够试想一下，有一个上百个文档的代码构成的��目�Q�假如其中只有一个或��数几个文档�q�行了修改，按照之前所学的Gcc�~�译工具�Q�就不得不把�q��Q何的文档重新�~�译一遍，因�ؓ�~�译器�ƈ不知道哪些文档是最�q�更新的�Q�而只知道需要包含这些文档才能把源代码编译成可执行文档，于是�Q�程式员��׃��能不再重新输入数目如此庞大的文档名以完成最后的�~�译工作�?br>但是�Q�请读者仔�l�回想一下本书在3.1.2�?br>中所阐述的编译过�E�，�~�译�q�程是分为编译、汇�~�、链接不同阶�D늚��Q�其中编译阶�D�仅��查语法错误连同函数和变量的声明是否正��声明了�Q�在链接阶段则主要完�?br>是函数链接和全局变量的链接。因此，那些没有改变的源代码�Ҏ��无需重新�~�译�Q�而只要把他们重新链接�q�去��p��够了。所以，��Z��希望有一个工�E�管理器能够
自动识别更新了的文档代码�Q�同时又无需重复输入冗长的命令行�Q�这��P��Make工程��理器也��应�q�而生了�?br>实际上，Make工程��理器也��是�?#8220;自动�~�译��理�?#8221;�Q�这里的“自动”是指他能够根据文档时间戳自动发现更新�q�的文档而减��编译的工作量，同时�Q�他通过��d��Makefile文档的内�Ҏ��执行大量的编译工作。用户只需�~�写一�ơ简单的�~�译语句��p��够了。他大大提高了实际项目的工作效率�Q�而且几乎��M��Linux下的��目�~�程均会涉及��C��Q�希望读者能够认真学习本节内宏V�?br>3.6.1  Makefile基本�l�构
Makefile是Make��d��的惟一配置文档�Q�因此本节的内容实际��是讲述Makefile的编写规则。在一个Makefile中通常包含如下内容�Q?br>·  需要由make工具创徏的目标体�Q�target�Q�，通常是目标文档或可执行文档；
·  要创建的目标体所依赖的文档（dependency_file�Q�；
·  创徏每个目标体时需要运行的命��o�Q�command�Q��?br>他的格式为：

target: dependency_files
   command

例如�Q�有两个文档分别为hello.c和hello.h�Q�创建的目标体�ؓhello.o�Q�执行的命��o为gcc�~�译指��o�Q�gcc –c hello.c�Q�那么，对应的Makefile��p��够写为：

#The simplest example
hello.o: hello.c hello.h
   gcc –c hello.c –o hello.o

接着��p��够��用make了。��用make的格式�ؓ�Q�make target�Q�这样make��׃��自动��d��Makefile�Q�也能够是首字母��写makefile�Q��ƈ执行对应target的command语句�Q��ƈ会找到相应的依赖文档。如下所�C�：

[root@localhost makefile]# make hello.o
gcc –c hello.c –o hello.o
[root@localhost makefile]# ls
hello.c  hello.h  hello.o  Makefile

能够看到�Q�Makefile执行�?#8220;hello.o”对应的命令语句，�q�生成了“hello.o”目标体�?br>
screen.width*0.7) {this.resized=true; this.width=screen.width*0.7; this.style.cursor='hand'; this.alt='Click here to open new window\nCTRL+Mouse wheel to zoom in/out';}" onclick="if(!this.resized) {return true;} else {window.open('http://book.csdn.net/BookFiles/132/03/image006.jpg');}" alt="" src="http://book.csdn.net/BookFiles/132/03/image006.jpg" onload="if(this.width>screen.width*0.7) {this.resized=true; this.width=screen.width*0.7; this.alt='Click here to open new window\nCTRL+Mouse wheel to zoom in/out';}" border=0>
注意
在Makefile中的每一个command前必��L��“Tab”�W�，否则在运行make命��o时会出错�?br>3.6.2  Makefile变量
上面�C�Z��的Makefile在实际中是几乎不存在的，因�ؓ他过于简单，仅包含两个文档和一个命令，在这�U�情况下完全不必要编写Makefile而只需在Shell中直接输入即可，在实际中使用的Makefile往往是包含很多的文档和命令的�Q�这也是Makefile产生的原因。下面就可给出稍微复杂一些的Makefile�q�行讲解�Q?br>
sunq:kang.o yul.o
Gcc kang.o bar.o -o myprog
kang.o : kang.c kang.h head.h
Gcc –Wall –O -g –c kang.c -o kang.o
yul.o : bar.c head.h
Gcc - Wall –O -g –c yul.c -o yul.o

在这个Makefile中有三个目标体（target�Q�，分别为sunq、kang.o和yul.o�Q�其中第一个目标体的依赖文档就是后两个目标体。假如用户��用命�?#8220;make sunq”�Q�则make��理器就是找到sunq目标体开始执行�?br>�q�时�Q�make会自动检查相��x��档的旉��戟뀂首先，在检�?#8220;kang.o”�?#8220;yul.o”�?#8220;sunq”三个文档的时间戳之前�Q�他会向下查��N��些把“kang.o”�?#8220;yul.o”做�ؓ目标文档的时间戳。比如，“kang.o”的依赖文档�ؓ�Q?#8220;kang.c”�?#8220;kang.h”�?#8220;head.h”。假如这些文档中��M��一个的旉��x��“kang.o”斎ͼ�则命�?#8220;gcc –Wall –O -g –c kang.c -o kang.o”��会执行�Q�从而更新文�?#8220;kang.o”。在更新�?#8220;kang.o”�?#8220;yul.o”之后�Q�make会检查最初的“kang.o”�?#8220;yul.o”�?#8220;sunq”三个文档�Q�只要文�?#8220;kang.o”�?#8220;yul.o”中的��L��文档旉��x��“sunq”斎ͼ�则第二行命��o��׃��被执行。这��P��make��完成了自动��查时间戳的工作，开始执行编译工作。这也就是Make工作的基本流�E��?br>接下来，��Z��q�一步简化编辑和�l�护Makefile�Q�make允许在Makefile中创建和使用变量。变量是在Makefile中定义的名字�Q�用来代替一个文本字�W�串�Q�该文本字符串称��变量的倹{��在具体需要下�Q�这些��D��够代替目标体、依赖文档、命令连同makefile文档中其他部分。在Makefile中的变量定义有两�U�方式：一�U�是递归展开方式�Q�另一�U�是��单方式�?br>递归展开方式定义的变量是在引用在该变量时�q�行替换的，卛_��如该变量包含了对其他变量的应用，则在引用该变量时一�ơ性将内嵌的变量全部展开�Q�虽然这�U�类型的变量能够很好地完成用��L��指��o�Q�但是他也有严重的缺点，如不能在变量后追加内容（因�ؓ语句�Q�CFLAGS = $(CFLAGS) -O在变量扩展过�E�中可能��D��无穷循环�Q��?br>��Z��避免上述问题�Q�简单扩展型变量的值在定义处展开�Q��ƈ且只展开一�ơ，因此他不包含��M��对其他变量的引用�Q�从而消除变量的嵌套引用�?br>递归展开方式的定义格式�ؓ�Q�VAR=var
��单扩展方式的定义格式为：VAR�Q?var
Make中的变量使用均��用格式�ؓ�Q?(VAR)

screen.width*0.7) {this.resized=true; this.width=screen.width*0.7; this.style.cursor='hand'; this.alt='Click here to open new window\nCTRL+Mouse wheel to zoom in/out';}" onclick="if(!this.resized) {return true;} else {window.open('http://book.csdn.net/BookFiles/132/03/image006.jpg');}" alt="" src="http://book.csdn.net/BookFiles/132/03/image006.jpg" onload="if(this.width>screen.width*0.7) {this.resized=true; this.width=screen.width*0.7; this.alt='Click here to open new window\nCTRL+Mouse wheel to zoom in/out';}" border=0>
注意
变量名是不包�?#8220;:”�?#8220;#”�?#8220;=”�l�尾�I�格的�Q何字�W�串。同�Ӟ��变量名中包含字母、数字连同下划线以外的情况应��量避免�Q�因��Z��们可能在��来被赋予特别的含义�?br>变量名是大小写敏感的�Q�例如变量名“foo”�?#8220;FOO”、和“Foo”代表不同的变量�?br>推荐在makefile内部使用��写字母作�ؓ变量名，预留大写字母作�ؓ控制隐含规则参数或用户重载命令选项参数的变量名�?br>
下面�l�出了上例中用变量替换修改后的Makefile�Q�这里用OBJS代替kang.o和yul.o�Q�用CC代替Gcc�Q�用CFLAGS代替“-Wall -O –g”。这样在以后修改�Ӟ��p��够只修改变量定义�Q�而无需修改下面的定义实体，从而大大简化了Makefile�l�护的工作量�?br>�l�变量替换后的Makefile如下所�C�：

OBJS = kang.o yul.o
CC = Gcc
CFLAGS = -Wall -O -g
sunq : $(OBJS)
   $(CC) $(OBJS) -o sunq
kang.o : kang.c kang.h
   $(CC) $(CFLAGS) -c kang.c -o kang.o
yul.o : yul.c yul.h
   $(CC) $(CFLAGS) -c yul.c -o yul.o

能够看到�Q�此处变量是以递归展开方式定义的�?br>Makefile中的变量分�ؓ用户自定义变量、预定义变量、自动变量及环境变量。如上例中的OBJS��是用户自定义变量，自定义变量的值由用户自行讑֮��Q�而预定义变量和自动变量�ؓ通常在Makefile都会出现的变量，其中部分有默认��|��也就是常见的讑֮��|��当然用户能够对其�q�行修改�?br>预定义变量包含了常见�~�译器、汇�~�器的名�U�及其编译选项。下�?.14列出了Makefile中常见预定义变量及其部分默认倹{�?br>�?.14                                                 Makefile中常见预定义变量
�?�?�?�?br>�?nbsp; �?br>AR
库文档维护程式的名称�Q�默认��gؓar
AS
汇编�E�式的名�U�ͼ�默认��gؓas
CC
C�~�译器的名称�Q�默认��gؓcc
CPP
C预编译器的名�U�ͼ�默认��gؓ$(CC) –E
CXX
C++�~�译器的名称�Q�默认��gؓg++
FC
FORTRAN�~�译器的名称�Q�默认��gؓf77
RM
文档删除�E�式的名�U�ͼ�默认��gؓrm –f
ARFLAGS
库文档维护程式的选项�Q�无默认�?br>ASFLAGS
汇编�E�式的选项�Q�无默认�?br>CFLAGS
C�~�译器的选项�Q�无默认�?br>CPPFLAGS
C预编译的选项�Q�无默认�?br>CXXFLAGS
C++�~�译器的选项�Q�无默认�?br>FFLAGS
FORTRAN�~�译器的选项�Q�无默认�?br>
能够看出�Q�上例中的CC和CFLAGS是预定义变量�Q�其中由于CC没有采用默认��|��因此�Q�需要把“CC=Gcc”明确列出来�?br>�׃��常见的Gcc�~�译语句中通常包含了目标文档和依赖文档�Q�而这些文档在Makefile文档中目标体的一行已有所体现�Q�因此，��Z��q�一步简化Makefile的编写，��引入了自动变量。自动变量通常能够代表�~�译语句中出现目标文档和依赖文档�{�，�q�且具备本地含义�Q�即下一语句中出现的相同变量代表的是下一语句的目标文档和依赖文档�Q�。下�?.15列出了Makefile中常见自动变量�?br>�?.15                                                 Makefile中常见自动变�?br>命��o格式
�?nbsp; �?br>$*
不包含扩展名的目标文档名�U?br>$+
��M��的依赖文档，以空格分开�Q��ƈ以出现的先后为序�Q�可能包含重复的依赖文档
$
�W�一个依赖文档的名称
$?
��M��旉��x��目标文档晚的依赖文档�Q��ƈ以空格分开
命��o格式
�?nbsp; �?br>$@
目标文档的完整名�U?br>$^
��M��不重复的依赖文档�Q�以�I�格分开
$%
假如目标是归档成员，则该变量表示目标的归档成员名�U?br>
自动变量的书写比较难讎ͼ�但是在熟�l�了之后会很的方便，误��者结合下例中的自动变量改写的Makefile�q�行记忆�?br>
OBJS = kang.o yul.o
CC = Gcc
CFLAGS = -Wall -O -g
sunq : $(OBJS)
   $(CC) $^ -o $@
kang.o : kang.c kang.h
   $(CC) $(CFLAGS) -c $
yul.o : yul.c yul.h
   $(CC) $(CFLAGS) -c $

另外�Q�在Makefile中还能够使用环境变量。��用环境变量的�Ҏ��相对比较��单，make在启动时会自动读取系�l�当前已定义了的环境变量�Q��ƈ且会创徏和之具备相同名称和数值的变量。但是，假如用户在Makefile中定义了相同名称的变量，那么用户自定义变量将会覆盖同名的环境变量�?br>3.6.3  Makefile规则
Makefile的规则是Make�q�行处理的依据，他包括了目标体、依赖文档及其之间的命��o语句。一般的�Q�Makefile中的一条语句就是个规则。在上面的例子中�Q�都昄��地指��Z��Makefile中的规则关系�Q�如“$(CC) $(CFLAGS) -c $”�Q�但��Z��化Makefile的编写，make�q�定义了隐式规则和模式规则，下面��分别对其进行讲解�?br>1�Q�隐式规�?br>隐含规则能够告诉make怎样使用传统的技术完成�Q务，�q�样�Q�当用户使用他们时就不必周详指定�~�译的具体细节，而只需把目标文档列出即可。Make会自动搜索隐式规则目录来��定如何生成目标文档。如上例��p��够写成：

OBJS = kang.o yul.o
CC = Gcc
CFLAGS = -Wall -O -g
sunq : $(OBJS)
   $(CC) $^ -o $@

��Z��么能够省略后两句呢？因�ؓMake的隐式规则指出：��M��“.o”文档都可自动�?#8220;.c”文档使用命��o“$(CC) $(CPPFLAGS) $(CFLAGS) -c file.c –o file.o”生成。这�?#8220;kang.o”�?#8220;yul.o”��׃��分别调用“$(CC) $(CFLAGS) -c kang.c -o kang.o”�?#8220;$(CC) $(CFLAGS) -c yul.c -o yul.o”生成�?br>
screen.width*0.7) {this.resized=true; this.width=screen.width*0.7; this.style.cursor='hand'; this.alt='Click here to open new window\nCTRL+Mouse wheel to zoom in/out';}" onclick="if(!this.resized) {return true;} else {window.open('http://book.csdn.net/BookFiles/132/03/image006.jpg');}" alt="" src="http://book.csdn.net/BookFiles/132/03/image006.jpg" onload="if(this.width>screen.width*0.7) {this.resized=true; this.width=screen.width*0.7; this.alt='Click here to open new window\nCTRL+Mouse wheel to zoom in/out';}" border=0>
注意
在隐式规则只能查扑ֈ�相同文档名的不同后缀名文档，�?#8221;kang.o”文档必须�?#8221;kang.c”文档生成�?br>
下表3.16�l�出了常见的隐式规则目录�Q?br>�?.16                                              Makefile中常见隐式规则目�?br>对应语言后缀�?br>�?nbsp; �?br>C�~�译�Q?c变�ؓ.o
$(CC) –c $(CPPFLAGS) $(CFLAGS)
C++�~�译�Q?cc�?C变�ؓ.o
$(CXX) -c $(CPPFLAGS) $(CXXFLAGS)
Pascal�~�译�Q?p变�ؓ.o
$(PC) -c $(PFLAGS)
Fortran�~�译�Q?r变�ؓ-o
$(FC) -c $(FFLAGS)
2�Q�模式规�?br>模式规则是用来定义相同处理规则的多个文档的。他不同于隐式规则，隐式规则仅仅能够用make默认的变量来�q�行操作�Q�而模式规则还能引入用戯��定义变量�Q��ؓ多个文档建立相同的规则，从而简化Makefile的编写�?br>模式规则的格式类��g��普通规则，�q�个规则中的相关文档前必��ȝ��“%”标明。��用模式规则修改后的Makefile的编写如下：

OBJS = kang.o yul.o
CC = Gcc
CFLAGS = -Wall -O -g
sunq : $(OBJS)
   $(CC) $^ -o $@
%.o : %.c
   $(CC) $(CFLAGS) -c $

3.6.4  Make使用
使用make��理器很��单，只需在make命��o的后面键入目标名卛_��建立指定的目标，假如直接�q�行make�Q�则建立Makefile中的�W�一个目标�?br>此外make更有丰富的命令行选项�Q�能够完成各�U�不同的功能。下�?.17列出了常用的make命��o行选项�?br>�?.17                                                       make的命令行选项
命��o格式
�?nbsp; �?br>-C dir
��d��指定目录下的Makefile
-f file
��d��当前目录下的file文档作�ؓMakefile
命��o格式
�?nbsp; �?br>-i
忽略��M��的命令执行错�?br>-I dir
指定被包含的Makefile所在目�?br>-n
只打印要执行的命令，但不执行�q�些命��o
-p
昄��make变量数据库和隐含规则
-s
在执行命令时不显�C�命�?br>-w
假如make在执行过�E�中改变目录�Q�则打印当前目录�?br>3.7  使用autotools
在上一��节�Q�读者已了解��C��make��目��理器的强大功能。的��，Makefile能够帮助make完成他的使命�Q�但要承认的是，�~�写Makefile��实不是一件轻杄��事，��其对于一个较大的��目而言更是如此。那么，有没有一�U�轻杄��手段生成Makefile而同时又能让用户享受make的优��性呢�Q�本节要讲的autotools�p�d��工具正是为此而设的，他只需用户输入��单的目标文档、依赖文档、文档目录等��p��够轻村֜�生成Makefile了，�q�无疑是�q�大用户的所希望的。另外，�q�些工具�q�能够完成系�l�配�|�信息的攉��Q�从而能够方便地处理各种�U�L��性的问题。也正是��Z��此，现在Linux上的软�g研发一般都用autotools来制作Makefile�Q�读者在后面的讲�q�C��׃��了解到�?br>3.7.1  autotools使用��程
正如前面所�a��Q�autotools是系列工��P��读者首先要��认�pȝ��是否装了以下工具�Q�能够用which命��o�q�行查看�Q��?br>·  aclocal
·  autoscan
·  autoconf
·  autoheader
·  automake
使用autotools主要��是利用各个工具的脚本文档以生成最后的Makefile。其��M��程是这��L��Q?br>·  使用aclocal生成一�?#8220;aclocal.m4”文档�Q�该文档主要处理本地的宏定义�Q?br>·  改写“configure.scan”文档�Q��ƈ��其重命名�ؓ“configure.in”�Q��ƈ使用autoconf文档生成configure文档�?br>接下来，�W�者将通过一个简单的hello.c例子带领读者熟悉autotools生成makefile的过�E�，�׃��在这�q�程中有涉及到较多的脚本文档�Q��ؓ了更清楚��C��解相互之间的关系�Q�强烈徏议读者实际动手操作以体会其整个过�E��?br>1�Q�autoscan
他会在给定目录及其子目录树中��查源文档�Q�若没有�l�出目录�Q�就在当前目录及其子目录树中�q�行��查。他会搜索源文档以寻找一般的�U�L��性问题�ƈ创徏一个文�?#8220;configure.scan”�Q�该文档��是接下来autoconf要用到的“configure.in”原型。如下所�C�：

[root@localhost automake]# autoscan
autom4te: configure.ac: no such file or directory
autoscan: /usr/bin/autom4te failed with exit status: 1
[root@localhost automake]# ls
autoscan.log  configure.scan  hello.c

如上所�C�，autoscan首先会尝试去��d��“configure.ac”�Q�同configure.in的配�|�文档）文档�Q�此时还没有创徏该配�|�文档，于是他会自动生成一�?#8220;configure.in”的原型文�?#8220;configure.scan”�?br>2�Q�autoconf
configure.in是autoconf的脚本配�|�文档，他的原型文档“configure.scan”如下所�C�：

#                                              -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.
AC_PREREQ(2.59)
#The next one is modified by sunq
#AC_INIT(FULL-PACKAGE-NAME,VERSION,BUG-REPORT-ADDRESS)
AC_INIT(hello,1.0)
# The next one is added by sunq
AM_INIT_AUTOMAKE(hello,1.0)
AC_CONFIG_SRCDIR([hello.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_CONFIG_FILES([Makefile])
AC_OUTPUT

下面对这个脚本文档进行解释：
·  �?#8220;#”号开始的行�ؓ注释�?br>·  AC_PREREQ宏声明本文档需要的autoconf版本�Q�如本例使用的版�?.59�?br>· AC_INIT宏用来定义��Y件的名称和版本等信息�Q�在本例中省略了BUG-REPORT-ADDRESS�Q�一般�ؓ作者的e-mail�?br>·  AM_INIT_AUTOMAKE是笔者另加的�Q�他是automake所必备的宏�Q�也同前面相同，PACKAGE是所要��生��Y件套件的名称�Q�VERSION是版本编受��?br>·  AC_CONFIG_SRCDIR宏用来侦��所指定的源码文档是否存在，来确定源码目录的�?br>效性。在此处为当前目录下的hello.c�?br>·  AC_CONFIG_HEADER宏用于生成config.h文档�Q�以便autoheader使用�?br>·  AC_CONFIG_FILES宏用于生成相应的Makefile文档�?br>·  中间的注释间能够��d��分别用户��试�E�式、测试函数库、测试头文档�{�宏定义�?br>接下来首先运行aclocal�Q�生成一�?#8220;aclocal.m4”文档�Q�该文档主要处理本地的宏定义。如下所�C�：

[root@localhost automake]# aclocal

再接着�q�行autoconf�Q�生�?#8220;configure”可执行文档。如下所�C�：

[root@localhost automake]# autoconf
[root@localhost automake]# ls
aclocal.m4  autom4te.cache  autoscan.log  configure  configure.in  hello.c
3�Q�autoheader
接着使用autoheader命��o�Q�他负责生成config.h.in文档。该工具通常会从“acconfig.h”文档中复制用户附加的�W�号定义�Q�因此此处没有附加符号定义，所以无需创徏“acconfig.h”文档。如下所�C�：

[root@localhost automake]# autoheader
4�Q�automake
�q�一步是创徏Makefile很重要的一步，automake要用的脚本配�|�文档是Makefile.am�Q�用户需要自己创建相应的文档。之后，automake工具转换成Makefile.in。在该例中，�W�者创建的文档为Makefile.am如下所�C�：

AUTOMAKE_OPTIONS=foreign
bin_PROGRAMS= hello
hello_SOURCES= hello.c

下面对该脚本文档的对应项�q�行解释�?br>·  其中的AUTOMAKE_OPTIONS为配�|�automake的选项。由于GNU�Q�在�W?章中已有所介绍�Q�对自己发布的��Y件有严格的规范，比如必须附带许可证声明文档COPYING�{�，否则automake执行时会报错。automake提供了三�U��Y件等�U�：foreign、gnu和gnits�Q�让用户选择采用�Q�默认等�U��ؓgnu。在本例使用foreign�{��Q�他只检��必��ȝ��文档�?br>·  bin_PROGRAMS定义要��生的执行文档名。假如要产生多个执行文档�Q�每个文档名用空格隔开�?br>·  hello_SOURCES定义“hello”�q�个执行�E�式所需要的原始文档。假�?#8221;hello”�q�个�E�式是由多个原始文档所产生的，则必��L��他所用到的�Q何原始文档都列出来，�q�用�I�格隔开。例如：若目标体“hello”需�?#8220;hello.c”�?#8220;sunq.c”�?#8220;hello.h”三个依赖文档�Q�则定义hello_SOURCES=hello.c sunq.c hello.h。要注意的是�Q�假如要定义多个执行文档�Q�则�Ҏ��个执行程式都要定义相应的file_SOURCES�?br>接下来能够��用automake对其生成“configure.in”文档�Q�在�q�里使用选项“—adding-missing”能够让automake自动��d��有一些必需的脚本文档。如下所�C�：

[root@localhost automake]# automake --add-missing
configure.in: installing './install-sh'
configure.in: installing './missing'
Makefile.am: installing 'depcomp'
[root@localhost automake]# ls
aclocal.m4    autoscan.log  configure.in  hello.c    Makefile.am  missing
autom4te.cache  configure    depcomp install-sh  Makefile.in  config.h.in

能够看到�Q�在automake之后��p��够生成configure.in文档�?br>5�Q�运行configure
在这一步中�Q�通过�q�行自动配置配置文档configure�Q�把Makefile.in变成了最�l�的Makefile。如下所�C�：

[root@localhost automake]# ./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 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 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: executing depfiles commands
能够看到�Q�在�q�行configure时收集了�pȝ��的信息，用户能够在configure命��o中对其进行方便地配置。在./configure的自定义参数有两�U�，一�U�是开兛_��Q?-enable-XXX�?-disable-XXX�Q�，另一�U�是开攑ּ��Q�即后面要填入一串字�W�（--with-XXX=yyyy�Q�参数。读者能够自行尝试其使用�Ҏ��。另外，读者能够查看同一目录下的”config.log”文档�Q�以方便调试之用�?br>到此为止�Q�makefile��p��够自动生成了。回忆整个步骤，用户不再需要定制不同的规则�Q�而只需要输入简单的文档及目录名卛_��Q�这样就大大方便了用��L��使用。下面的�?.9�ȝ��了上�q�过�E�：
screen.width*0.7) {this.resized=true; this.width=screen.width*0.7; this.style.cursor='hand'; this.alt='Click here to open new window\nCTRL+Mouse wheel to zoom in/out';}" onclick="if(!this.resized) {return true;} else {window.open('http://book.csdn.net/BookFiles/132/03/image012.gif');}" alt="" src="http://book.csdn.net/BookFiles/132/03/image012.gif" onload="if(this.width>screen.width*0.7) {this.resized=true; this.width=screen.width*0.7; this.alt='Click here to open new window\nCTRL+Mouse wheel to zoom in/out';}" border=0>
�?.9  autotools生成Makefile��程�?br>3.7.2  使用autotools所生成的Makefile
autotools生成的Makefile除具备普通的�~�译功能外，�q�具备以下主要功能（感兴��的读者能够查看这个简单的hello.c�E�式的makefile�Q�：
1�Q�make
键入make默认执行”make all”命��o�Q�即目标体�ؓall�Q�其执行情况如下所�C�：

[root@localhost automake]# make
if Gcc
-DPACKAGE_NAME=\"\" -DPACKAGE_TARNAME=\"\" -DPACKAGE_VERSION=\"\"
-DPACKAGE_STRING=\"\" -DPACKAGE_BUGREPORT=\"\" -DPACKAGE=\"hello\"
-DVERSION=\"1.0\"  -I. -I.    -g -O2 -MT hello.o -MD -MP -MF
".deps/hello.Tpo" -c -o hello.o hello.c; \
then mv -f ".deps/hello.Tpo" ".deps/hello.Po"; else rm -f ".deps/hello.Tpo"; exit 1; fi
Gcc  -g -O2 -o hello  hello.o
此时在本目录下就生成了可执行文档“hello”�Q�运�?#8220;./hello”能出现正常结果，如下所�C�：

[root@localhost automake]# ./hello
Hello!Autoconf!
2�Q�make install
此时�Q�会把该�E�式安装到系�l�目录中去，如下所�C�：

[root@localhost automake]# make install
if Gcc
-DPACKAGE_NAME=\"\" -DPACKAGE_TARNAME=\"\" -DPACKAGE_VERSION=\"\"
-DPACKAGE_STRING=\"\" -DPACKAGE_BUGREPORT=\"\" -DPACKAGE=\"hello\"
-DVERSION=\"1.0\"  -I. -I.    -g -O2 -MT hello.o -MD -MP -MF
".deps/hello.Tpo" -c -o hello.o hello.c; \
then mv -f ".deps/hello.Tpo" ".deps/hello.Po"; else rm -f ".deps/hello.Tpo"; exit 1; fi
Gcc  -g -O2 -o hello  hello.o
make[1]: Entering directory '/root/workplace/automake'
test -z "/usr/local/bin" || mkdir -p -- "/usr/local/bin"
  /usr/bin/install -c 'hello' '/usr/local/bin/hello'
make[1]: Nothing to be done for 'install-data-am'.
make[1]: LeaVing directory '/root/workplace/automake'

此时�Q�若直接�q�行hello�Q�也能出现正��结果，如下所�C�：

[root@localhost automake]# hello
Hello!Autoconf!
3�Q�make clean
此时�Q�make会清除之前所�~�译的可执行文档及目标文档（object file, *.o�Q�，如下所�C�：

[root@localhost automake]# make clean
test -z "hello" || rm -f hello
rm -f *.o
4�Q�make dist
此时�Q�make��程式和相关的文档打包�ؓ一个压�~�文档以供发布，如下所�C�：

[root@localhost automake]# make dist
[root@localhost automake]# ls hello-1.0-tar.gz
hello-1.0-tar.gz

可见该命令生成了一个hello-1.0-tar.gz的压�~�文档�?br>�׃��面的讲述读者不隄��出，autotools��实是��Y件维护和发布的必备工��P��也鉴于此�Q�如今GUN的��Y件一般都是由automake来制作的�?br>
screen.width*0.7) {this.resized=true; this.width=screen.width*0.7; this.style.cursor='hand'; this.alt='Click here to open new window\nCTRL+Mouse wheel to zoom in/out';}" onclick="if(!this.resized) {return true;} else {window.open('http://book.csdn.net/BookFiles/132/03/image013.jpg');}" alt="" src="http://book.csdn.net/BookFiles/132/03/image013.jpg" onload="if(this.width>screen.width*0.7) {this.resized=true; this.width=screen.width*0.7; this.alt='Click here to open new window\nCTRL+Mouse wheel to zoom in/out';}" border=0>
想一�?br>对于automake制作的这�c��Y�Ӟ��应如何安装呢�Q?br>3.8.3  �~�写包含多文档的Makefile
1�Q�实验目�?br>通过对包含多文档的Makefile的编写，熟悉各种形式的Makefile�Q��ƈ且进一步加深对Makefile中用戯��定义变量、自动变量及预定义变量的理解�?br>2�Q�实验过�E?br>�Q?�Q�用Vi在同一目录下编辑两个简单的Hello�E�式�Q�如下所�C�：

#hello.c
#include "hello.h"
int main()
{
   printf("Hello everyone!\n");
}
#hello.h
#include

�Q?�Q�仍在同一目录下用Vi�~�辑Makefile�Q�且不��用变量替换，用一个目标体实现�Q�即直接��hello.c和hello.h�~�译成hello目标体）。然后用make验证所�~�写的Makefile是否正确�?br>�Q?�Q�将上述Makefile使用变量替换实现。同��L��make验证所�~�写的Makefile是否正确
�Q?�Q�用�~�辑另一Makefile�Q�取名�ؓMakefile1�Q�不使用变量替换�Q�但用两个目标体实现�Q�也��是首先��hello.c和hello.h�~�译为hello.o�Q�再��hello.o�~�译为hello�Q�，再用make�?#8221;-f”选项验证�q�个Makefile1的正��性�?br>�Q?�Q�将上述Makefile1使用变量替换实现�?br>3�Q�实验步�?br>�Q?�Q�用Vi打开上述两个代码文档“hello.c”�?#8220;hello.h”�?br>�Q?�Q�在shell命��o行中用Gcc��试�~�译�Q��用命令：”Gcc hello.c –o hello”�Q��ƈ�q�行hello可执行文档查看结果�?br>�Q?�Q�删除此�ơ编译的可执行文档：rm hello�?br>�Q?�Q�用Vi�~�辑Makefile�Q�如下所�C�：

hello:hello.c hello.h
   Gcc hello.c -o hello

�Q?�Q�退��Z��存，在shell中键入：make�Q�查看结果�?br>�Q?�Q�再�ơ用Vi打开Makefile�Q�用变量�q�行替换�Q�如下所�C�：

OBJS :=hello.o
CC :=Gcc
hello:$(OBJS)
   $(CC) $^ -o $@

�Q?�Q�退��Z��存，在shell中键入：make�Q�查看结果�?br>�Q?�Q�用Vi�~�辑Makefile1�Q�如下所�C�：

hello:hello.o
   Gcc hello.o -o hello
hello.o:hello.c hello.h
   Gcc -c hello.c -o hello.o

�Q?�Q�退��Z��存，在shell中键入：make -f Makefile1�Q�查看结果�?br>�Q?0�Q�再�ơ用Vi�~�辑Makefile1�Q�如下所�C�：

OBJS1 :=hello.o
OBJS2 :=hello.c hello.h
CC :=Gcc
hello:$(OBJS1)
   $(CC) $^ -o $@
$(OBJS1):$(OBJS2)
   $(CC) -c $

在这里请注意区别“$^”�?#8220;$”�?br>�Q?1�Q�退��Z��存，在shell中键入：make -f Makefile1�Q�查看结�?br>4�Q�实验结�?br>各种不同形式的makefile都能完成其正��的功能�?br>3.8.4  使用autotools生成包含多文档的Makefile
1�Q�实验目�?br>通过使用autotools生成包含多文档的Makefile�Q�进一步掌控autotools的正��用方法。同�Ӟ��掌控Linux下安装��Y件的常用�Ҏ��?br>2�Q�实验过�E?br>�Q?�Q�在原目录下新徏文档夹auto�?br>�Q?�Q�利用上例的两个代码文档“hello.c”�?#8220;hello.h”�Q��ƈ��他们复制到该目录下�?br>�Q?�Q��用autoscan生成configure.scan�?br>�Q?�Q�编辑configure.scan�Q�修改相兛_��容，�q�将光��命名为configure.in�?br>�Q?�Q��用aclocal生成aclocal.m4�?br>�Q?�Q��用autoconf生成configure�?br>�Q?�Q��用autoheader生成config.in.h�?br>�Q?�Q�编辑Makefile.am�?br>�Q?�Q��用automake生成Makefile.in�?br>�Q?0�Q��用configure生成Makefile�?br>�Q?1�Q��用make生成hello可执行文档，�q�在当前目录下运行hello查看�l�果�?br>�Q?2�Q��用make install��hello安装到系�l�目录下�Q��ƈ�q�行�Q�查看结果�?br>�Q?3�Q��用make dist生成hello压羃包�?br>�Q?4�Q�解压hello压羃包�?br>�Q?5�Q�进入解压目录�?br>�Q?6�Q�在该目录下安装hello软�g�?br>3�Q�实验步�?br>�Q?�Q�mkdir ./auto�?br>�Q?�Q�cp hello.* ./auto�Q�假定原先在“hello.c”文档目录下）�?br>�Q?�Q�命令：autoscan�?br>�Q?�Q��用Vi�~�辑configure.scan为：

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

AC_PREREQ(2.59)
AC_INIT(hello, 1.0)
AM_INIT_AUTOMAKE(hello,1.0)
AC_CONFIG_SRCDIR([hello.h])
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(Makefile)

�Q?�Q�保存退出，�q��命名为configure.in�?br>�Q?�Q�运行：aclocal�?br>�Q?�Q�运行：autoconf�Q��ƈ用ls查看是否生成了configure可执行文档�?br>�Q?�Q�运行：autoheader�?br>�Q?�Q�用Vi�~�辑Makefile.am文档为：

AUTOMAKE_OPTIONS=foreign
bin_PROGRAMS=hello
hello_SOURCES=hello.c hello.h

�Q?0�Q�运行：automake�?br>�Q?1�Q�运行：./configure�?br>�Q?2�Q�运行：make�?br>�Q?3�Q�运行：./hello�Q�查看结果是否正��?br>�Q?4�Q�运行：make install�?br>�Q?5�Q�运行：hello�Q�查看结果是否正��?br>�Q?6�Q�运行：make dist�?br>�Q?7�Q�在当前目录下解压hello-1.0.tar.gz�Q�tar –zxvf hello-1.0.tar.gz�?br>�Q?8�Q�进入解压目录：cd ./hello-1.0�?br>�Q?9�Q�下面开始Linux下常见的安装软�g步骤�Q?/configure�?br>�Q?0�Q�运行：make�?br>�Q?1�Q�运行：./hello�Q�在正常安装时这一步可省略�Q��?br>�Q?2�Q�运行：make install�?br>�Q?3�Q�运行：hello�Q�查看结果是否正��?br>4�Q�实验结�?br>能够正确使用autotools生成Makefile�Q��ƈ且能够安装成功短��的Hello软�g�?br>

T.S Liu 2008-06-28 00:05 发表评论

自动生成Makefile (�?

T.S Liu — Fri, 27 Jun 2008 04:33:00 GMT

在test目录上新建src和include目录�Q�源文�g中src目录下，头文件在include目录。在src目录新徏Makefile.am文�g�Q�编写Makefile.am�Q�如下：

AUTOMAKE_OPTIONS = foreign

INCLUDES= -I../include
bin_PROGRAMS = main
radio_SOURCES = main.c \
keyboard.c \
lcd.c \
setup.c \
storage.c

保存退出�?/div>
�q�回test目录�Q�再新徏Makefile.am文�g�Q�编写Makefile.am,如下�Q?/div>
SUBDIRS = src 
保存退出�?/div>
 
执行  
autoscan 
生成configure.scan文�g �Q�如�Q?/div>
autoscan.log  configure.scan  include  Makefile.am  src
�~�辑configure.scan文�g�Q�如�Q?/div>
#                                               -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.
AC_PREREQ(2.61)
AC_INIT(radio,1.0.0,[wenzel@163.com])
AM_INIT_AUTOMAKE
AC_CONFIG_SRCDIR([src/make.c])
AC_CONFIG_HEADER([config.h])
# Checks for programs.
AC_PROG_CC
# Checks for libraries.
#AC_PROG_RANLIB
# Checks for header files.
AC_HEADER_DIRENT
AC_HEADER_STDC
AC_CHECK_HEADERS([fcntl.h stdlib.h string.h sys/time.h termios.h unistd.h])
# Checks for typedefs, structures, and compiler characteristics.
AC_C_CONST
AC_TYPE_SIZE_T
# Checks for library functions.
AC_FUNC_CLOSEDIR_VOID
AC_FUNC_FORK
AC_PROG_GCC_TRADITIONAL
AC_FUNC_LSTAT
AC_FUNC_LSTAT_FOLLOWS_SLASHED_SYMLINK
AC_FUNC_MALLOC
AC_TYPE_SIGNAL
AC_CHECK_FUNCS([bzero memset strcasecmp strchr strrchr])
#AC_CONFIG_FILES([Makefile
#                 src/Makefile])
AC_OUTPUT(Makefile src/Makefile)
 
保存退出，改名为：mv configure.scan configure.in 
执行�Q?/div>
touch NEWS README AUTHORS ChangeLog 
再执行：
autoreconf -fvi 
 
最后，可以执行�Q?/div>
./configure
配置为ARM�q�_���Q?/div>
 ./configure --host=arm --target=arm CC=arm-linux-gcc
���可以编译了�Q�如�Q?/div>
make  
make install 
make clean
make distclean


T.S Liu 2008-06-27 12:33 发表评论

GNU Automake

T.S Liu — Fri, 27 Jun 2008 01:43:00 GMT

摘要: Automake是一个从文�g`Makefile.am'自动生成`Makefile.in' 的工兗��每个`Makefile.am'基本上是一�p�d��make的宏定义�Q�make规则也会偶尔出现�Q�。生成的`Makefile.in's服从GNU Makefile标准�? GNU Makefile标准文档�Q�参见GNU�~�码标准中的‘Makefile惯例’节）�ѝ��复杂，而且会发生改变。Au... 阅读全文

T.S Liu 2008-06-27 09:43 发表评论

T.S Liu — Fri, 27 Jun 2008 01:42:00 GMT

使用 GNU autotools 攚w��一个��Y仉��?br>
本文不是一��规范的教程�Q�而是用一个��Y仉��目作��Z��子，演示使用 GNU autotools �q�行
软�g��理的思�\和过�E?br>
�?�?br>
· �C�Z��目
· 软�g布局
· Makefile 分析
· GNU 的��Y仉��?br>· 准备 autotools
· 攚w��文件布局
· autoscan
· configure.ac 的基本结�?br>· Makefile 文�g的��?br>· �~�写 Makefile.am
软�g根目�?Makefile.am
src/Makefile.am
data/Makefile.am
docs/Makefile.am
fonts/Makefile.am
images/Makefile.am
music/Makefile.am
sound/Makefile.am

· �q�行 autotools
· SDL 库的侦测
· 软�g使用的数据文�?br>· configure 选项
· autotools 脚本
· 使用 configure 产生�?Makefile
· 最�l�的 configure.ac 文�g
· �l�束�?br>
�C�Z��目

�q�里借用�?Wei Mingzhi 开发的��d��游戏来进行演�C�，�?br>此，先对他表�C�感�?

�C�Z��软�g下蝲:

软�g布局

��下载的软�g包解压到一个目�?br>
$ cd ~/work
$ tar xjf mahjong.tar.bz2

可以看到�q�是一个典型的 Windows 风格的��Y仉��目布局�Q�在 mahjong 目录下放着�E�序�?br>源码�Q�程序运行时使用的数据文件放在子目录下面

作者还提供了一�?Makefile�Q�一�?DOS 风格�?!play.bat 批处理文�Ӟ��一个编译好�?br>mj.exe 可执行文件在 Win32 �q�_��上运�?!play.bat ��可以直接运行程序在 Unix/
Linux �pȝ��上，�q�入 mahjong 目录�Q�键�?make 命��o�Q�如果一切顺利的话，��生�?mj �?br>执行文�g�Q�然后在命��o行上�q�行 ./mj �E�序�Q�也可以启动��d��游戏

对于一�?Windows �E�序来讲�Q�该软�g布局可以说非常清晰明了但�?Unix/Linux �pȝ��
上，执行 make 命��o��可能遇到问题：�~�译找不到头文�g�Q�或者连接找不到库文件而在
make 成功以后�Q�运行麻��程序必��d��q�入�?majiong 目录�Q�才能执行程序如果要�?br>其他的程序一��P��可以在�Q意目录��用，��p��专门��一个程序修�?PATH 环境变量�Q�或
者再写一个启动脚本，�q�将它复制到 /usr/bin �q�样的目录下

Makefile 分析

1 #
2 # Copyright (c) 2005, Wei Mingzhi. All rights reserved.
3 #
4 # Use, redistributions and modifications of this file is
5 # unrestricted provided the above copyright notice is
6 # preserved.
7 #
8
9 OBJ = \
10 bot.o config.o game.o general.o hand.o ini.o main.o \
11 player.o text.o tile.o util.o
12
13 HEADERS = \
14 bot.h game.h general.h hand.h ini.h main.h player.h \
15 tile.h
16
17 CC = gcc
18 CXX = g++
19
20 TARGET = mj
21
22 BASEFLAGS = -g3 -D_DEBUG=1
23 #BASEFLAGS = -s -O3
24
25 CFLAGS = ${BASEFLAGS} `sdl-config --cflags`
26 LDFLAGS = ${BASEFLAGS} `sdl-config --libs` -lSDL_image -lSDL_mixer -lSDL_ttf
27
28 all: ${TARGET}
29
30 ${TARGET}: ${OBJ}
31 ${CXX} ${LDFLAGS} -o ${TARGET} ${OBJ}
32
33 clean:
34 rm -f *.o ${TARGET}
35
36 distclean:
37 rm -f *.o ${TARGET}
38
39 %.o: %.cpp ${HEADERS}
40 ${CXX} ${CFLAGS} -c $< -o $@
41
42 %.o: %.c ${HEADERS}
43 ${CC} ${CFLAGS} -c $< -o $@

Makefile 很清楚：�W?20 行定�?TARGET 变量�?mj�Q�第 28 行表�?make 默认�?target
也就是生�?`mj'�Q�第 22 行加入编译时的调试信息；�W?2526 行��用了 sdl-config �?br>具侦��?SDL 开发库�~�译链接信息�Q�在 26 行还指明需要连�?SDL_imageSDL_mixser �?br>SDL_ttf �?br>
GNU 的��Y仉��?br>
一个标准的 GNU 软�g�Q�编译安装都是��用下面三个步�?

$ ./configure
$ make
$ make install

configure 脚本�q�行时可以侦��系�l�的环境�Q�确定��Y件安装目录，然后生成 Makefile �?br>件make 调用�pȝ��中的�~�译器进行编译和�q�接make install ��Y件安装到讑֮�的目�?br>

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

�׃�� GNU 的��Y仉��格方便易用，通用性好�Q�可�U�L��性高�Q�现在大多数 Unix/Linux �pȝ��?br>的自��p�Y仉��采用�q�种方式分发软�g

准备 autotools

GNU autotools 主要包含三个软�g�Q?autoconf�Q�automake �?libtool当前��行的有�?br>旧两个版本，本例采用的是新版本，分别对应的是�Q?autoconf 2.59�Q?automake 1.9.6
�?libtool 1.5.18

很多 linux 发行版都会默认安装这几个工具本例是在 NetBSD 下进行操作，安装�q�几�?br>软�g包是通过 pkgsrc�Q�它们在 pkgsrc 目录�?devel/autoconf devel/automake �?br>devel/libtool

攚w��文件布局

原来软�g的根目录下面攄��是程序的源码�Q�按�?GNU 的习惯，��它们放�?src 子目录，
根目录留�l?configure �q�类文�g使用�Q�其他的数据文�g保持不变�Q�仍然放在各自的子目�?br>

先创��Z��个目�?majiang�Q�然后根据需要将 mahjong 目录下的文�g复制�q�来�׃��是�ؓ
Unix/Linux �pȝ��q�行改写�Q�原目录里的 win32 相关文�g��׃��用复制到新目�?br>
$ cd ~/work/majiang
$ ls
data/ docs/ fonts/ images/ music/ sound/ src/

autoscan

autoconf 软�g包里面的 autoscan 工具可以扫描工作目录�Q�生成一�?configure.ac �?br>模板文�g configure.scan

$ cd ~/work/majiang
$ autoscan

autoscan 命��o在当前目录生成的 configure.scan 文�g内容�?

1 # -*- Autoconf -*-
2 # Process this file with autoconf to produce a configure script.
3
4 AC_PREREQ(2.59)
5 AC_INIT(FULL-PACKAGE-NAME, VERSION, BUG-REPORT-ADDRESS)
6 AC_CONFIG_SRCDIR([src/bot.h])
7 AC_CONFIG_HEADER([config.h])
8
9 # Checks for programs.
10 AC_PROG_CXX
11 AC_PROG_CC
12
13 # Checks for libraries.
14
15 # Checks for header files.
16 AC_HEADER_STDC
17 AC_CHECK_HEADERS([limits.h malloc.h stdlib.h string.h unistd.h])
18
19 # Checks for typedefs, structures, and compiler characteristics.
20 AC_HEADER_STDBOOL
21 AC_C_CONST
22 AC_C_INLINE
23
24 # Checks for library functions.
25 AC_FUNC_MALLOC
26 AC_FUNC_REALLOC
27 AC_CHECK_FUNCS([memset strcasecmp strchr strdup])
28 AC_OUTPUT

# 号开始的行是注释�Q�其他都�?m4 宏命令将它改名�ؓ configure.ac�Q�然后在此基��?br>�q�行修改

configure.ac 的基本结�?br>
configure.ac 文�g�?autoconf 的输入文�Ӟ��l�过 autoconf 处理�Q�展开里面�?m4 宏，
输出的是 configure 脚本

�W?4 行声明本文�g要求�?autoconf 版本�Q�因为本例��用了新版�?2.59�Q�所以在此注�?br>

�W?5 �?AC_INIT 宏用来定义��Y件的名称和版本等信息�Q�本例写�?

AC_INIT(majiang, 1.0)

�q�里省略�?BUG-REPORT-ADDRESS 参数�Q�它是可选项�Q�一般写成作者的邮�g地址

�W?6 �?AC_CONFIG_SRCDIR 宏通过侦测所指定的源码文件是否存在，来确定源码目录的�?br>效性可以选择源码目录中的��M��一个文件作��Z��表，比如��?autoscan 选择�?bot.h
文�g�Ҏ�� main.cpp:

AC_CONFIG_SRCDIR([src/main.cpp])

宏参��C��使用 `[ ]'�Q�是��Z��表明其中的字�W�串是一个整�?br>
�W?7 行的 AC_CONFIG_HEADER 宏用于生�?config.h 文�g�Q�里面存�?configure 脚本�?br>��到的信息如果程序需要��用其中的定义�Q�就在源码中加入

#include

其他的一些宏是标准的侦测�q�程�Q�可以保留不�?br>
configure.ac 文�g要求 AC_INIT 宏必��L��在开头位�|�，AC_OUTPUT 攑֜�文�g末，中间�?br>来检��编译环境的各种宏没有特别的先后�ơ序要求�Q�由宏之间相互关�p�d��?br>
Makefile 文�g的��?br>
前面 configure.ac 里面的宏�Q�主要作用是侦测�pȝ��Q��ƈ没有�~�译相关的设�|�因��?br>信息是写�?Makefile.am 里面�Q�然后用 automake 工具转换�?Makefile.in�Q�configure
脚本执行时再��d�� Makefile.in�Q��ƈ与侦��信息一起写�?Makefile 文�g

�?autotools 的命名习惯中�Q�后�~� ac 的文件是 autoconf 的输入文�Ӟ��后缀 am 的文
件是 automake 的输入文�Ӟ��后缀 in 的文件是 configure 的输入文�?autoconf 旧版
本中 configure.in �{�同�?configure.ac�Q�虽然新版本也可以识别，但它不符合命名规�?br>�Q�所以新版本的文件应该��?ac 后缀

��单的 Makefile.in 可以手动�~�写�Q�如果��?automake 产生�Q�需要在 configure.ac
里面加入 AM_INIT_AUTOMAKE 宏进行声�?br>
要输�?Makefile�Q�还需要在 configure.ac 中��?AC_CONFIG_FILES 宏指明该宏�ƈ�?br>是只处理 Makefile�Q�而是��?FILE.in 文�g转换�?FILE 文�g因�ؓ make 可以遍历子目
录，如果子目录中存在 Makefile�Q�也��同时处理在本例�?src 目录下是源码�Q�其他是
数据文�g�Q�可以��用单独一�?Makefile 攑֜�根目录下面，也可以用多个 Makefile�׃��
每个子目录的 Makefile 只处理本目录的文�Ӟ��分工明确�Q�是模块化的�Ҏ��Q�推荐��?br>因此�?configure.ac 里面增加下面的宏�Q�表�C��Y件根目录和子目录中都需要生�?br>Makefile 文�g:

AC_CONFIG_FILES([Makefile
src/Makefile
data/Makefile
docs/Makefile
fonts/Makefile
images/Makefile
music/Makefile
sound/Makefile])

�~�写 Makefile.am

软�g根目�?Makefile.am

�׃��该目录下面保存的是与 autotools 相关的文�Ӟ��没有需要编译安装的文�g�Q�所以只�?br>明需要进一步处理的子目录信�?

SUBDIRS = src data docs fonts images music sound

src/Makefile.am

此目录里是源代码�Q�最�l�生�?mj 可执行文�Ӟ��在其 Makefile.am 中写�?br>
bin_PROGRAMS = mj

mj_SOURCES = bot.h \
bot.cpp \
config.cpp \
game.h \
game.cpp \
general.h \
general.cpp \
hand.h \
hand.cpp \
ini.h \
ini.cpp \
main.h \
main.cpp \
player.h \
player.cpp \
text.cpp \
tile.h \
tile.cpp \
util.cpp

am 文�g里变量通过命名判断其含义，保留的字�W�串间用下划�U�分�?br>
bin_PROGRAMS 表示列出二进制的�E�序�Q��gؓ多个�I�格分开的程序列表，�q�里仅有一�?mj

mj_SOURCES 列出的是�l�成 mj �E�序的文�Ӟ��文�g比较多的时候，每个文�g写成一行容易看
清楚

data/Makefile.am

本目录的文�g�?mj �q�行时读取的数据�Q�它�?Makefile.am 可以�q�样�?br>
mjdatadir = $(pkgdatadir)/data
mjdata_DATA = mj.ini titles.txt
EXTRA_DIST = $(mjdata_DATA)

因�ؓ datadir 是保留的关键字，所以用 mjdatadir 代替�Q�pkgdatadir 指向 $prefix/
share/FULL-PACKAGE-NAME 目录�Q�因为在 AC_INIT 中已�l�声�?FULL-PACKAGE-NAME �?br>majiang�Q�pkgdatadir ��q��?$prefix/share/majiang 目录

其中 mjdatadir �?data 目录下的文�g安装�?$prefix/share/majiang/data 目录里面

mjdata_DATA 列出此目录下需要安装的文�g�Q�然后用 EXTRA_DIST 变量注明

余下几个子目录都�?data 目录�c�M��

docs/Makefile.am

docsdir = $(pkgdatadir)/docs
docs_DATA = gkai00mp.txt gpl.html readme.txt
EXTRA_DIST = $(docs_DATA)

fonts/Makefile.am

fontsdir = $(pkgdatadir)/fonts
fonts_DATA = brush.ttf gkai00mp.ttf
EXTRA_DIST = $(fonts_DATA)

images/Makefile.am

imagesdir = $(pkgdatadir)/images
images_DATA = bgame.jpg \
mjgirl1a.jpg \
mjgirl2a.jpg \
mjgirl3a.jpg \
mjgirl4a.jpg \
tiles.jpg \
electron.jpg \
mjgirl1b.jpg \
mjgirl2b.jpg \
mjgirl3b.jpg \
mjgirl4b.jpg \
gameover.jpg \
mjgirl1c.jpg \
mjgirl2c.jpg \
mjgirl3c.jpg \
mjgirl4c.jpg
EXTRA_DIST = $(images_DATA)

music/Makefile.am

musicdir = $(pkgdatadir)/music
music_DATA = bet.ogg \
bonus.ogg \
music.ogg \
musicb.ogg \
musice.ogg \
win.ogg \
bgame.ogg \
gameover.ogg \
music1.ogg \
musicc.ogg \
musicp.ogg
EXTRA_DIST = $(music_DATA)

sound/Makefile.am

sounddir = $(pkgdatadir)/sound
sound_DATA = boom.wav \
ding.wav \
discard.wav \
discard2.wav \
flash.wav \
snd1.wav \
snd2.wav \
snd3.wav \
snd4.wav
EXTRA_DIST = $(sound_DATA)

�q�行 autotools

准备�?configure.ac �?Makefile.am�Q�就可以�?autotools 的命令处理这些文件开�?br>可能会出现错误，不过没关�p�，可以按照错误信息的提�C�逐步�q�行修正

首先要��用的�?aclocal 命��o�Q�它�Ҏ�� configure.ac 的定义，��需要��用的 m4 宏定
义复制到 aclocal.m4 里面�~�省�Ӟ��搜烦 m4 宏是�?autoconf 的安装目录和�pȝ��?br>aclocal 目录如果需要��用其他�\径下的宏�Q�可以通过命��o行的 -I 选项指定

接着使用 autoheader 命��o�Q�它负责生成 config.h.in 文�g�Q�这里面�?C 语言宏定义也
是通过解析 configure.ac 产生

下来�q�行 automake 命��o处理 Makefile.am�Q�生�?Makefile.inGNU 对自己发布的软�g
有严格的规范�Q�比如必��附带许可证声明文�g COPYING �{�等�Q�否�?automake 执行时会
报错automake 提供了三�U��Y件等�U�： foreigngnu �?gnits�Q�让用户选择采用�Q�默�?br>�{��?gnu本例使用 foreign �{��Q�它只检��必��ȝ��文�g有一些必需的脚本文件可�?br>�?automake 软�g包里复制�q�来�Q�在执行时��?--add-missing 选项可以�?automake �?br>动添加，默认方式是采用符号链接，如加�?--copy 选项则可以��用复制方式本例中�Q?br>automake 的命令如�?

$ automake --foreign --add-missing --copy

最后，使用 autoconf 命��o生成 configure 脚本文�g

SDL 库的侦测

�q�个��d��游戏是基�?SDL 库开发的�Q�一般系�l�默认不会安装，因此 configure 脚本的一
个�Q务就是检查用��L��pȝ��中是否有该��Y件包

autoconf 提供了很多宏可以实现侦测功能�Q�但首先应该查看 SDL 软�g包是否已�l�提供相
应的宏通过 pkgsrc 的工具可以看�?

$ pkg_info -L SDL|grep m4
/usr/pkg/share/aclocal/sdl.m4

�?SDL 软�g包提供了一�?sdl.m4 宏，攑֜��pȝ��?aclocal 目录�?br>
在这个宏文�g的注释中说明了��用的�Ҏ��:

dnl AM_PATH_SDL([MINIMUM-VERSION,[ACTION-IF-FOUND[,ACTION-IF-NOT-FOUND]]])
dnl Test for SDL, and define SDL_CFLAGS and SDL_LIBS

也就是说�?configure.ac 里面调用 AM_PATH_SDL 宏，��可以侦��?SDL扑ֈ� SDL 库以
后，该宏�q�输�?SDL_CFLAGS �?SDL_LIBS �~�译�q�接选项�Q�它们实际上��是调用
`sdl-config --cflags` �?`sdl-config --libs`

于是�?configure.ac 里面加入 AM_PATH_SDL �?br>
# Checks for libraries.
SDL_VERSION=1.2.0
AM_PATH_SDL($SDL_VERSION,
:,
AC_MSG_ERROR([*** SDL version $SDL_VERSION not found!])
)

当前 SDL 的版本�ؓ 1.2.9�Q�于�?MINIMUM-VERSION ��p��?1.2.0如果在系�l�中侦测�?br>需要的库，没什么额外的操作�Q�假如没有找刎ͼ�则给出错误信�?br>
AM_PATH_SDL 输出 SDL_CFLAGS �?SDL_LIBS �~�译参数�Q�需要添加到 src/Makefile.am �?br>�?

mj_CPPFLAGS = @SDL_CFLAGS@
mj_LDFLAGS = @SDL_LIBS@

�?`@' 包围的变量会�?configure 执行时被替换

�?mahjong �?Makefile 中看刎ͼ��q�个软�g�q�要使用 SDL_imageSDL_mixser �?br>SDL_ttf 库，但它们不属于 SDL 软�g包，需要另外安装由于这些库�?sdl.m4 中也�?br>有进行侦��，所以自��p��写一些脚�?br>
autotools 提供了一�?AC_CHECK_LIB 宏可以用来检��库�Q�现在就使用它来��这几个
SDL 库该宏的语法�?

AC_CHECK_LIB (LIBRARY, FUNCTION, [ACTION-IF-FOUND],
[ACTION-IF-NOT-FOUND], [OTHER-LIBRARIES])

�W�一个参数是库名�Q�第二个参数是库中的一个函敎ͼ��W�三个参数是��到以后�q�行的动�?br>�Q�第四个参数是未��到以后的动作，�W�五个参数是其他的库

对于 SDL_imageSDL_mixer �?SDL_ttf 对应的��用方法如�?

# Check for SDL_image library
AC_CHECK_LIB(SDL_image, IMG_LoadPNG_RW, , AC_MSG_ERROR([
*** Unable to find SDL_image libary with PNG support
(http://www.libsdl.org/projects/SDL_image/)
]), `sdl-config --libs`)

# Check for SDL_mixer library
AC_CHECK_LIB(SDL_mixer, Mix_LoadOGG_RW, , AC_MSG_ERROR([
*** Unable to find SDL_mixer libary with OGG support
(http://www.libsdl.org/projects/SDL_mixer/)
]), `sdl-config --libs`)

# Check for SDL_ttf library
AC_CHECK_LIB(SDL_ttf, TTF_OpenFont, , AC_MSG_ERROR([
*** Unable to find SDL_ttf libary
(http://www.libsdl.org/projects/SDL_ttf/)
]), `sdl-config --libs`)

软�g使用的数据文�?br>
原来 mj ��d��数据是从执行时目录的子目录中��d��Q�但现在��数据放�?$prefix/share/
majiang 目录下，需要通过一�U�途径让程序可以知道数据文件被安放的位�|?br>
要达到这个目的有很多�Ҏ��Q�这里采用最直接的一�U�：��数据文件安装目录变量通过
CPPFLAGS �~�译参数传递给�E�序

于是修改 src/Makefile.am �?CPPFLAGS:

mj_CPPFLAGS = @SDL_CFLAGS@ -DDATA_DIR=\"${datadir}/majiang\"

相应��C��?src 目录下的源码�Q�在��d��数据文�g的地方，��读取的路径�Ҏ�� DATA_DIR
里对应的子目录例如，原先 config.cpp 中是:

void LoadCfg()
{
cfg.Load("data/mj.ini");
}

现改�?

void LoadCfg()
{
char ini_file[260];
sprintf(ini_file, "%s/data/mj.ini", DATA_DIR);
cfg.Load(ini_file);
}

configure 选项

原来 mahjong �?Makefile �W?22 行定义了 debug 调试选项�Q�虽然也可以照样攑ֈ� src/
Makefile.am �?CPPFLAGS 里面实现�Q�但 autotools 提供了一�U�更灉|��的机�?br>
configure 脚本可以通过选项来设�|�编译参敎ͼ�现增加一�?--enable-debug 选项�Q�需�?br>DEBUG �Ӟ��在命令行上加上它来打开�Q�默认则关闭

�q�项功能是��?AC_ARG_ENABLE 宏实�?

AC_ARG_ENABLE (FEATURE, HELP-STRING, [ACTION-IF-GIVEN],
[ACTION-IF-NOT-GIVEN])

其中 FEATURE 是名�U�ͼ�HELP_STRING ��明信息，在��?./configure --help 时可以看
到最后两个分别对应打开和关闭时的操�?br>
现在��?DEBUG 功能加入 configure.ac:

AC_ARG_ENABLE(debug,
[ --enable-debug turn on debug],
CXXFLAGS="$CXXFLAGS -g3 -D_DEBUG=1")

autotools 脚本

每次修改�?configure.ac �?Makefile.am �{?autotools 输入文�g后都需要再�ơ运�?br>aclocalautomakeautoconf �q�些命��o�Q��ؓ了方便�v见，可以��他们放��C��?shell
脚本里面�Q�例�?

#! /bin/sh
set -x
aclocal
autoheader
automake --foreign --add-missing --copy
autoconf

��上面内容保存到 autogen.sh 文�g�Q��ƈ修改文�g属性�ؓ 755每次需要重新生�?br>configure 脚本�Ӟ��执行 ./autogen.sh 卛_��

使用 configure 产生�?Makefile

现在执行 ./autogen.sh 得到�?configure 脚本已经可以正常工作了，�q�入 ~/work/
majiang 目录�Q�执�?./configure�Q�可以看到它��查系�l�的�q�程�Q�包�?SDL �?br>SDL_image �{�库的侦��结果��?./configure --help 可以看到 autotools 提供的帮
助信�?br>
configure 执行的完毕，输出软�g根目录和几个子目录下面的 Makefile 文�g�q�些
Makefile 有几个常用的 target:

· make all

不加��M�� target�Q�默认就�?all�Q�作用是�~�译软�g

· make install

安装软�g包，如果安装到系�l�目录，需�?root 权限

· make clean

清除�~�译产生的目标文�?br>
· make distclean

可以同时清除�~�译的结果和 configure 输出的文�?br>
· make tags

生成 etags 使用�?TAGS 文�g

· make dist

生成软�g发布包，�?tar.gz 格式的压�~�包�Q�文件名��p�Y件包名和版本�l�成

最�l�的 configure.ac 文�g

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

AC_PREREQ(2.59)
AC_INIT([majiang], [1.0])
AC_CONFIG_SRCDIR([src/main.cpp])
AC_CONFIG_HEADER([config.h])

AC_CANONICAL_HOST
AC_CANONICAL_TARGET
AM_INIT_AUTOMAKE

# Checks for programs.
AC_PROG_CXX
AC_PROG_CC

AC_LANG(C++)

# Checks for libraries.
SDL_VERSION=1.2.0
AM_PATH_SDL($SDL_VERSION,
:,
AC_MSG_ERROR([*** SDL version $SDL_VERSION not found!])
)

# Check for SDL_image library
AC_CHECK_LIB(SDL_image, IMG_LoadPNG_RW, , AC_MSG_ERROR([
*** Unable to find SDL_image libary with PNG support
(http://www.libsdl.org/projects/SDL_image/)
]), `sdl-config --libs`)

# Check for SDL_mixer library
AC_CHECK_LIB(SDL_mixer, Mix_LoadOGG_RW, , AC_MSG_ERROR([
*** Unable to find SDL_mixer libary with OGG support
(http://www.libsdl.org/projects/SDL_mixer/)
]), `sdl-config --libs`)

# Check for SDL_ttf library
AC_CHECK_LIB(SDL_ttf, TTF_OpenFont, , AC_MSG_ERROR([
*** Unable to find SDL_ttf libary
(http://www.libsdl.org/projects/SDL_ttf/)
]), `sdl-config --libs`)

# Checks for header files.
AC_HEADER_STDC
AC_CHECK_HEADERS([limits.h malloc.h stdlib.h string.h unistd.h])

# Checks for typedefs, structures, and compiler characteristics.
AC_HEADER_STDBOOL
AC_C_CONST
AC_C_INLINE

# Checks for library functions.
AC_FUNC_MALLOC
AC_FUNC_REALLOC
AC_CHECK_FUNCS([memset strcasecmp strchr strdup])

AC_ARG_ENABLE(debug,
[ --enable-debug turn on debug],
CXXFLAGS="$CXXFLAGS -g3 -D_DEBUG=1")

AC_CONFIG_FILES([Makefile
src/Makefile
data/Makefile
docs/Makefile
fonts/Makefile
images/Makefile
music/Makefile
sound/Makefile])
AC_OUTPUT

�l�束�?br>
GNU 的很多工��L��常给��Z��U�感�? 功能很强大，但也很难学autotools 可以说是�q�类
工具的一个典型，它需要用户对 shellmake软�g�~�译m4 宏语�a��Q�以�?Unix/Linux
操作�pȝ��各方面知识都有一定的了解使用时又�?autoconf automakelibtool 多个
工具�怺�配合^1�Q�如果要�l��Y件增加国际化功能�Q�还要再了解和掌�?gettextpo �{�工�?br>和规�?br>
与学习其他知识一��P��所谓难�Q�其实是不了解，不熟悉本文通过一个范例演�C�Z��?br>autotools 的过�E�，是让不了解的人熟悉这个工具但真正的理解，�q�需要将它运用到�?br>��q��软�g��目当中�Q�不断地实践�Q�不断地思考和�ȝ��

脚注

... 多个工具�怺�配合^1
�׃��本例软�g中没有生成库文�g�Q�所以没有涉�?libtool 工具的��?br>

T.S Liu 2008-06-27 09:42 发表评论

�q�用autoconf和automake自动生成Makefil

T.S Liu — Thu, 26 Jun 2008 07:23:00 GMT

对于一个UNIX/Linux下C�E�序员来��_��一个比较麻烦的工作��是写自��q��Makefile�?
可能你有如下�l�验�Q�写一个简单的C�E�序�Q�自己多写几行gcc命��o��把�E�序变成可执行的了；写一个稍微复杂点的程序，源文件个数可能在30个左叻I��q�是写一行行的gcc命��o��麻烦了�Q�你可能惛_��写个makefile�Q�你可能也在�q�样做着�Q�但你某一天会发现你写的这个Makefile可能不是一个所�?UNIX/Linux�c�L��作系�l�下通用的Makefile�Q�比如某��Z��载了你的�E�序��M��自己电脑上可能make不了�?

�q�样�Q�你��有必要了解�q�学会运用autoconf和automake了�?
autoconf是一个用于生成可以自动地配置软�g源代码包以适应多种UNIX�cȝ��l�的shell脚本的工兗��由autoconf生成的配�|�脚本在�q�行的时候不需要用��L��手工�q�预�Q�通常它们甚至不需要手工给出参��C��定�pȝ��的类型。相反，它们对��Y件包可能需要的各种特征�q�行独立的测试。在每个��试之前�Q�它们打��C��个单行的消息以说明它们正在进行的��，以��得用户不会因为等待脚本执行完毕而焦�w�。因此，它们在�؜合系�l�或者从各种常见UNIX变种定制而成的系�l�中工作的很好。你也省了工作，没必要维护文件以储存由各个UNIX变种、各个发行版本所支持的特征的列表�?
automake是一个从文�gMakefile.am自动生成Makefile.in的工兗��每个Makefile.am基本上是一�p�d��make的宏定义�Q�make规则也会偶尔出现�Q�生成的Makefile.in�Q�服从GNU Makefile标准�?
��Z��生成Makefile.in�Q�automake需要perl。但是由automake创徏的发布完全服从GNU标准�Q��ƈ且在创徏中不需要perl�?

在开始��用autoconf和automake之前�Q�首先确认你的系�l�安装有GNU的如下��Y�Ӟ��
1. automake
2. autoconf
3. m4
4. perl
5. 如果你需要��生共享库�Q�shared library�Q�则�q�需要GNU Libtool

介绍�Ҏ��之前大家看一下下面这个图�Q�先��C��autoconf和automake工作的几个步骤：

步骤解释如下�Q?
1、由你的源文仉��过autoscan命��o生成configure.scan文�g�Q�然后修改configure.scan文�g�q��命名为configure.in
2、由aclocal命��o生成aclocal.m4
3、由autoconf命��o生成configure
4、编辑一个Makefile.am文�g�q�由automake命��o生成Makefile.in文�g
5、运行configure命��o生成Makefile

automake支持三种目录层次�Q�flat、shallow和deep�?
一个flat包指的是所有文仉��在一个目录中的包。�ؓ�q�类包提供的Makefile.am不需要SUBDIRS�q�个宏。这�c�d��的一个例子是termutils。对应咱们程序员来说�Q�就是所有源文�g及自己写的头文�g都位于当前目录里面，且没有子目录�?
一个deep包指的是所有的源代码都被储存在子目录中的包�Q�顶层目录主要包含配�|�信息。GNU cpio是这�c�d��的一个很好的例子�Q�GNU tar也是。deep包的��层Makefile.am��包括宏SUBDIRS�Q�但没有其它定义需要创建的对象的宏。对应咱们程序员来说�Q�就是所有源文�g及自己写的头文�g都位于当前目录的一个子目录里面�Q�而当前目录里没有��M��源文件�?
一个shallow包指的是主要的源代码储存在顶层目录中�Q�而各个部分（典型的是库）则储存在子目录中的包。automake本��n��是�q�类包（GNU make也是如此�Q�它现在已经不��用automake�Q�。对应咱们程序员来说�Q�就是主要源文�g在当前目录里�Q�而其它一些实现各部分功能的源文�g各自位于不同目录�?

前两个层�ơ的�E�序�~�辑�Ҏ��非常��单，按照上述步骤一步步卛_��。而第三种层次shallow�E�微复杂一点，但这是我们经常写�E�序用到的结构。下面以一个例子说明shallow层次�l�构的源文�g如何自动生成Makefile文�g�?
例子源程序结构如下：
hello是我们的工作目录�Q�hello目录下有main.c源文件和comm、tools、db、network、interface�{�五个目录�?comm目录下有comm.c和comm.h源文件及头文�Ӟ��tools目录下有tools.c和tools.h�Q�同样其它目录分别有db.c�?db.h、network.c、network.h、interface.c、interface.h�{�一些源文�g�?

按照如下步骤来自动生成Makefile吧：
1、进入hello目录�Q�运行autoscan命��o�Q�命令如下：
cd hello
autoscan
2、ls会发现多了一个configure.scan文�g。修�Ҏ��文�g�Q�在AC_INIT宏之后加入AM_INIT_AUTOMAKE(hello, 1.0)�Q�这里hello是你的��Y件名�U�ͼ�1.0是版本号�Q�即你的�q�些源程序编译将生成一个��Y件hello-1.0版。然后把 configure.scan文�g的最后一行AC_OUTPUT宏填写完整变成AC_OUTPUT(Makefile)�Q�表明autoconf�?automake最�l�将生成Makefile文�g。最后把configure.scan文�g改名为configure.in。最�l?configure.in文�g内容如下�Q?

dnl Process this file with autoconf to produce a configure script.
AC_INIT(target.c)
AM_INIT_AUTOMAKE(hello, 1.0)
dnl Checks for programs.
AC_PROG_CC

dnl Checks for libraries.

dnl Checks for header files.

dnl Checks for typedefs, structures, and compiler characteristics.

dnl Checks for library functions.

AC_OUTPUT(Makefile)

3、运行aclocal命��o�Q�ls会发现多了一个aclocal.m4文�g�?
4、然后运行autoconf命��o�Q�ls��发现生成了一个可执行的configure命��o�?
5、编辑一个Makefile.am文�g�Q�文件内容如下：
AUTOMAKE_OPTIONS=foreign
bin_PROGRAMS=hello
hello_SOURCES=main.c comm/comm.c comm/comm.h tools/tools.c tools/tools.h db/db.c db/db.h network/network.c network/network.h interface/interface.c interface/interface.h
�q�表明你最后将通过一个make命��o利用上述hello_SOURCES源文件生成一个hello的程序�?
6、运行automake --add-missing命��o。屏�q�提�C�如下：
automake: configure.in: installing `./install-sh'
automake: configure.in: installing `./mkinstalldirs'
automake: configure.in: installing `./missing'
7、然后你可以�q�行之前生成的configure命��o来生成一个Makefile文�g�Q�输�?/configure命��o卛_��?
8、编辑Makefile文�g�Q�找�?(LINK)所在的那一行，本来生成的文件内容如下：
@rm -f hello
$(LINK) $(hello_LDFLAGS) $(hello_OBJECTS) $(hello_LDADD) $(LIBS)
在这两行之间增加几行变成�Q?
@rm -f hello
@mv -f comm.o comm
@mv -f tools.o tools
@mv -f db.o db
@mv -f network.o network
@mv -f interface.o interface
$(LINK) $(hello_LDFLAGS) $(hello_OBJECTS) $(hello_LDADD) $(LIBS)
�q�是因�ؓ默认生成的Makefile��在�~�译后把所有目标文件置于当前目录，而在�q�行链接(link)时又会到各个子目录去扄��应的目标文�g�?
当然�Q��ؓ了完��_��各位在clean部分加上如下一些行�Q?
@rm -f comm/comm.o
@rm -f tools/tools.o
@rm -f db/db.o
@rm -f network/network.o
@rm -f interface/interface.o

好了�Q�经�q�上�q�这些步骤后�Q�现在你可以来编译生成你自己的可执行�E�序了。输入一个make all吧，然后��可以运�?/hello来看你的�E�序�q�行了�?

�q�用autoconf和automake的最大好处是�Q�你的程序以源程序方式发布后�Q�其它所有�h只需要依�ơ输�?
./configure
make
make install
命��o��可以把你的�E�序安装在自��q��电脑上运行了。所有符合GNU标准的UNIX/Linux都不需要再修改Makefile里的��M��字符�?/p> [@more@]

T.S Liu 2008-06-26 15:23 发表评论

autoconf �?automake 生成 Makefile 文�g (�?

T.S Liu — Thu, 26 Jun 2008 04:01:00 GMT

文档选项

未显�C�需�?JavaScript 的文档选项

		��此��作为电子邮件发�?/a>
		样例代码

�U�别�Q?初��

�?��华 (normalnotebook@126.com), Linux 内核研究�?br>�?春艳, 在读研究�?br>

2006 �q?9 �?21 �?/p>

本文介绍了在 linux �pȝ��中，通过 Gnu autoconf �?automake 生成 Makefile 的方法。主要探讨了生成 Makefile 的来龙去脉及其机理，接着详细介绍了配�|?Configure.in 的方法及其规则�?/blockquote>
引子

无论是在Linux�q�是在Unix环境中，make都是一个非帔R��要的�~�译命��o。不��是自己�q�行��目开发还是安装应用��Y�Ӟ��我们都经常要用到make�?make install。利用make工具�Q�我们可以将大型的开发项目分解成为多个更易于��理的模块，对于一个包括几百个源文件的应用�E�序�Q��用make�?makefile工具��可以轻而易丄��理顺各个源文件之间纷�J�复杂的�怺�关系�?/p>
但是如果通过查阅make的帮助文档来手工�~�写Makefile,对�Q何程序员都是一场挑战。幸而有GNU 提供的Autoconf及Automake�q�两套工具��得编写makefile不再是一个难题�?/p>
本文��介�l�如何利�?GNU Autoconf �?Automake �q�两套工��h��协助我们自动产生 Makefile文�g�Q��ƈ且让开发出来的软�g可以像大多数源码包那��P��只需"./configure", "make","make install" ��可以把�E�序安装到系�l�中�?/p>

回页�?/a>

模拟需�?/a>

假设源文件按如下目录存放�Q�如�?所�C�，�q�用autoconf和automake生成makefile文�g�?/p>
�?1文�g目录�l�构

假设src是我们源文�g目录�Q�include目录存放其他库的头文�Ӟ��lib目录存放用到的库文�g�Q�然后开始按模块存放�Q�每个模块都有一个对应的目录�Q�模块下再分子模块，如apple、orange。每个子目录下又分core�Q�include�Q�shell三个目录�Q�其中core和shell目录存放.c文�g�Q�include的存�?h文�g�Q�其他类伹{�?/p>
样例�E�序功能�Q�基于多�U�程的数据读写保护（联系作者获取整个autoconf和automake生成的Makefile工程和源码，E-mail�Q?a href="mailto:normalnotebook@126.com">normalnotebook@126.com�Q��?/p>

回页�?/a>

工具��?/a>

所必须的��Y�Ӟ��autoconf/automake/m4/perl/libtool�Q�其中libtool非必��）�?/p>
autoconf是一个用于生成可以自动地配置软�g源码包，用以适应多种UNIX�cȝ��l�的shell脚本工具�Q�其中autoconf需要用�?m4�Q�便于生成脚本。automake是一个从Makefile.am文�g自动生成Makefile.in的工兗��ؓ了生成Makefile.in�Q�automake�q�需用到perl�Q�由于automake创徏的发布完全遵循GNU标准�Q�所以在创徏中不需要perl。libtool是一�ƾ方便生成各�U�程序库的工兗��?/p>
目前automake支持三种目录层次�Q�flat、shallow和deep�?/p>
1) flat指的是所有文仉��位于同一个目录中�?/p>
��是所有源文�g、头文�g以及其他库文仉��位于当前目录中，且没有子目录。Termutils��是�q�一�c�R�?/p>
2) shallow指的是主要的源代码都储存在顶层目录，其他各个部分则储存在子目录中�?/p>
��是主要源文件在当前目录中，而其它一些实现各部分功能的源文�g位于各自不同的目录。automake本��n��是�q�一�c�R�?/p>
3) deep指的是所有源代码都被储存在子目录中；��层目录主要包含配置信息�?/p>
��是所有源文�g及自己写的头文�g位于当前目录的一个子目录中，而当前目录里没有��M��源文件�?GNU cpio和GNU tar��是�q�一�c�R�?/p>
flat�c�d��是最��单的�Q�deep�c�d��是最复杂的。不隄��出，我们的模拟需求正是基于第三类deep型，也就是说我们要做挑战性的事情�Q?。注�Q�我们的��试�E�序是基于多�U�程的简单程序�?/p>

回页�?/a>

生成 Makefile 的来龙去�?/a>

首先�q�入 project 目录�Q�在该目录下�q�行一�p�d��命��o�Q�创建和修改几个文�g�Q�就可以生成�W�合该��^台的Makefile文�g�Q�操作过�E�如下：

1) �q�行autoscan命��o

2) ��configure.scan 文�g重命名�ؓconfigure.in�Q��ƈ修改configure.in文�g

3) 在project目录下新建Makefile.am文�g�Q��ƈ在core和shell目录下也新徏makefile.am文�g

4) 在project目录下新建NEWS�?README�?ChangeLog 、AUTHORS文�g

5) ��?usr/share/automake-1.X/目录下的depcomp和complie文�g拯��到本目录�?/p>
6) �q�行aclocal命��o

7) �q�行autoconf命��o

8) �q�行automake -a命��o

9) �q�行./confiugre脚本

可以通过�?看出产生Makefile的流�E�，如图所�C�：

�?2生成Makefile��程�?/a>

回页�?/a>

Configure.in的八股文

当我们利用autoscan工具生成confiugre.scan文�g�Ӟ��我们需要将confiugre.scan重命名�ؓconfiugre.in文�g。confiugre.in调用一�p�d��autoconf宏来��试�E�序需要的或用到的�Ҏ��是否存在，以及�q�些�Ҏ��的功能�?/p>
下面我们��来目睹一下confiugre.scan的庐��q��面目�Q?/p>
# Process this file with autoconf to produce a configure script.
            AC_PREREQ(2.59)
            AC_INIT(FULL-PACKAGE-NAME, VERSION, BUG-REPORT-ADDRESS)
            AC_CONFIG_SRCDIR([config.h.in])
            AC_CONFIG_HEADER([config.h])
            # Checks for programs.
            AC_PROG_CC
            # Checks for libraries.
            # FIXME: Replace `main' with a function in `-lpthread':
            AC_CHECK_LIB([pthread], [main])
            # Checks for header files.
            # Checks for typedefs, structures, and compiler characteristics.
            # Checks for library functions.
            AC_OUTPUT
            
每个configure.scan文�g都是以AC_INIT开��_��以AC_OUTPUT�l�束。我们不难从文�g中看出confiugre.in文�g的一般布局�Q?/p>
AC_INIT
            ���试�E�序
            ���试函数�?
            ���试头文�?
            ���试�c�d��定义
            ���试�l�构
            ���试�~�译器特�?
            ���试库函�?
            ���试�pȝ��调用
            AC_OUTPUT
            
上面的调用次序只是徏议性质的，但我们还是强烈徏议不要随意改变对宏调用的�ơ序�?/p>
现在��开始修改该文�g�Q?/p>
$mv configure.scan configure.in
            $vim configure.in
            
修改后的�l�果如下�Q?/p>
            #                                -*- Autoconf -*-
            # Process this file with autoconf to produce a configure script.
            AC_PREREQ(2.59)
            AC_INIT(test, 1.0, normalnotebook@126.com)
            AC_CONFIG_SRCDIR([src/ModuleA/apple/core/test.c])
            AM_CONFIG_HEADER(config.h)
            AM_INIT_AUTOMAKE(test,1.0)
            # Checks for programs.
            AC_PROG_CC
            # Checks for libraries.
            # FIXME: Replace `main' with a function in `-lpthread':
            AC_CHECK_LIB([pthread], [pthread_rwlock_init])
            AC_PROG_RANLIB
            # Checks for header files.
            # Checks for typedefs, structures, and compiler characteristics.
            # Checks for library functions.
            AC_OUTPUT([Makefile
            src/lib/Makefile
            src/ModuleA/apple/core/Makefile
            src/ModuleA/apple/shell/Makefile
            ])
            
其中要将AC_CONFIG_HEADER([config.h])修改为：AM_CONFIG_HEADER(config.h), �q�加入AM_INIT_AUTOMAKE(test,1.0)。由于我们的��试�E�序是基于多�U�程的程序，所以要加入AC_PROG_RANLIB�Q�不然运行automake命��o时会出错。在AC_OUTPUT输入要创建的Makefile文�g名�?/p>
�׃��我们在程序中使用了读写锁�Q�所以需要对库文件进行检查，即AC_CHECK_LIB([pthread], [main])�Q�该宏的含义如下�Q?/p>

其中�Q�LIBS是link的一个选项�Q�详�l�请参看后箋的Makefile文�g。由于我们在�E�序中��用了��d��锁，所以我们测试pthread库中是否存在pthread_rwlock_init函数�?/p>
�׃��我们是基于deep�c�d��来创建makefile文�g�Q�所以我们需要在四处创徏Makefile文�g。即�Q�project目录下，lib目录下，core和shell目录下�?

Autoconf提供了很多内�|�宏来做相关的检��，限于��幅关系�Q�我们在�q�里对其他宏不做详细的解释，具体请参看参考文�?和参考文�?�Q�也可参看autoconf信息��c�?/p>

回页�?/a>

实战Makefile.am

Makefile.am是一�U�比Makefile更高层次的规则。只需指定要生成什么目标，它由什么源文�g生成�Q�要安装��C��么目录等构成�?/p>
表一列出了可执行文�g、静态库、头文�g和数据文�Ӟ��四种书写Makefile.am文�g个一般格式�?/p>
�?1Makefile.am一般格�?/a>

对于可执行文件和静态库�c�d��Q�如果只想编译，不想安装到系�l�中�Q�可以用noinst_PROGRAMS代替bin_PROGRAMS�Q�noinst_LIBRARIES代替lib_LIBRARIES�?/p>
Makefile.am�q�提供了一些全局变量供所有的目标体��用：

�?2 Makefile.am中可用的全局变量

在Makefile.am中尽量��用相对�\径，�pȝ��预定义了两个基本路径�Q?/p>
�?3Makefile.am中可用的路径变量

在上文中我们提到�q�安装�\径，automake讄��了默认的安装路径�Q?/p>
1) 标准安装路径

默认安装路径为：$(prefix) = /usr/local�Q�可以通过./configure --prefix=的方法来覆盖�?/p>
其它的预定义目录�q�包括：bindir = $(prefix)/bin, libdir = $(prefix)/lib, datadir = $(prefix)/share, sysconfdir = $(prefix)/etc�{�等�?/p>
2) 定义一个新的安装�\�?/p>
比如test, 可定义testdir = $(prefix)/test, 然后test_DATA =test1 test2�Q�则test1�Q�test2会作为数据文件安装到$(prefix)/ /test目录下�?/p>
我们首先需要在工程��层目录下（即project/�Q�创��Z��个Makefile.am来指明包含的子目录：
SUBDIRS=src/lib src/ModuleA/apple/shell src/ModuleA/apple/core
            CURRENTPATH=$(shell /bin/pwd)
            INCLUDES=-I$(CURRENTPATH)/src/include -I$(CURRENTPATH)/src/ModuleA/apple/include
            export INCLUDES
            
�׃��每个源文仉��会用到相同的头文�Ӟ��所以我们在最��层的Makefile.am中包含了�~�译源文件时所用到的头文�g�Q��ƈ导出�Q�见蓝色部分代码�?/p>
我们��lib目录下的swap.c文�g�~�译成libswap.a文�g�Q�被apple/shell/apple.c文�g调用�Q�那么lib目录下的Makefile.am如下所�C�：
noinst_LIBRARIES=libswap.a
            libswap_a_SOURCES=swap.c
            INCLUDES=-I$(top_srcdir)/src/includ
            
�l�心的读者可能就会问�Q�怎么�?中给出的是bin_LIBRARIES�Q�而这里是noinst_LIBRARIES�Q�这是因为如果只想编译，而不惛_��装到�pȝ��中，��q��noinst_LIBRARIES代替bin_LIBRARIES�Q�对于可执行文�g��q��noinst_PROGRAMS代替bin_PROGRAMS。对于安装的情况�Q�库��会安装�?(prefix)/lib目录下，可执行文件将会安装到${prefix}/bin。如果想安装该库�Q�则Makefile.am�C�Z��如下�Q?/p>
bin_LIBRARIES=libswap.a
            libswap_a_SOURCES=swap.c
            INCLUDES=-I$(top_srcdir)/src/include
            swapincludedir=$(includedir)/swap
            swapinclude_HEADERS=$(top_srcdir)/src/include/swap.h
            
最后两行的意思是��swap.h安装�?{prefix}/include /swap目录下�?/p>
接下来，对于可执行文件类型的情况�Q�我们将讨论如何写Makefile.am�Q�对于编译apple/core目录下的文�g�Q�我们写成的Makefile.am如下所�C�：
noinst_PROGRAMS=test
            test_SOURCES=test.c
            test_LDADD=$(top_srcdir)/src/ModuleA/apple/shell/apple.o $(top_srcdir)/src/lib/libswap.a
            test_LDFLAGS=-D_GNU_SOURCE
            DEFS+=-D_GNU_SOURCE
            #LIBS=-lpthread
            
�׃��我们的test.c文�g在链接时�Q�需要apple.o和libswap.a文�g�Q�所以我们需要在test_LDADD中包含这两个文�g。对于Linux下的信号�?��d��锁文件进行编译，需要在�~�译选项中指�?D_GNU_SOURCE。所以在test_LDFLAGS中指明。而test_LDFLAGS只是链接时的选项�Q�编译时同样需要指明该选项�Q�所以需要DEFS来指明编译选项�Q�由于DEFS已经有初始��|��所以这里用+=的�Ş式指明。从�q�里可以看出�Q�Makefile.am中的语法与Makefile的语法一��_��也可以采用条件表辑ּ�。如果你的程序还包含其他的库�Q�除了用AC_CHECK_LIB宏来指明外，�q�可以用LIBS来指明�?/p>
如果你只想编译某一个文�Ӟ��那么Makefile.am如何写呢�Q�这个文件也很简单，写法跟可执行文�g的差不多�Q�如下例所�C�：
noinst_PROGRAMS=apple
            apple_SOURCES=apple.c
            DEFS+=-D_GNU_SOURCE
            
我们�q�里只是�ƺ骗automake�Q�假装要生成apple文�g�Q�让它�ؓ我们生成依赖关系和执行命令。所以当你运行完automake命��o后，然后修改apple/shell/下的Makefile.in文�g�Q�直接将LINK语句删除�Q�即�Q?/p>
…….
            clean-noinstPROGRAMS:
            -test -z "$(noinst_PROGRAMS)" || rm -f $(noinst_PROGRAMS)
            apple$(EXEEXT): $(apple_OBJECTS) $(apple_DEPENDENCIES)
            @rm -f apple$(EXEEXT)
            #$(LINK) $(apple_LDFLAGS) $(apple_OBJECTS) $(apple_LDADD) $(LIBS)
            …….
            
通过上述处理�Q�就可以辑ֈ�我们的目的。从�?中不隄��Zؓ什么要修改Makefile.in的原因，而不是修改其他的文�g�?/p>

回页�?/a>

下蝲

名字大小下蝲�Ҏ��

project.rar HTTP

关于下蝲�Ҏ��的信�?/a>

参考资�?

Kurt Wall�Q�张辉译《GNU/Linux�~�程指南�?清华大学出版�C?
Robert Mecklenburg�Q�《GNU Make��目��理�Q�第三版�Q��?东南大学出版�C?2006
http://www.cngnu.org/technology/index.html

T.S Liu 2008-06-26 12:01 发表评论

名字	大小	下蝲�Ҏ��
project.rar		HTTP

Linux�pȝ��下Autoconf/AutoMake学习�W�记

T.S Liu — Thu, 26 Jun 2008 02:31:00 GMT

1、autoscan
　　autoscan是用来扫描源代码目录生成configure.scan文�g的。autoscan可以用目录名做�ؓ参数�Q�但如果你不使用参数的话�Q�那么autoscan��认��Z��用的是当前目录。autoscan��扫描你所指定目录中的源文�Ӟ��q�创建configure.scan文�g�?br>
　　2、configure.scan
　　configure.scan包含�?
　　�pȝ��配置的基本选项�Q�里面都是一些宏定义。我们需要将它改名�ؓconfigure.in

　　3、aclocal
　　aclocal是一个perl脚本�E�序。aclocal�Ҏ��configure.in文�g的内容，自动生成aclocal.m4文�g�?aclocal的定义是�Q?aclocal - create aclocal.m4 by scanning configure.ac"�?br>
　　4、autoconf
　　autoconf是用来��生configure文�g的。configure是一个脚本，它能讄��源程序来适应各种不同的操作系�l��^収ͼ��q�且�Ҏ��不同的系�l�来产生合适的Makefile�Q�从而可以��你的源代码能在不同的操作�pȝ��q�_��上被�~�译出来�?br>
　　configure.in文�g的内�Ҏ��一些宏�Q�这些宏�l�过autoconf处理后会变成��查系�l�特性、环境变量、��Y件必��ȝ��参数的shell脚本。configure.in文�g中的宏的��序�q�没有规定，但是你必��d��所有宏的最前面和最后面分别加上AC_INIT宏和AC_OUTPUT宏�?br>
　　在configure.ini中：

　　#可��C�注释，�q�个宏后面的内容��被忽略�?br>
　　AC_INIT(FILE)

　　�q�个宏用来检查源代码所在的路径�?br>
　　AM_INIT_AUTOMAKE(PACKAGE, VERSION)

　　�q�个宏是必须的，它描�q�C��我们��要生成的��Y件包的名字及其版本号�Q�PACKAGE是��Y件包的名字，VERSION是版本号。当你��用make dist命��o�Ӟ��它会�l�你生成一个类似helloworld-1.0.tar.gz的��Y件发行包�Q�其中就有对应的软�g包的名字和版本号�?br>
　　AC_PROG_CC

　　�q�个宏将��查系�l�所用的C�~�译器�?br>
　　AC_OUTPUT(FILE)

　　�q�个宏是我们要输出的Makefile的名字�?br>
　　我们在��用automake�Ӟ��实际上还需要用到其他的一些宏�Q�但我们可以用aclocal来帮我们自动产生。执行aclocal后我们会得到aclocal.m4文�g�?br>
　　产生了configure.in和aclocal.m4两个宏文件后�Q�我们就可以使用autoconf来��生configure文�g了�?br>
　　5、Makefile.am
　　Makefile.am是用来生成Makefile.in的，需要你手工书写。Makefile.am中定义了一些内容：

　　AUTOMAKE_OPTIONS

　　�q�个是automake的选项。在执行automake�Ӟ��它会��查目录下是否存在标准GNU软�g包中应具备的各种文�g�Q�例如AUTHORS、ChangeLog、NEWS�{�文件。我们将其设�|�成foreign�Ӟ��automake会改用一般��Y件包的标准来��查�?br>
　　bin_PROGRAMS

　　�q�个是指定我们所要��生的可执行文件的文�g名。如果你要��生多个可执行文�g�Q�那么在各个名字间用�I�格隔开�?br>
　　helloworld_SOURCES

　　�q�个是指定��?helloworld"时所需要的源代码。如果它用到了多个源文�g�Q�那么请使用�I�格�W�号��它们隔开。比如需�?helloworld.h�Q�helloworld.c那么请写成helloworld_SOURCES= helloworld.h helloworld.c�?br>
　　如果你在bin_PROGRAMS定义了多个可执行文�g�Q�则对应每个可执行文仉��要定义相对的filename_SOURCES�?br>
　　6、automake
　　我们使用automake --add-missing来��生Makefile.in�?br>
　　选项--add-missing的定义是"add missing standard files to package"�Q�它会让automake加入一个标准的软�g包所必须的一些文件�?br>
　　我们用automake产生出来的Makefile.in文�g是符合GNU Makefile惯例的，接下来我们只要执行configure�q�个shell脚本��可以��生合适的Makefile文�g了�?br>
　　7、Makefile
　　在符合GNU Makefiel惯例的Makefile中，包含了一些基本的预先定义的操作：

　　make

　　�Ҏ��Makefile�~�译源代码，�q�接�Q�生成目标文�Ӟ��可执行文件�?br>
　　make clean

　　清除上次的make命��o所产生的object文�g(后缀�?.o"的文�?及可执行文�g�?br>
　　make install

　　��编译成功的可执行文件安装到�pȝ��目录中，一般�ؓ/usr/local/bin目录�?br>
　　make dist

　　产生发布软�g包文�?即distribution package)。这个命令将会将可执行文件及相关文�g打包成一个tar.gz压羃的文件用来作为发布��Y件的软�g包�?br>
　　它会在当前目录下生成一个名字类�?PACKAGE-VERSION.tar.gz"的文件。PACKAGE和VERSION�Q�是我们在configure.in中定义的AM_INIT_AUTOMAKE(PACKAGE, VERSION)�?br>
　　make distcheck

　　生成发布软�g包�ƈ对其�q�行��试��查，以确定发布包的正��性。这个操作将自动把压�~�包文�g解开�Q�然后执行configure命��o�Q��ƈ且执行make�Q�来��认�~�译不出现错误，最后提�C�Z��软�g包已�l�准备好�Q�可以发布了�?br>
　　distclean

　　�c�M��make clean�Q�但同时也将configure生成的文件全部删除掉�Q�包括Makefile�?/font>

T.S Liu 2008-06-26 10:31 发表评论

T.S Liu — Wed, 25 Jun 2008 03:46:00 GMT

作�ؓLinux下的�E�序开发�h员，大家一定都遇到�q�Makefile�Q�用make命��o来编译自己写的程序确实是很方�ѝ��一般情况下�Q�大安��是手工写一个简单Makefile�Q�如果要惛_��Z��个符合自��p�Y件惯例的Makefile��׃��那么�Ҏ��了�?/font>

　　在本文中�Q�将�l�大家介�l�如何��?nbsp; autoconf和automake两个工具来帮助我们自动地生成�W�合自由软�g惯例的Makefile�Q�这样就可以象常见的GNU�E�序一��P��只要使用“./configure”�Q?#8220;make”�Q?#8220;make instal”��可以把�E�序安装到Linux�pȝ��中去了。这��特别适合惛_��开放源代码软�g的程序开发�h员，又或如果你只是自己写些小的Toy�E�序�Q�那么这个文章对你也会有很大的帮助�?/font>

　　一、Makefile介绍

　　Makefile是用于自动编译和链接的，一个工�E�有很多文�g�l�成�Q�每一个文件的改变都会��D��工程的重新链接，但是不是所有的文�g都需要重新编译，Makefile中纪录有文�g的信息，在make时会军_��在链接的时候需要重新编译哪些文件�?/font>

　　Makefile的宗旨就是：让编译器知道要编译一个文仉��要依赖其他的哪些文�g。当那些依赖文�g有了改变�Q�编译器会自动的发现最�l�的生成文�g已经�q�时�Q�而重新编译相应的模块�?/font>

　　Makefile的基本结构不是很复杂�Q�但当一个程序开发�h员开始写Makefile�Ӟ��l�常会怀疑自己写的是否符合惯例，而且自己写的Makefile�l�常和自��q��开发环境相兌��Q�当�pȝ��环境变量或�\径发生了变化后，Makefile可能�q�要跟着修改。这样就造成了手工书写Makefile的诸多问题，automake恰好能很好地帮助我们解决�q�些问题�?/font>

　　使用automake�Q�程序开发�h员只需要写一些简单的含有预定义宏的文�Ӟ��由autoconf�Ҏ��一个宏文�g生成configure�Q�由automake�Ҏ��另一个宏文�g生成Makefile.in�Q�再使用configure依据Makefile.in来生成一个符合惯例的Makefile。下面我们将详细介绍Makefile的automake生成�Ҏ��?/font>

　　二、��用的环境

　　本文所提到的程序是��Z��Linux发行版本�Q�Fedora Core release 1�Q�它包含了我们要用到的autoconf�Q�automake�?/font>

　　三、从helloworld入手

　　我们从大家最�怋�用的例子�E�序helloworld开始�?/font>

　　下面的过�E�如果简单地说来��是�Q?/font>

　　新徏三个文�g�Q?/font>

　　　helloworld.c
　　　configure.in
　　　Makefile.am

　　然后执行�Q?/font>

aclocal; autoconf; automake --add-missing; ./configure; make; ./helloworld

　　��可以看到Makefile被��生出来，而且可以��helloworld.c�~�译通过�?/font>

很简单吧�Q�几条命令就可以做出一个符合惯例的Makefile�Q�感觉如何呀�?/font>

　　现在开始介�l�详�l�的�q�程�Q?/font>

　　1、徏目录

　　在你的工作目录下��Z��个helloworld目录�Q�我们用它来存放helloworld�E�序及相��x��Ӟ��如在/home/my/build下：

$ mkdir helloword
$ cd helloworld

　　2�?helloworld.c

　　然后用你自己最喜欢的编辑器写一个hellowrold.c文�g�Q�如命��o�Q�vi helloworld.c。��用下面的代码作�ؓhelloworld.c的内宏V�?/font>

int main(int argc, char** argv)
{
printf("Hello, Linux World!\n");
return 0;
}

　　完成后保存退出�?/font>

　　现在在helloworld目录下就应该有一个你自己写的helloworld.c了�?/font>

　　3、生成configure

　　我们使用autoscan命��o来帮助我们根据目录下的源代码生成一个configure.in的模板文件�?/font>

　　命��o�Q?/font>

$ autoscan
$ ls
configure.scan helloworld.c

　　执行后在hellowrold目录下会生成一个文�Ӟ��configure.scan�Q�我们可以拿它作为configure.in的蓝本�?/font>

　　现在��configure.scan改名为configure.in�Q��ƈ且编辑它�Q�按下面的内容修改，��L��无关的语句：

============================configure.in内容开�?========================================
# -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.

AC_INIT(helloworld.c)
AM_INIT_AUTOMAKE(helloworld, 1.0)

# Checks for programs.
AC_PROG_CC

AC_PROG_CC

# Checks for libraries.

# Checks for header files.

# Checks for typedefs, structures, and compiler characteristics.

# Checks for library functions.
AC_OUTPUT(Makefile)
============================configure.in内容�l�束=========================================

　　然后执行命��oaclocal和autoconf�Q�分别会产生aclocal.m4及configure两个文�g�Q?/font>

$ aclocal
$ls
aclocal.m4 configure.in helloworld.c
$ autoconf
$ ls
aclocal.m4 autom4te.cache configure configure.in helloworld.c

　　大家可以看到configure.in内容是一些宏定义�Q�这些宏�l�autoconf处理后会变成��查系�l�特性、环境变量、��Y件必��ȝ��参数的shell脚本�?/font>

　　autoconf 是用来生成自动配�|��Y件源代码脚本�Q�configure�Q�的工具。configure脚本能独立于autoconf�q�行�Q�且在运行的�q�程中，不需要用��L��q�预�?/p>

　　要生成configure文�g�Q�你必须告诉autoconf如何扑ֈ�你所用的宏。方式是使用aclocal�E�序来生成你的aclocal.m4�?/p>

　　aclocal�Ҏ��configure.in文�g的内容，自动生成aclocal.m4文�g。aclocal是一个perl 脚本�E�序�Q�它的定义是�Q?#8220;aclocal - create aclocal.m4 by scanning configure.ac”�?/p>

　　autoconf从configure.in�q�个列�D�~�译软�g时所需要各�U�参数的模板文�g中创建configure�?/p>

　　autoconf需要GNU m4宏处理器来处理aclocal.m4�Q�生成configure脚本�?/p>

　　m4是一个宏处理器。将输入拯��到输出，同时��宏展开。宏可以是内嵌的�Q�也可以是用户定义的。除了可以展开宏，m4�q�有一些内建的函数�Q�用来引用文�Ӟ��执行命��o�Q�整数运��，文本操作�Q��@环等。m4既可以作为编译器的前端，也可以单独作��Z��个宏处理器�?/p>

4、新建Makefile.am

　　新徏Makefile.am文�g�Q�命令：

$ vi Makefile.am

　　内容如下:

AUTOMAKE_OPTIONS=foreign
bin_PROGRAMS=helloworld
helloworld_SOURCES=helloworld.c

　　automake会根据你写的Makefile.am来自动生成Makefile.in�?/p>

　　Makefile.am中定义的宏和目标,会指导automake生成指定的代码。例如，宏bin_PROGRAMS��导致编译和�q�接的目标被生成�?/p>

　　5、运行automake

　　命��o�Q?/p>

$ automake --add-missing
configure.in: installing `./install-sh'
configure.in: installing `./mkinstalldirs'
configure.in: installing `./missing'
Makefile.am: installing `./depcomp'

　　automake会根据Makefile.am文�g产生一些文�Ӟ��包含最重要的Makefile.in�?/p>

　　6、执行configure生成Makefile

$ ./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: executing depfiles commands
$ ls -l Makefile
-rw-rw-r-- 1 yutao yutao 15035 Oct 15 10:40 Makefile

　　你可以看刎ͼ�此时Makefile已经产生出来了�?/p>

　　7、��用Makefile�~�译代码

$ make
if gcc -DPACKAGE_NAME="" -DPACKAGE_TARNAME="" -DPACKAGE_VERSION="" -

DPACKAGE_STRING="" -DPACKAGE_BUGREPORT="" -DPACKAGE="helloworld" -DVERSION="1.0"

-I. -I. -g -O2 -MT helloworld.o -MD -MP -MF ".deps/helloworld.Tpo" \
-c -o helloworld.o `test -f 'helloworld.c' || echo './'`helloworld.c; \
then mv -f ".deps/helloworld.Tpo" ".deps/helloworld.Po"; \
else rm -f ".deps/helloworld.Tpo"; exit 1; \
fi
gcc -g -O2 -o helloworld helloworld.o

�q�行helloworld

$ ./helloworld
Hello, Linux World!

　　�q�样helloworld��q��译出来了�Q�你如果按上面的步骤来做的话�Q�应该也会很�Ҏ��地编译出正确的helloworld文�g。你�q�可以试着使用一些其他的make命��o�Q�如make clean�Q�make install�Q�make dist�Q�看看它们会�l�你什么样的效果。感觉如何？自己也能写出�q�么专业的Makefile�Q�老板一定会对你刮目相看�?br>四、深入浅�?/p>

　　针对上面提到的各个命令，我们再做些详�l�的介绍�?/p>

　　1�?autoscan

　　autoscan是用来扫描源代码目录生成configure.scan文�g的。autoscan可以用目录名做�ؓ参数�Q�但如果你不使用参数的话�Q�那么autoscan��认��Z��用的是当前目录。autoscan��扫描你所指定目录中的源文�Ӟ��q�创建configure.scan文�g�?/p>

　　2�?configure.scan

　　configure.scan包含�?nbsp;

�pȝ��配置的基本选项�Q�里面都是一些宏定义。我们需要将它改名�ؓconfigure.in

　　3�?aclocal

　　aclocal是一个perl 脚本�E�序。aclocal�Ҏ��configure.in文�g的内容，自动生成aclocal.m4文�g。aclocal的定义是�Q?#8220;aclocal - create aclocal.m4 by scanning configure.ac”�?/p>

　　4�?autoconf

　　autoconf是用来��生configure文�g的。configure是一个脚本，它能讄��源程序来适应各种不同的操作系�l��^収ͼ��q�且�Ҏ��不同的系�l�来产生合适的Makefile�Q�从而可以��你的源代码能在不同的操作�pȝ��q�_��上被�~�译出来�?/p>

　　configure.in文�g的内�Ҏ��一些宏�Q�这些宏�l�过autoconf 处理后会变成��查系�l�特性、环境变量、��Y件必��ȝ��参数的shell脚本。configure.in文�g中的宏的��序�q�没有规定，但是你必��d��所有宏的最前面和最后面分别加上AC_INIT宏和AC_OUTPUT宏�?/p>

　　在configure.ini中：

　　#可��C�注释，�q�个宏后面的内容��被忽略�?/p>

　　AC_INIT(FILE)

　　�q�个宏用来检查源代码所在的路径�?/p>

AM_INIT_AUTOMAKE(PACKAGE, VERSION)

　　�q�个宏是必须的，它描�q�C��我们��要生成的��Y件包的名字及其版本号�Q�PACKAGE是��Y件包的名字，VERSION是版本号。当你��用make dist命��o�Ӟ��它会�l�你生成一个类似helloworld-1.0.tar.gz的��Y件发行包�Q�其中就有对应的软�g包的名字和版本号�?/p>

AC_PROG_CC

　　�q�个宏将��查系�l�所用的C�~�译器�?/p>

AC_OUTPUT(FILE)

　　�q�个宏是我们要输出的Makefile的名字�?/p>

　　我们在��用automake�Ӟ��实际上还需要用到其他的一些宏�Q�但我们可以用aclocal 来帮我们自动产生。执行aclocal后我们会得到aclocal.m4文�g�?/p>

　　产生了configure.in和aclocal.m4 两个宏文件后�Q�我们就可以使用autoconf来��生configure文�g了�?/p>

　　5�?Makefile.am

　　Makefile.am是用来生成Makefile.in的，需要你手工书写。Makefile.am中定义了一些内容：

AUTOMAKE_OPTIONS

　　�q�个是automake的选项。在执行automake�Ӟ��它会��查目录下是否存在标准GNU软�g包中应具备的各种文�g�Q�例如AUTHORS、ChangeLog、NEWS�{�文件。我们将其设�|�成foreign�Ӟ��automake会改用一般��Y件包的标准来��查�?/p>

bin_PROGRAMS

　　�q�个是指定我们所要��生的可执行文件的文�g名。如果你要��生多个可执行文�g�Q�那么在各个名字间用�I�格隔开�?/p>

helloworld_SOURCES

　　�q�个是指定��?#8220;helloworld”时所需要的源代码。如果它用到了多个源文�g�Q�那么请使用�I�格�W�号��它们隔开。比如需要helloworld.h�Q�helloworld.c那么请写成helloworld_SOURCES= helloworld.h helloworld.c�?/p>

　　如果你在bin_PROGRAMS定义了多个可执行文�g�Q�则对应每个可执行文仉��要定义相对的filename_SOURCES�?/p>

　　6�?automake

　　我们使用automake --add-missing来��生Makefile.in�?/p>

　　选项--add-missing的定义是“add missing standard files to package”�Q�它会让automake加入一个标准的软�g包所必须的一些文件�?/p>

　　我们用automake产生出来的Makefile.in文�g是符合GNU Makefile惯例的，接下来我们只要执行configure�q�个shell 脚本��可以��生合适的 Makefile 文�g了�?/p>

　　7�?Makefile

　　在符合GNU Makefiel惯例的Makefile中，包含了一些基本的预先定义的操作：

make

　　�Ҏ��Makefile�~�译源代码，�q�接�Q�生成目标文�Ӟ��可执行文件�?/p>

make clean

　　清除上次的make命��o所产生的object文�g�Q�后�~��?#8220;.o”的文�Ӟ��及可执行文�g�?/p>

make install

　　��编译成功的可执行文件安装到�pȝ��目录中，一般�ؓ/usr/local/bin目录�?/p>

make dist

　　产生发布软�g包文�Ӟ��即distribution package�Q�。这个命令将会将可执行文件及相关文�g打包成一个tar.gz压羃的文件用来作为发布��Y件的软�g包�?/p>

　　它会在当前目录下生成一个名字类�?#8220;PACKAGE-VERSION.tar.gz”的文件。PACKAGE和VERSION�Q�是我们在configure.in中定义的AM_INIT_AUTOMAKE(PACKAGE, VERSION)�?/p>

make distcheck

　　生成发布软�g包�ƈ对其�q�行��试��查，以确定发布包的正��性。这个操作将自动把压�~�包文�g解开�Q�然后执行configure命��o�Q��ƈ且执行make�Q�来��认�~�译不出现错误，最后提�C�Z��软�g包已�l�准备好�Q�可以发布了�?/p>

===============================================
helloworld-1.0.tar.gz is ready for distribution
===============================================
make distclean

　　�c�M��make clean�Q�但同时也将configure生成的文件全部删除掉�Q�包括Makefile�?/p>

　　五、结束语

　　通过上面的介�l�，你应该可以很�Ҏ��地生成一个你自己的符合GNU惯例的Makefile文�g及对应的��目文�g�?/p>

　　如果你想写出更复杂的且符合惯例的Makefile�Q�你可以参考一些开放代码的��目中的configure.in和Makefile.am文�g�Q�比如：嵌入式数据库sqlite�Q�单元测试cppunit�?/p>

T.S Liu 2008-06-25 11:46 发表评论