Using Automake and Autoconf to manage large project

 

I. Hello world!

a. 建立源码树

proj

|---- NEWS

|---- README

|---- AUTHORS

|---- ChangeLog

|---- src ----------------> 源码目录

| |---- Makefile.am

| `---- hello.c

|

|---- Makefile.am

`---- configure.ac

b. 撰写 proj/configure.ac

Autoconf 据此生成configure脚本。

基本功能的configure.ac应包括以下的宏：

AC_INIT(Full-Package-Name, Version, Bug-Report-Address)

AM_INIT_AUTOMAKE # 初始化

AM_CONFIG_HEADER(config.h)　　＃生成项目的配置头文件

＃如:项目支持国际化，则其中会定义ENABLE_NLS 为１

AC_PROG_CC # 检查C编译器

AC_PROG_CXX # 检查C++编译器

AC_PROG_INSTALL # 检查install 工具

AC_CONFIG_FILES([Makefile po/Makefile]) # 要输出的Makefile

AC_OUTPUT

也可以在源码根目录下执行autoscan，自动分析，写入您可能需要的宏到

configure.scan中，修改之，并改名为configure.ac即可。

c. 撰写 proj/Makefile.am

此为顶层 Makefile.am, 仅需告诉Automake，哪些目录需要Automake 去处理：

SUBDIRS = src

哪些文件需要发布，但无须编译：

EXTRA_DIST = README ChangLog

d. 在 proj 下建立 GNU-Style 项目所要求的文件

touch NEWS README AUTHORS ChangLog

如不想使用GNU-Style，可在proj/Makefile.am 中指定：

AUTOMAKE_OPTIONS = foreign

否则automake会报错。

e. 为每个子目录撰写Makefile.am

src子目录下是为构建hello程序的源码，则其下Makefile.am中写入：

bin_PROGRAMES = hello

hello_SOURCES = hello.c

如果要链接库，可加入：

hello_LDADD = -ldl -lpthread

f. 完整的build步骤

aclocal -I. ------------> 生成aclocal.m4

autoheader -f ------------> 生成config.h.in

automake -a -c -f ------------> 从makefile.am生成Makefile.in

autoconf ------------> 从configure.ac生成configure

./configure ------------> 从Makefile.in生成Makefile

make

II. 开发中常用的Autoconf 宏

AC_INIT(Full-Package-Name, Version, Bug-Report-Address)

AM_INIT_AUTOMAKE

AM_CONFIG_HEADER(config.h)　　＃生成项目的配置头文件

＃如项目支持国际化，则其中会定义ENABLE_NLS 为１

AC_CONFIG_SRCDIR([src/hello.c])

AC_PROG_CC

AC_PROG_CXX

AC_PROG_INSTALL

AC_PROG_MAKE_SET

# 构建动态共享库支持

AC_PROG_LIBTOOL

AC_PROG_RANLIB

# 国际化支持

AC_PROG_INTLTOOL([Intltoolize_Version])

ALL_LINGUAS=””

AM_GLIB_GNU_GETTEXT ＃使用GLib库的gettext机制

AM_GNU_GETTEXT ＃使用Libc库的gettext机制

AC_CONFIG_FILES([Makefile po/Makefile])

AC_OUTPUT

III. 开发中常用的Automake变量

# 通用变量

_SOURCES =

noinst_HEADERS =

INCLUDES =

_CFLAGS =

_CPPFLAGS =

_CXXFLAGS =

_LDFLAGS = # 没有libtool时，是否可用？

# 构建可执行程序

bin_PROGRAMS =

_LDADD =

# 构建静态库

bin_LIBRARIES = libhello.a

libhello_a_LIBADD =

# 构建动态库

lib_LTLIBRARIES = libhello.la

libhello_la_LIBADD = -rpath ./

IV. 参考源码树

proj

|---- NEWS

|---- README

|---- AUTHORS

|---- ChangeLog

|---- doc ----------------> 文档目录

|---- test ----------------> 测试代码目录

|---- src ----------------> 源码目录

|---- po ----------------> 国际化文件目录

|---- res ----------------> 资源目录

|---- glade ----------------> glade文件

`---- image ----------------> 图像文件