HQY 一个和谐有爱的空间

automake/autoconf入门

一、Makefile介绍

Makefile是用于自动编译和链接的，一个工程有很多文件组成，每一个文件的改变都会导致工程的重新链接，但不是所有的文件都需重新编译，Makefile中纪录有文件的信息，在make时会决定在链接的时候需要重新编译哪些文件。
    Makefile的宗旨就是：让编译器知道要编译一个文件需要依赖其他的哪些文件。当那些依赖文件有了改变，编译器会自动的发现最终的生成文件已经过时，而重新编译相应的模块。
    使用automake，程序开发人员只需要写一些 简单的含有预定义宏的文件，由autoconf根据一个宏文件生成configure，由automake根据另一个宏文件生成Makefile.in， 再使用configure依据Makefile.in来生成一个符合惯例的Makefile。下面我们将详细介绍Makefile的automake生成方法。

二、从helloworld入手

下面的过程如果简单地说来就是：新建三个文件：
helloworld.c    configure.in       Makefile.am
    然后执行：
    aclocal；autoconf；automake --add-missing； . /configure；make； ./helloworld
就可以看到Makefile被产生出来，而且可以将helloworld.c编译通过。
    现在开始介绍详细的过程：
1、建目录：工作目录下建一个helloworld目录，用它来存放helloworld程序及相关文件，如在/home/my/build下：
$ mkdir helloword
$ cd helloworld
2、 helloworld.c
    然后编辑器写一个hellowrold.c文件，如命令：vi helloworld.c。使用下面的代码作为helloworld.c的内容。
int main(int argc, char** argv)
{
printf("Hello, Linux World!\n");
return 0;
}
完成后保存退出。
3、生成configure
    autoscan：autoscan是用来扫描源代码目录生成configure.scan文件的。autoscan可以用目录名做为参数，但如果你不使用参数的话，那么 autoscan将认为使用的是当前目录。autoscan将扫描你所指定目录中的源文件，并创建configure.scan文件。configure.scan：configure.scan包含了系统配置的基本选项，里面都是一些宏定义。我们需要将它改名为configure.in

使用autoscan命令来帮助我们根据目录下的源代码生成一个configure.in的模板文件。命令：
$ autoscan
$ ls
configure.scan helloworld.c
    执行后在hellowrold目录下会生成一个文件：configure.scan，我们可以拿它作为configure.in的蓝本。
    现在将configure.scan改名为configure.in，并且编辑它，按下面的内容修改，去掉无关的语句：
============================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

# Checks for libraries.

# Checks for header files.

# Checks for typedefs, structures, and compiler characteristics.

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

然后执行命令aclocal和autoconf，分别会产生aclocal.m4及configure两个文件：
    aclocal：aclocal是一个perl 脚本程序。aclocal根据configure.in文件的内容，自动生成aclocal.m4文件。aclocal的定义是：“aclocal - create aclocal.m4 by scanning configure.ac”。
    autoconf：autoconf是用来产生configure文件的。configure是一个脚本，它能设置源程序来适应各种不同的操作系统平台，并且根据不同的系统来产生合适的Makefile，从而可以使你的源代码能在不同的操作系统平台上被编译出来。
    configure.in文件的内容是一些宏，这些宏经过autoconf 处理后会变成检查系统特性、环境变量、软件必须的参数的shell脚本。configure.in文件中的宏的顺序并没有规定，但是你必须在所有宏的最前面和最后面分别加上AC_INIT宏和AC_OUTPUT宏。在configure.ini中：#号表示注释，这个宏后面的内容将被忽略。
    AC_INIT(FILE)：这个宏用来检查源代码所在的路径。
    AM_INIT_AUTOMAKE(PACKAGE, VERSION) ：这个宏是必须的，它描述了我们将要生成的软件包的名字及其版本号：PACKAGE是软件包的名字，VERSION是版本号。当你使用make dist命令时，它会给你生成一个类似helloworld-1.0.tar.gz的软件发行包，其中就有对应的软件包的名字和版本号。
    AC_PROG_CC：这个宏将检查系统所用的C编译器。
    AC_OUTPUT(FILE)：这个宏是我们要输出的Makefile的名字。
