使用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:: installing `./config.guess'
configure.in:: installing `./config.sub'
configure.in:: installing `./install-sh'
configure.in:: required file `./ltmain.sh' not found
configure.in:: 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即可,这里就不再详述了。

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

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

参考:

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

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

上一篇:LeetCode算法题-Third Maximum Number(Java实现-四种解法)


下一篇:1-学习GPRS_Air202(Air202开发板介绍)