系统程序员成长计划-工程管理(二)
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。