我们在使用automake时，实际上还需要用到其他的一些宏，但我们可以用aclocal 来帮我们自动产生。执行aclocal后我们会得到aclocal.m4文件。产生了configure.in和aclocal.m4 两个宏文件后，我们就可以使用autoconf来产生configure文件了。

$ aclocal
$ls
aclocal.m4 configure.in helloworld.c
$ autoconf
$ ls
aclocal.m4 autom4te.cache configure configure.in helloworld.c
    大家可以看到configure.in内容是一些宏定义，这些宏经autoconf处理后会变成检查系统特性、环境变量、软件必须的参数的shell脚本。autoconf 是用来生成自动配置软件源代码脚本（configure）的工具。configure脚本能独立于autoconf运行，且在运行的过程中，不需要用户的干预。要生成configure文件，必须告诉autoconf如何找到你所用的宏。方式是使用aclocal程序来生成你的aclocal.m4。aclocal根据configure.in文件的内容，自动生成aclocal.m4文件。aclocal是一个perl 脚本程序，它的定义是：“aclocal - create aclocal.m4 by scanning configure.ac”。
    autoconf从configure.in这个列举编译软件时所需要各种参数的模板文件中创建configure。autoconf需要GNU m4宏处理器来处理aclocal.m4，生成configure脚本。
    m4是一个宏处理器。将输入拷贝到输出，同时将宏展开。宏可以是内嵌的，也可以是用户定义的。除了可以展开宏，m4还有一些内建的函数，用来引用文件，执行命令，整数运算，文本操作，循环等。m4既可以作为编译器的前端，也可以单独作为一个宏处理器。
4、新建Makefile.am

Makefile.am：Makefile.am是用来生成Makefile.in的，需要你手工书写。Makefile.am中定义了一些内容：
    AUTOMAKE_OPTIONS：这个是automake的选项。在执行automake时，它会检查目录下是否存在标准GNU软件包中应具备的各种文件，例如AUTHORS、ChangeLog、NEWS等文件。我们将其设置成foreign时，automake会改用一般软件包的标准来检查。有foreign\gun\gnits三个软件等级，foreign只检测必须的文件。
    bin_PROGRAMS：这个是指定我们所要产生的可执行文件的文件名。如果你要产生多个可执行文件，那么在各个名字间用空格隔开。

helloworld_SOURCES：这个是指定产生“helloworld”时所需要的源代码。如果它用到了多个源文件，那么请使用空格符号将它们隔开。比如需要 helloworld.h，helloworld.c那么请写成helloworld_SOURCES= helloworld.h helloworld.c。
    如果你在bin_PROGRAMS定义了多个可执行文件，则对应每个可执行文件都要定义相对的filename_SOURCES。
命令：
$ vi Makefile.am
    内容如下:
AUTOMAKE_OPTIONS=foreign
bin_PROGRAMS=helloworld
helloworld_SOURCES=helloworld.c
    automake会根据你写的Makefile.am来自动生成Makefile.in。

Makefile.am中定义的宏和目标,会指导automake生成指定的代码。例如，宏bin_PROGRAMS将导致编译和连接的目标被生成。
5、运行automake

automake：我们使用automake --add-missing来产生Makefile.in。选项--add-missing的定义是“add missing standard files to package”，它会让automake加入一个标准的软件包所必须的一些文件。我们用automake产生出来的Makefile.in文件是符合GNU Makefile惯例的，接下来我们只要执行configure这个shell 脚本就可以产生合适的 Makefile 文件了。
命令：
$ automake --add-missing
configure.in: installing `./install-sh'
configure.in: installing `./mkinstalldirs'
configure.in: installing `./missing'
Makefile.am: installing `./depcomp'
    automake会根据Makefile.am文件产生一些文件，包含最重要的Makefile.in。
