运用autoconf和automake自动生成Makefile实例讲解

在开始使用autoconf和automake之前，首先确认你的系统安装有GNU的如下软件：

1. automake

2. autoconf

3. m4

4. perl

5. 如果你需要产生共享库（shared library）则还需要GNU Libtool

自动生成一个makefile的步骤。


第一步：

----------

假如我们有一个目录hello, 里面有main.c以及子目录comm,子目录中有comm.h comm.c

第二步：

----------

运行 autoscan
, 自动创建两个文件： autoscan.log configure.scan

第三步：

----------

修改configure.scan的文件名为configure.in

查看configure.in
的内容：

------------------------------------------------

# -*- Autoconf -*-

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

AC_PREREQ(2.61)

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

AC_CONFIG_SRCDIR([main.c])

AC_CONFIG_HEADER([config.h])

# Checks for programs.

AC_PROG_CC

# Checks for libraries.

# Checks for header files.

# Checks for typedefs, structures, and compiler characteristics.

# Checks for library functions.

AC_OUTPUT

------------------------------------------------

解读以上的文件：

------------------------------------------------

# -*- Autoconf -*-

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

# AC_PREREQ:

# 确保使用的是足够新的Autoconf版本。如果用于创建configure的Autoconf的版

# 本比version 要早，就在标准错误输出打印一条错误消息并不会创建configure。

AC_PREREQ(2.61)

#

# 初始化,定义软件的基本信息,包括设置包的全称,版本号以及报告BUG时需要用的邮箱地址

#

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

#

# 用来侦测所指定的源码文件是否存在，来确定源码目录的有效性

#

AC_CONFIG_SRCDIR([main.c])

#

# 用于生成config.h文件，以便autoheader使用

#

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.

#

# 创建输出文件。在`configure.in'的末尾调用本宏一次。

#

AC_OUTPUT

------------------------------------------------

修改动作:

1.修改AC_INIT里面的参数: AC_INIT(main,1.0, pgpxc@163.com)

2.添加宏AM_INIT_AUTOMAKE, 它是automake所必备的宏，也同前面一样，PACKAGE是所要产生软件套件的名称，VERSION是版本编号。

3.在AC_OUTPUT后添加输出文件Makefile

修改后的结果:

------------------------------------------------

# -*- Autoconf -*-

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

AC_PREREQ(2.61)

AC_INIT(main, 1.0, pgpxc@163.com)

AC_CONFIG_SRCDIR([main.c])

AC_CONFIG_HEADER([config.h])

AM_INIT_AUTOMAKE(main,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)

------------------------------------------------

第四步:

运行 aclocal
, 生成一个“aclocal.m4”
文件和一个缓冲文件夹autom4te.cache
，该文件主要处理本地的宏定义。

第五步：

运行 autoconf
, 目的是生成 configure

第六步：

运行 autoheader
，它负责生成config.h.in文件。该工具通常会从“acconfig.h”文件中复制用户附加的符号定义，因此此处没有附加符号定义，所以不需要创建“acconfig.h”文件。

第七步：

下面即将运行 automake
, 但在此之前应该做一下准备工作!

首先

创建一个 Makefile.am
.这一步是创建Makefile很重要的一步，automake要用的脚本配置文件是Makefile.am，用户需要自己创建相应的文件。之后，automake工具转换成Makefile.in。

这个Makefile.am的内容如下：

------------------------------------------------

AUTOMAKE_OPTIONS=foreign

bin_PROGRAMS=main

main

_SOURCES=main.c comm/comm.h comm/comm.c

------------------------------------------------

下面对该脚本文件的对应项进行解释。

main改为要生成的程序名（主程序名）


如何需要用到mysql，则在Makefile.am中加入

：

INCLUDES=     -I./   -I/usr/local/mysql/include/
LIBS=   -L/usr/lib/mysql   -lmysqlclient

还可以在INCLUDES上指名自己程序所在的路径，但是注意不能有空格


其中的AUTOMAKE_OPTIONS为设置automake的选项。由于GNU（在第1章中已经有所介绍）对自己发布的软件有严格的规范，比如必须附带许可证声明文件COPYING等，否则automake执行时会报错。automake提供了三种软件等级：foreign、gnu和gnits，让用 户选择采用，默认等级为gnu。在本例使用foreign等级，它只检测必须的文件。

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

main_SOURCES定义“main”这个执行程序所需要的原始文件。如果”main”这个程序是由多个原始文件所产生的，则必须把它所用到的所有原 始文件都列出来，并用空格隔开。例如：若目标体“main”需要“main.c”、“sunq.c”、“main.h”三个依赖文件，则定义 main_SOURCES=main.c sunq.c main.h。要注意的是，如果要定义多个执行文件，则对每个执行程序都要定义相应的file_SOURCES。

其次

使用automake对其生成“configure.in”文件，在这里使用选项“—adding-missing”可以让automake自动添加有一些必需的脚本文件。

注意需要手工生成一些文件（在project目录下新建NEWS、 README、 ChangeLog 、AUTHORS文件），否则会报错终止

$ automake --add-missing


第八步

运行configure
，在这一步中，通过运行自动配置设置文件configure，把Makefile.in变成了最终的Makefile。

第九步

运行 make
，对配置文件Makefile进行测试一下