autotools 入门学习使用

         既是转载，也加入了一点点自己学习过程中的理解与问题。

        文章来源：http://bbs.chinaunix.net/thread-727270-1-1.html

         1、准备:
         需要工具autoscan aclocal autoheader automake autoconf make 等工具.
        2、测试程序编写：
        建立目录：mkdir  src
        编写程序：main.cpp
       3.生成configure.in

       configure.in是automake的输入文件，所以必须先生成该文件。
      执行命令：

[root@localhost str]# ls
src
[root@localhost str]# autoscan
[root@localhost str]# ls
autoscan.log  configure.scan src
[root@localhost str]# cp configure.scan configure.in

修改 configure.in

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

AC_PREREQ([2.68])
#AC_INIT([FULL-PACKAGE-NAME], [VERSION], [BUG-REPORT-ADDRESS])
AC_INIT([main.cpp])
AC_CONFIG_SRCDIR([main.cpp])
AC_CONFIG_HEADERS([config.h])
AM_INIT_AUTOMAKE(main, 1.0)

# Checks for programs.
AC_PROG_CXX

# Checks for libraries.

# Checks for header files.

# Checks for typedefs, structures, and compiler characteristics.

# Checks for library functions.

AC_OUTPUT(Makefile)
~              

标红的语句一定要注释掉，这是一个语法教大家如何指定程序名称版本等信息，不注释会导致configure出错。

./configure: line 2270: BUG-REPORT-ADDRESS: No such file or directory

   4.然后执行命令aclocal和autoconf,分别会产生aclocal.m4及configure两个文件：

  大家可以看到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既可以作为编译器的 前端,也可以单独作为一个宏处理器.

        5.新建Makefile.am
　　新建Makefile.am文件,命令：

$ vi Makefile.am　　
内容如下:
AUTOMAKE_OPTIONS=foreign
bin_PROGRAMS=main
main_SOURCES=helloworld.

automake会根据Makefile.am文件产生一些文件,包含最重要的 Makefile.in.

　　6.执行configure生成Makefile

        使用Makefile编译代码

      

 1. autoscan　　
   autoscan是 用来扫描源代码目录生成configure.scan文件的 .autoscan可以用目录名做为参数,但如果你不使用参数的 话,那么autoscan将认为使用的是当前目录.autoscan将扫描你所指定目录中的 源文件,并创建configure.scan文件.　　
2. configure.scan　　
   configure.scan包含了系统配置的 基本选项,里面都是 一些宏定义.我们需要将它改名为configure.in　　
3. aclocal　　
  aclocal是 一个perl 脚本程序.aclocal根据configure.in文件的 内容,自动生成aclocal.m4文件.aclocal的 定义是 ："aclocal - create aclocal.m4 by scanning configure.ac".　　
4. autoconf　　
   autoconf是 用来产生configure文件的 .configure是 一个脚本,它能设置源程序来适应各种不同的操作系统平台,并且根据不同的系统来产生合适的 Makefile,从而可以使你的源代码能在不同的操作系统平台上被编译出来.　　
   configure.in文件的内容是一些宏,这些宏经过autoconf 处理后会变成检查系统特性.环境变量.软件必须的参数的 shell脚本.configure.in文件中的宏的顺序并没有规定,但是你必须在所有宏的最前面和最后面分别加上AC_INIT宏和AC_OUTPUT宏.　　
  在 configure.in中：　　#号表示注释,这个宏后面的 内容将被忽略.　　
  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文件了.　　
5. Makefile.am　　
   Makefile.am是 用来生成Makefile.in的 ,需要你手工书写.Makefile.am中定义了一些内容：
  AUTOMAKE_OPTIONS　　
   这个是automake的选项.在执行automake时,它会检查目录下是否存在标准GNU软件包中应具备的各种文件,例如AUTHORS.ChangeLog.NEWS等文件. 我们将其设置成foreign时,automake会改用一般软件包的标准来检查.
  bin_PROGRAMS　　
  这个是指定我们所要产生的可执行文件的文件名.如果你要产生多个可执行文件,那么在各个名字间用空格隔开.
  helloworld_SOURCES　　
  这个是 指定产生"helloworld"时所需要的 源代码.如果它用到了多个源文件,那么请使用空格符号将它们隔开.比如需要helloworld.h,helloworld.c那么请写成:helloworld_SOURCES= helloworld.h helloworld.c.　　如果你在 bin_PROGRAMS定义了多个可执行文件,则对应每个可执行文件都要定义相对的filename_SOURCES.　　
6. automake　　
  我们使用automake --add-missing来产生Makefile.in.　　
  选项--add-missing的 定义是 "add missing standard files to package",它会让automake加入一个标准的 软件包所必须的 一些文件.　　
  我们用automake产生出来的 Makefile.in文件是 符合GNU Makefile惯例的 ,接下来我们只要执行configure这个shell 脚本就可以产生合适的 Makefile 文件了.　　
7. 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　　
  生成发布软件包并对其进行测试检查,以确定发布包的正确性.