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

使用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. 编译、生成、部署:
makemake installmake cleanmake dist       #制作发布的软件包make distcheck  #检验完整性并制作软件包 

详细步骤

1.  autoscan

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

[root@lzv6 hello]# lshello.c[root@lzv6 hello]# autoscan[root@lzv6 hello]# lsautoscan.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_CXXAC_PROG_LIBTOOLAC_CONFIG_FILES(Makefile)

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

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

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

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

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

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

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

[root@lzv6 hello]# autoheader[root@lzv6 hello]# lsaclocal.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]# lsaclocal.m4  AUTHORS  autom4te.cache  autoscan.log  ChangeLog  config.h.in  configure  configure.in  hello.c  NEWS  README

7. 编写Makefile.am

如下是一个简单的Makefile.am

AUTOMAKE_OPTIONS=foreignbin_PROGRAMS=hellohello_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.guessconfigure.in:16: installing `./config.subconfigure.in:7: installing `./install-shconfigure.in:16: required file `./ltmain.sh not foundconfigure.in:7: installing `./missingMakefile.am: installing `./depcomp    [root@lzv6 hello]# libtoolize --automake --copy --debug --force              #注意此处步骤!!![root@lzv6 hello]# automake --add-missing    [root@lzv6 hello]# lsaclocal.m4  autom4te.cache  ChangeLog     config.h.in  configure     depcomp  install-sh  Makefile.am  missing  READMEAUTHORS     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系列工具自动部署源代码编译安装