6、执行configure生成Makefile
$ ./configure
$ ls -l Makefile
-rw-rw-r-- 1 yutao yutao 15035 Oct 15 10:40 Makefile

此时Makefile已经产生出来了。Makefile：在符合GNU Makefiel惯例的Makefile中，包含了一些基本的预先定义的操作：
    make：根据Makefile编译源代码，连接，生成目标文件，可执行文件。
    make clean：清除上次的make命令所产生的object文件（后缀为“.o”的文件）及可执行文件。
    make install：将编译成功的可执行文件安装到系统目录中，一般为/usr/local/bin目录。
    make dist：产生发布软件包文件（即distribution package）。这个命令将会将可执行文件及相关文件打包成一个tar.gz压缩的文件用来作为发布软件的软件包。它会在当前目录下生成一个名字类似“PACKAGE-VERSION.tar.gz”的文件。PACKAGE和VERSION，是我们在configure.in中定义的AM_INIT_AUTOMAKE(PACKAGE, VERSION)。
    make distcheck：生成发布软件包并对其进行测试检查，以确定发布包的正确性。这个操作将自动把压缩包文件解开，然后执行configure命令，并且执行make，来确认编译不出现错误，最后提示你软件包已经准备好，可以发布了。
    make distclean：类似make clean，但同时也将configure生成的文件全部删除掉，包括Makefile。
7、使用Makefile编译代码
$ make

运行helloworld
$ ./helloworld
Hello, Linux World!

想写出更复杂的且符合惯例的Makefile，可参考一些开放代码的项目中的configure.in和Makefile.am文件，比如：嵌入式数据库sqlite，单元测试cppunit。

利用libtool自动生成动态库的Makefile的生成方法

 利用libtool自动生成动态库

1. autoscan命令在当前目录生成configure.scan文件, 内容为:

# -*- Autoconf -*-

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

AC_PREREQ(2.57)

AC_INIT(FULL-PACKAGE-NAME, VERSION, BUG-REPORT-ADDRESS)

AC_CONFIG_SRCDIR([src/bot.h])

AC_CONFIG_HEADER([config.h])

# Checks for programs.

AC_PROG_CXX

AC_PROG_CC

# Checks for libraries.

# 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_OUTPUT

将其该名为configure.ac 然后修改:

configure.ac 文件是 autoconf 的输入文件，经过 autoconf 处理，展开里面的 m4宏，输出的是 configure 脚本。
第 4 行声明本文件要求的 autoconf 版本，因为本例使用了新版本 2.57，所以在此注明。

第 5 行 AC_INIT 宏用来定义软件的名称和版本等信息

AC_INIT([test], 1.0, [email]linhanzu@gmail.com[/email])

增加版本信息(为生成lib库做准备)

lt_major=1

lt_age=1

lt_revision=12

dist_version=0.1.12

AM_INIT_AUTOMAKE(test, $dist_version) //自动生成Makefile文件

增加宏, 打开共享库

AC_PROG_LIBTOOL

# Check for dl  

DL_PRESENT=""

AC_CHECK_LIB( dl, dlopen, DL_PRESENT="yes",, $DL_LIBS -ldl )

if test "x$DL_PRESENT" = "xyes"; then

AC_DEFINE(HAVE_LIBDL, 1, [Define if DL lib is present])

DL_LIBS="-ldl"

AC_SUBST(DL_LIBS)

fi

# Check for libm

M_PRESENT=""

AC_CHECK_LIB( m, sin, M_PRESENT="yes",, $M_LIBS -lm )

if test "x$M_PRESENT" = "xyes"; then

AC_DEFINE(HAVE_LIBM, 1, [Define if libm is present])

M_LIBS="-lm"

AC_SUBST(M_LIBS)

fi

增加依赖库，这里就仅仅列举了pthread库，生成的Makefile会自动加上-pthread

# Check for pthread

PTHREAD_PRESENT=""

AC_CHECK_LIB( pthread, pthread_create, PTHREAD_PRESENT="yes",, $PTHREAD_LIBS-lpthread )

