使用autotools系列工具自动部署源代码编译安装

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

这极大地简化了Makefile的编写和维护，作者也是刚体验到其威力，所以将其过程记录下来。

本文以一个简单的hello.c文件进行验证。

准备工作

首先需要安装autotools系列工具，包括aclocal、autoscan、automake、autoheader、autoconf等。

如果在centos或redhat系统下可以通过rpm –qa | grep auto来查看各个应用程序，如果没有，直接yum install automake即可安装。

大致流程

• 1. 编写源代码以及手动书写Makefile.am文件（稍后介绍）；
• 2. 依次使用各种autotools系列工具配置编译属性；

    autoscan                               #扫面当前目录、源文件，生成configure.scan文件
    aclocal                                #根据configure.in生成aclocal.m4文件以及autom4te.cache文件夹
    autoconf                               #根据configure.in和aclocal.m4来产生configure文件
    autoheader                             #生成配置头文件的模板config.h.in
    touch README NEWS AUTHORS ChangeLog    #生成一些声明性文件
    automake --add-missing                 #生成Makefiel.in和所需要的脚本

• 3. 编译、生成、部署：

make
make install
make clean
make dist       #制作发布的软件包
make distcheck  #检验完整性并制作软件包 

详细步骤

1.  autoscan

将生成configure.scan和autoscan.log文件，它会在给定目录及其子目录树中检查源文件，若没有给定目录，就在当前目录及其子目录树中进行检查。它会搜索源文件以寻找一般的移植性问题并且创建一个文件configure.scan，通过这个文件我们可以创建autoconf需要的模版文件。

[root@lzv6 hello]# ls
hello.c
[root@lzv6 hello]# autoscan
[root@lzv6 hello]# ls
autoscan.log  configure.scan  hello.c

2.  重命名configure.scan，并修改configure.in

mv configure.scan configure.in  #将上步生成的configure.scan更改为autoconf需要的文件模版configure.in

在configure.in中增加以下内容：

AC_INIT([hello], [0.1], [lizhenghn@gmail.com])
AM_INIT_AUTOMAKE(hello,1.0)
AC_PROG_CXX
AC_PROG_LIBTOOL
AC_CONFIG_FILES(Makefile)

修改后的configure.in内容如下：

#                                               -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.
 
AC_PREREQ([2.63])
AC_INIT([hello], [0.1], [lizhenghn@gmail.com])   #用来定义软件的名字、版本，以及邮箱地址信息
#AC_INIT([hello], [0.1])
AM_INIT_AUTOMAKE(hello,0.1)      #必须添加此行，描述了要生成的软件包的名字及其版本号
AC_CONFIG_SRCDIR([hello.c])      #用来侦测所指定的源码文件是否存在
AC_CONFIG_HEADERS([config.h])
 
# Checks for programs.
AC_PROG_CC         #检测系统所用的C编译器
AC_PROG_CXX
 
# Checks for libraries.
#AC_PROG_RANLIB    #需要需要静态库
AC_PROG_LIBTOOL    #如果需要动态库
 
# Checks for header files.
                                                                                                                                                          
# Checks for typedefs, structures, and compiler characteristics.
 
# Checks for library functions.
AC_CONFIG_FILES(Makefile)
AC_OUTPUT

3. aclocal ：复制所有的宏命令

configure.in 里面包含了一系列的宏命令，运行aclocal的目的是把工程需要的宏命令展开。aclocal.m4 就是configure.in中用到的宏定义。本步会生成aclocal.m4文件和autom4te.cache文件夹。

[root@lzv6 hello]# aclocal
[root@lzv6 hello]# ls
aclocal.m4  autom4te.cache  autoscan.log  configure.in  hello.c

4. autoheader ：生成config.h.in文件

生成配置头文件的模板config.h.in文件。

[root@lzv6 hello]# autoheader
[root@lzv6 hello]# ls
aclocal.m4  autom4te.cache  autoscan.log  config.h.in  configure.in  hello.c

5. 创建一些声明性文件

此处创建一些声明性，但非必须的文件，文件内容可以暂时都为空。

[root@lzv6 hello]# touch README NEWS AUTHORS ChangeLog

6. autoconf ：生成configure脚本

[root@lzv6 hello]# autoconf
[root@lzv6 hello]# ls
aclocal.m4  AUTHORS  autom4te.cache  autoscan.log  ChangeLog  config.h.in  configure  configure.in  hello.c  NEWS  README

7. 编写Makefile.am

如下是一个简单的Makefile.am

AUTOMAKE_OPTIONS=foreign
bin_PROGRAMS=hello
hello_SOURCES=hello.c

说明：AUTOMAKE_OPTIONS为设置automake的选项。automake提供了3种软件等级：foreign、gnu、gnits，默认等级是gnu。此处使用的foreign表示只是检测必要的文件。
bin_PROGRAMS定义了要产生的执行文件名。如果产生多个可执行文件，每个文件名用空格隔开。
file_SOURCES定义file这个执行程序的依赖文件。同样的，对于多个执行文件，那就要定义相应的file_SOURCES。

8. automake --add-missing

生成Makefiel.in和所需要的脚本，其中add-missing选项会让automake自动添加一些必须的脚本文件。

[root@lzv6 hello]# automake --add-missing    
configure.in:16: installing `./config.guess'
configure.in:16: installing `./config.sub'
configure.in:7: installing `./install-sh'
configure.in:16: required file `./ltmain.sh' not found
configure.in:7: installing `./missing'
Makefile.am: installing `./depcomp'    
[root@lzv6 hello]# libtoolize --automake --copy --debug --force              #注意此处步骤！！！
[root@lzv6 hello]# automake --add-missing    
[root@lzv6 hello]# ls
aclocal.m4  autom4te.cache  ChangeLog     config.h.in  configure     depcomp  install-sh  Makefile.am  missing  README
AUTHORS     autoscan.log    config.guess  config.sub   configure.in  hello.c  ltmain.sh   Makefile.in  NEWS    

说明：第一次运行时报错，此时运行命令libtoolize --automake --copy --debug --force即可解决。

至此该工程的Makefile就配置完成了。

在以后的使用中进行编译时可以直接运行命令：

[root@lzv6 hello]# ./configure
[root@lzv6 hello]# make    
[root@lzv6 hello]# make install             #默认安装在/usr/local/bin/
[root@lzv6 hello]# make dist                #打包，会在当前目前下生成hello-0.1.tar.gz

当你增加代码文件时，其实主需要修改Makefile.am即可，这里就不再详述了。

这里附上一张整个步骤的流程图：

 参考：

http://www.ibm.com/developerworks/cn/linux/l-makefile/

 发现另一篇介绍，注意其第三节编译类型的介绍。