色综合久久中文色婷婷,久久精品国产亚洲AV嫖农村妇女,国产高潮国产高潮久久久91

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 发表评论