if test "x$PTHREAD_PRESENT" = "xyes"; then

AC_DEFINE(HAVE_LIBPTHREAD, 1, [Define if libpthread is present])

PTHREAD_LIBS="-lpthread"

AC_SUBST(PTHREAD_LIBS)

fi

要生成项目工程目录和其它目录下的Makefile 文件, 必需加入

AM_CONFIG_FILES的宏:

例如: AC_CONFIG_FILES([Makefile

                     src/Makefile

                     data/Makefile

                     docs/Makefile])

修改完后Makefile.ac如下:

# -*- Autoconf -*-

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

AC_PREREQ(2.57)

AC_INIT([test],[1.0],[[email]arne_caspari@users.sourceforge.net[/email]])

AM_CONFIG_HEADER(config.h)

lt_major=1

lt_age=1

lt_revision=12

dist_version=0.1.12

AM_INIT_AUTOMAKE(test, $dist_version)

AC_SUBST(lt_major)

AC_SUBST(lt_revision)

AC_SUBST(lt_age)

# Checks for programs.

#AC_PROG_CC

#AC_PROG_INSTALL

#AC_PROG_LN_S

#AC_PROG_LIBTOOL

AM_PROG_LIBTOOL

# Checks for libraries.

pkg_modules="gtk+-2.0 >= 2.0.0"

PKG_CHECK_MODULES(GTK_PACKAGE, [$pkg_modules], HAVE_GTK2="yes", HAVE_GTK2="no" )

AC_SUBST(GTK_PACKAGE_CFLAGS)

AC_SUBST(GTK_PACKAGE_LIBS)

# Check for dl

DL_PRESENT=""

AC_CHECK_LIB( dl, dlopen, DL_PRESENT="yes",, $DL_LIBS -ldl )

if test "x$DL_PRESENT" = "xyes"; then

AC_DEFINE(HAVE_LIBDL, 1, [Define if DL lib is present])

DL_LIBS="-ldl"

AC_SUBST(DL_LIBS)

fi

# Check for libm

M_PRESENT=""

AC_CHECK_LIB( m, sin, M_PRESENT="yes",, $M_LIBS -lm )

if test "x$M_PRESENT" = "xyes"; then

AC_DEFINE(HAVE_LIBM, 1, [Define if libm is present])

M_LIBS="-lm"

AC_SUBST(M_LIBS)

fi

# Check for pthread 

PTHREAD_PRESENT=""

AC_CHECK_LIB( pthread, pthread_create, PTHREAD_PRESENT="yes",, $PTHREAD_LIBS

-lpthread )

if test "x$PTHREAD_PRESENT" = "xyes"; then

AC_DEFINE(HAVE_LIBPTHREAD, 1, [Define if libpthread is present])

PTHREAD_LIBS="-lpthread"

AC_SUBST(PTHREAD_LIBS)

fi

# Checks for header files.

#AC_HEADER_DIRENT

#AC_HEADER_STDC

#AC_CHECK_HEADERS([fcntl.h stdlib.h string.h sys/time.h unistd.h])

# Checks for typedefs, structures, and compiler characteristics.

#AC_TYPE_PID_T

#AC_TYPE_SIZE_T

#AC_HEADER_TIME

# Checks for library functions.

#AC_FUNC_CLOSEDIR_VOID

#AC_FUNC_MALLOC

#AC_CHECK_FUNCS([memset strstr])

AC_CONFIG_FILES([Makefile

             src/Makefile

             data/Makefile

             doc/Makefile])

AC_OUTPUT

2.生成各目录下的Makefile.am文件

./Makefile.am   //工程目录下

  SUBDIR = src data doc

../src/Makefile.am  //源码目录下

  MAINTAINERCLEANFILES = Makefile.in

   INCLUDES = -I../include  

   CPPFLAGS=-DINSTALL_PREFIX="\"$(prefix)\""
   lib_LTLIBRARIES = libtest.la
   libtest_la_LDFLAGS = -version-info @lt_major@:@lt_revision@:@lt_age@

   libtest_la_SOURCES = \

                      test.c \

                      test_private.h \

                      check_match.c \

                      check_match.h \

                      test_helpers.c \

                      test_helpers.h \

                      debug.h

    libtest_la_LIBADD = \

                      @DL_LIBS@ \

                      @M_LIBS@

