系统程序员成长计划工程管理(二)

转载时请注明出处和作者联系方式
文章出处：http://www.limodev.cn/blog
作者联系方式：李先静 <xianjimli@gmail.com>

系统程序员成长计划-工程管理(二)

HelloWorld

automake比起IDE要复杂很多，这里我们先写一个Hello World例子，明白其中的基本概念后，再用它来管理实际的工程。

o目录结构

最顶层目录名用模块名称，这里是helloworld。
源文件放在模块下的src子目录里，即helloworld/src。

这是惯例。有多个子模块时，各个子模块的源代码放在各自的目录里。

o 创建源文件

在src下创建源文件main.c，内容就是一个简单的Hello World程序。

o 创建Makefile模板

创建helloworld/Makefile.am，内容为：

SUBDIRS=src

这里只有简单的一行代码，表示其下有一个src的子目录，如果有多个子目录，用空格分开就行了。

创建helloworld/src/Makefile.am，内容为：

bin_PROGRAMS=helloworld
helloworld_SOURCES=main.c

这里表示有一个可执行文件helloworld，helloworld由源文件main.c编译而来。

PROGRAMS表示要产生的可执行文件，有多个可执行文件时，用空格分开，而bin表示可执行文件要安装的目录。 SOURCES表示生成可执行文件需要的源文件，有多个源文件时，也用空格分开。

.am扩展名是automake的简称，它是automake用来产生Makefile.in文件的模板。

o 创建autoconf的模板。

在helloworld下运行autoscan，生成文件configure.scan，把它改名为configure.in。这是 autoconf的模板文件，它的内容大概为：

#                                               -*- 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([src/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_CONFIG_FILES([Makefile
                 src/Makefile])
AC_OUTPUT

这个文件由一系列的宏组成，这些宏最终由命令m4展开，得到一个脚本文件configure。configure的主要功能是探测系统的配置，然后 根据这些配置来产生相应的Makefile文件。比如AC_PROG_CC 是用来检测编译器的，AC_CONFIG_FILES和AC_OUTPUT是用来产生Makefile和其它数据文件的。

不过这个模板文件还不能直接使用，需要做下列修改：

把：
AC_INIT(FULL-PACKAGE-NAME, VERSION, BUG-REPORT-ADDRESS)
改为：
AC_INIT(helloworld, 0.1, xianjimli@hotmail.com)

FULL-PACKAGE-NAME 是模块的名称。

VERSION 是模块的版本号，初始版本号都用0.1。对小模块来说用两级版本号就够了，小数点前的为主版本号，只有重大更新时才升级主版本号。小数点后的为次版本号， 每次发布都应该升级它。一般升级到0.9后，可以继续升级到0.10、0.11等。

BUG-REPORT-ADDRESS 是作者或维护者的邮件地址。

再加上一行automake的初始化脚本：

AM_INIT_AUTOMAKE(helloworld, 0.1)

helloworld是模块的名称。

0.1是模块的版本号。

这里和前面的参数是重复的，AC_INIT是初始化autoconf的，AM_INIT_AUTOMAKE是初始automake的。在有的情况 下，只是产生数据文件，而不需要编译文件时，那就不需要AM_INIT_AUTOMAKE了。

最后得到下面的文件：

#                                               -*- Autoconf -*-

# Process this file with autoconf to produce a configure script.
AC_PREREQ(2.61)
AC_INIT(helloworld, 0.1, xianjimli@hotmail.com)
AC_CONFIG_SRCDIR([src/main.c])
AC_CONFIG_HEADER([config.h])
AM_INIT_AUTOMAKE(helloworld, 0.1)
# 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_CONFIG_FILES([Makefile
                 src/Makefile])
AC_OUTPUT

o 拷贝所用到宏。
运行：aclocal

前面说了，configure.in里是一系列的宏，这些宏由命令m4负责展开。m4 实际上就是macro的简称，4代表m后面省略了4个字母。类似的还有I18n (Internationalization )和 L10n(Localization)，其中的数字都是代表所省略的字母个数。

AC_PROG_CC 之类的宏是标准的宏(或说是内置的宏)，不需要我们自己去写它，但我们需要运行命令aclocal，aclocal把configure.in中所用到的 宏全部拷贝到我们的工程里来。在helloworld目录下运行aclocal之后，当前目录下出现了：

autom4te.cache 这是一个临时目录，只是用来加快宏展开的。
aclocal.m4 是configure.in中用到的宏的定义，有兴趣的读者可以看看。

o 产生配置头文件的模板。
运行：autoheader

配置头文件(config.h)是用来定义在C/C++程序中可以引用的宏，像模块的名称和版本号等等。这些宏由configure脚本产生，但我 们要提供一个模板文件。这个模板文件可以用命令autoheader产生出来。在helloworld目录下运行autoheader之后，当前目录下产 生config.h.in，一般情况不用修改它。

o 创建几个必要的文件。

README：描述模块的功能、用法和注意事项等。
NEWS：描述模块最新的动态。
AUTHORS：模块的作者及联系方式。
ChangeLog：记录模块的修改历史，它有固定的格式：
1.最新修改放在最上面。
2.对于每条记录，第一行写日期，修改者和联系方式。第二行开始以tab开头，再加一个星号，后面再写修改的原因和位置等。如：

2009-03-29 Li XianJing 
    * Created

o 生成Makefile.in和所需要的脚本。
运行：automake -a

这个命令会建立COPYING depcomp INSTALL install-sh missing几个文件的链接，这些文件指向系统中的文件。automake最重要的功能是以Makefile.am为模板产生Makefile.in文 件，Makefile.in相对于Makefile.am要复杂很多倍了，所幸的是我们不需要了解它。

o 产生configure脚本。
运行：autoconf

autoconf的功能是调用m4展开configure.in中的宏，生成configure脚本，这个脚本是最终运行的脚本。

o 产生最终的Makefile。
运行：./configure

configure有两个常用的参数：
–prefix 用来指定安装目录，Linux下默认的安装目录是/usr/local。
–host 用于交叉编译，比如x86的PC机上编译在ARM板上运行的程序。

如：./configure –prefix=/home/lixianjing/work/arm-root/usr –host=arm-linux

o 编译
运行：make

o 安装
运行：make install

o 发布软件包
运行：make dist或者make distcheck

make dist用来生成一个发布软件包，这里会产生一个名为helloworld-0.1.tar.gz的文件。通常，源代码管理系统(cvs/svn /git)中的源代码是处于开发中的，是不稳定的，而发布的软件包则是稳定的，可供用户使用的。

怎样，是不是有点晕了？这里主要是想读者了解其中的原理，在实际操作中，我们可以把make之前的部分动作放到一个脚本文件中，这个脚本文件通常取 名为autogen.sh或者bootstrap。