3. 生成autogen.sh脚本, 内容

#! /bin/sh

set -x

aclocal

autoheader

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

autoconf

保存后修改权限 chmod a+x autogen.sh

3.运行脚本./autogen.sh, 生成configure脚本. 这里可能会遇到错误, 可以根据错误提示作相应修改.（注意：如果您修改了Makefile.am中的项，那么就得重新执行这一步）

4.运行./configure脚本.自动生成src目录下的makefile文件

5. 切换到目录src, 运行make 自动在当前目录下建立.libs文件, 编程生成的库文件就保存在该目录下.

    make install 安装在默认目录 /usr/local/lib/下.

6.如果要生成其它的安装目录，Makefile.am就要这样写

MAINTAINERCLEANFILES = Makefile.in

INCLUDES = -I../include 

lib_LTLIBRARIES = libtt.la

libdir = $(prefix)/lib/test  //这个就是安装目录

libtt_la_LDFLAGS = -version-info @lt_major@:@lt_revision@:@lt_age@

libtt_la_LIBADD = @PTHREAD_LIBS@

libtt_la_SOURCES = \

                tt.c \

                video.c \

                video.h

当然，Makefile中的语法规则中还有很多宏定义，您可以在Makefile的官方网站找到说明。

借用Wei Mingzhi <whistler_wmz@users.sf.net> 开发的麻将游戏来进行演示autotools的应用

最终的 configure.ac 文件

# -*- Autoconf -*-

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

AC_PREREQ(2.59)                    //显示autoconf 版本2.59

AC_INIT([majiang], [1.0])              // AC_INIT 宏必须放在开头位置，定义软件的名称和版本等信息

AC_CONFIG_SRCDIR([src/main.cpp])    //侦测所指定的源码文件是否存在，来确定源码目录的有效性。

AC_CONFIG_HEADER([config.h])       //生成 config.h 文件，里面存放 configure 脚本侦测到的信息。

AC_CANONICAL_HOST

AC_CANONICAL_TARGET

AM_INIT_AUTOMAKE              //使用 automake 产生Makefile.in文件。

# 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可以用来检测库

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,                             //定义debug 调试选项。

[ --enable-debug turn on debug],

CXXFLAGS="$CXXFLAGS -g3 -D_DEBUG=1")

AC_CONFIG_FILES([Makefile                         //指明要输出 Makefile

src/Makefile

data/Makefile

docs/Makefile

fonts/Makefile

images/Makefile

music/Makefile

sound/Makefile])

AC_OUTPUT

SDL 库的侦测

这个麻将游戏是基于 SDL 库开发的，一般系统默认不会安装，因此 configure 脚本的一

个任务就是检查用户的系统中是否有该软件包。

autoconf 提供了很多宏可以实现侦测功能，但首先应该查看 SDL 软件包是否已经提供相

应的宏。通过 pkgsrc 的工具可以看到:

$ pkg_info -L SDL|grep m4

/usr/pkg/share/aclocal/sdl.m4

即 SDL 软件包提供了一个 sdl.m4 宏，放在系统的 aclocal 目录下。

在这个宏文件的注释中说明了使用的方法:

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 库以

后，该宏还输出 SDL_CFLAGS 和 SDL_LIBS 编译连接选项，它们实际上就是调用

`sdl-config --cflags` 和 `sdl-config --libs`。

于是在 configure.ac 里面加入 AM_PATH_SDL 宏

# 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，于是 MINIMUM-VERSION 就设为 1.2.0。如果在系统中侦测到

需要的库，没什么额外的操作，假如没有找到，则给出错误信息。

AM_PATH_SDL 输出 SDL_CFLAGS 和 SDL_LIBS 编译参数，需要添加到 src/Makefile.am 里面:

mj_CPPFLAGS = @SDL_CFLAGS@

mj_LDFLAGS = @SDL_LIBS@

用 `@' 包围的变量会在 configure 执行时被替换。

从 mahjong 的 Makefile 中看到，这个软件还要使用 SDL_image、SDL_mixser 和

SDL_ttf 库，但它们不属于 SDL 软件包，需要另外安装。由于这些库在 sdl.m4 中也没

有进行侦测，所以自己要写一些脚本。

autotools 提供了一个 AC_CHECK_LIB 宏可以用来检测库，现在就使用它来检测这几个SDL 库。该宏的语法为:

AC_CHECK_LIB (LIBRARY, FUNCTION, [ACTION-IF-FOUND],

[ACTION-IF-NOT-FOUND], [OTHER-LIBRARIES])

第一个参数是库名，第二个参数是库中的一个函数，第三个参数是检测到以后进行的动作

，第四个参数是未检测到以后的动作，第五个参数是其他的库。

对于 SDL_image、SDL_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`)

软件使用的数据文件

原来 mj 读取数据是从执行时目录的子目录中读取，但现在将数据放到 $prefix/share/majiang 目录下，需要通过一种途径让程序可以知道数据文件被安放的位置。

要达到这个目的有很多方法，这里采用最直接的一种：将数据文件安装目录变量通过CPPFLAGS 编译参数传递给程序。于是修改 src/Makefile.am 的 CPPFLAGS:

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

相应地修改 src 目录下的源码，在读取数据文件的地方，将读取的路径改成 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 第 22 行定义了 debug 调试选项，虽然也可以照样放到 src/Makefile.am 的 CPPFLAGS 里面实现，但 autotools 提供了一种更灵活的机制。

configure 脚本可以通过选项来设置编译参数，现增加一个 --enable-debug 选项，需要DEBUG 时，在命令行上加上它来打开，默认则关闭。这项功能是使用 AC_ARG_ENABLE 宏实现:

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

[ACTION-IF-NOT-GIVEN])

其中 FEATURE 是名称，HELP_STRING 为说明信息，在使用 ./configure --help 时可以看到。最后两个分别对应打开和关闭时的操作。

现在将 DEBUG 功能加入 configure.ac:

AC_ARG_ENABLE(debug,

[ --enable-debug turn on debug],

CXXFLAGS="$CXXFLAGS -g3 -D_DEBUG=1")

编写 Makefile.am

软件根目录 Makefile.am

由于该目录下面保存的是与 autotools 相关的文件，没有需要编译安装的文件，所以只注明需要进一步处理的子目录信息:

SUBDIRS = src data docs fonts images music sound

src/Makefile.am

此目录里是源代码，最终生成 mj 可执行文件，在其 Makefile.am 中写入

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 文件里变量通过命名判断其含义，保留的字符串间用下划线分隔。

bin_PROGRAMS 表示列出二进制的程序，值为多个空格分开的程序列表，这里仅有一个 mj。

mj_SOURCES 列出的是组成 mj 程序的文件，文件比较多的时候，每个文件写成一行容易看清楚。

data/Makefile.am

本目录的文件是 mj 运行时读取的数据，它的 Makefile.am 可以这样写

mjdatadir = $(pkgdatadir)/data

mjdata_DATA = mj.ini titles.txt

EXTRA_DIST = $(mjdata_DATA)

因为 datadir 是保留的关键字，所以用 mjdatadir 代替，pkgdatadir 指向 $prefix/share/FULL-PACKAGE-NAME 目录，因为在 AC_INIT 中已经声明 FULL-PACKAGE-NAME 为majiang，pkgdatadir 就等于 $prefix/share/majiang 目录。

其中 mjdatadir 让 data 目录下的文件安装到 $prefix/share/majiang/data 目录里面。mjdata_DATA 列出此目录下需要安装的文件，然后用 EXTRA_DIST 变量注明。余下几个子目录都与 data 目录类似。

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)