生成makefile

文章分类:C++编程

1.autoscan (autoconf): 扫描源代码以搜寻普通的可移植性问题，比如检查编译器，库，头文件等，生成文件configure.scan,它是configure.ac的一个雏形。

your source files --> [autoscan*] --> [configure.scan] --> configure.ac

2.aclocal (automake):根据已经安装的宏，用户定义宏和acinclude.m4文件中的宏将configure.ac文件所需要的宏集中定义到文件 aclocal.m4中。aclocal是一个perl 脚本程序，它的定义是：“aclocal - create aclocal.m4 by scanning configure.ac”

user input files optional input process output files ================ ============== ======= ============

acinclude.m4 - - - - -. V .-------, configure.ac ------------------------>|aclocal|

{user macro files} ->| |------> aclocal.m4 `-------'

3.autoheader(autoconf): 根据configure.ac中的某些宏，比如cpp宏定义，运行m4，声称config.h.in

user input files optional input process output files ================ ============== ======= ============

aclocal.m4 - - - - - - - . | V .----------,

configure.ac ----------------------->|autoheader|----> autoconfig.h.in `----------'

4.automake: automake将Makefile.am中定义的结构建立Makefile.in，然后configure脚本将生成的Makefile.in文件转换 为Makefile。如果在configure.ac中定义了一些特殊的宏，比如AC_PROG_LIBTOOL，它会调用libtoolize，否则它 会自己产生config.guess和config.sub

user input files optional input processes output files ================ ============== ========= ============

.--------,

| | - - -> COPYING | | - - -> INSTALL | |------> install-sh | |------> missing

|automake|------> mkinstalldirs configure.ac ----------------------->| |

Makefile.am ----------------------->| |------> Makefile.in | |------> stamp-h.in .---+ | - - -> config.guess | | | - - -> config.sub | `------+-'

| | - - - -> config.guess |libtoolize| - - - -> config.sub | |--------> ltmain.sh | |--------> ltconfig `----------'

5.autoconf:将configure.ac中的宏展开，生成configure脚本。这个过程可能要用到aclocal.m4中定义的宏。

user input files optional input processes output files ================ ============== ========= ============

aclocal.m4 ,autoconfig.h.in - - - - - - -. V

.--------,

configure.ac ----------------------->|autoconf|------> configure

6. ./configure的过程

.------------->

[config.cache]

configure* --------------------------+-------------> config.log |

[config.h.in] -. v .--> [autoconfig.h]

+-------> config.status* -+ Makefile.in ---' `--> Makefile

7. make过程

[autoconfig.h] -.

+--> make* ---> 程序 Makefile ---'

.---------,

config.site - - ->| |

config.cache - - ->|configure| - - -> config.cache | +-, `-+-------' |

| |----> config.status config.h.in ------->|config- |----> config.h Makefile.in ------->| .status|----> Makefile | |----> stamp-h | +--, .-+ | | | `------+--' |

ltmain.sh ------->|ltconfig|-------> libtool | | | `-+------' | |config.guess| | config.sub | `------------'

.--------,

Makefile ------>| | config.h ------>| make | {project sources} ---------------->| |--------> {project targets} .-+ +--, | `--------' | | libtool | | missing |

| install-sh | |mkinstalldirs| `-------------'

实例：

在/hello/目录下创建一个hello.c文件，并编译运行它： #cd /hello/

(1) 编写源文件hello.c： #include

int main(int argc, char** argv) {

printf(\return 0; }

[litao@vm0000131 hello]$ ll total 4

-rw-rw-r-- 1 litao litao 68 Aug 12 12:02 hello.c 一、autoscan

[litao@vm0000131 hello]$ autoscan

autom4te: configure.ac: no such file or directory

autoscan: /usr/bin/autom4te failed with exit status: 1 [litao@vm0000131 hello]$ ll total 8

-rw-rw-r-- 1 litao litao 0 Aug 12 12:03 autoscan.log -rw-rw-r-- 1 litao litao 457 Aug 12 12:03 configure.scan -rw-rw-r-- 1 litao litao 68 Aug 12 12:02 hello.c 已经生成了configure.scan，autoscan.log文件

将configure.scan 修改为 configure.in，最后修改的内容如下： [litao@vm0000131 hello]$ mv configure.scan configure.in [litao@vm0000131 hello]$ vim configure.in

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

AC_PREREQ(2.59)

AC_INIT(FULL-PACKAGE-NAME, VERSION, BUG-REPORT-ADDRESS)

AC_CONFIG_SRCDIR([hello.c]) #AC_CONFIG_HEADER([config.h]) AM_INIT_AUTOMAKE(hello, 1.0) # 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_OUTPUT(Makefile) 二、acloacl

[litao@vm0000131 hello]$ aclocal

生成 aclocal.m4 和 autom4te.cache (生成aclocal.m4的过程中涉及到configure.in)

[litao@vm0000131 hello]$ ll total 44

-rw-rw-r-- 1 litao litao 31120 Aug 12 12:08 aclocal.m4 drwxr-xr-x 2 litao litao 4096 Aug 12 12:08 autom4te.cache -rw-rw-r-- 1 litao litao 0 Aug 12 12:03 autoscan.log -rw-rw-r-- 1 litao litao 496 Aug 12 12:08 configure.in -rw-rw-r-- 1 litao litao 68 Aug 12 12:02 hello.c 三、antoconf

[litao@vm0000131 hello]$ autoconf

生成 configure (根据 configure.in, 和 aclocal.m4) [litao@vm0000131 hello]$ ll total 168

-rw-rw-r-- 1 litao litao 31120 Aug 12 12:08 aclocal.m4 drwxr-xr-x 2 litao litao 4096 Aug 12 12:11 autom4te.cache -rw-rw-r-- 1 litao litao 0 Aug 12 12:03 autoscan.log -rwxrwxr-x 1 litao litao 122297 Aug 12 12:11 configure -rw-rw-r-- 1 litao litao 496 Aug 12 12:08 configure.in -rw-rw-r-- 1 litao litao 68 Aug 12 12:02 hello.c

四、编写Makefile.am：

AUTOMAKE_OPTIONS= foreign bin_PROGRAMS= hello hello_SOURCES= hello.c 五、automake

生成 Makefile.in， depcomp， install-sh， 和 missing (根据 Makefile.am, 和 aclocal.m4)

[litao@vm0000131 hello]$ automake

configure.in: required file `./install-sh' not found configure.in: required file `./missing' not found Makefile.am: required file `./depcomp' not found [litao@vm0000131 hello]$ automake --add-missing configure.in: installing `./install-sh' configure.in: installing `./missing' Makefile.am: installing `./depcomp' [litao@vm0000131 hello]$ ll total 192

-rw-rw-r-- 1 litao litao 31120 Aug 12 12:08 aclocal.m4 drwxr-xr-x 2 litao litao 4096 Aug 12 12:14 autom4te.cache -rw-rw-r-- 1 litao litao 0 Aug 12 12:03 autoscan.log -rwxrwxr-x 1 litao litao 122297 Aug 12 12:11 configure -rw-rw-r-- 1 litao litao 496 Aug 12 12:08 configure.in lrwxrwxrwx 1 litao litao 31 Aug 12 12:16 depcomp -> /usr/share/automake-1.9/depcomp

-rw-rw-r-- 1 litao litao 68 Aug 12 12:02 hello.c

lrwxrwxrwx 1 litao litao 34 Aug 12 12:16 install-sh -> /usr/share/automake-1.9/install-sh

-rw-rw-r-- 1 litao litao 69 Aug 12 12:15 Makefile.am -rw-rw-r-- 1 litao litao 16561 Aug 12 12:16 Makefile.in lrwxrwxrwx 1 litao litao 31 Aug 12 12:16 missing -> /usr/share/automake-1.9/missing

六、configure

生成 Makefile， config.log， 和 config.status

autotools系列工具—-自动生成Makefile

在较大项目中, 如果手动维护Makefile, 那将是一件复杂并痛苦的事情. 那么, 有没有一种轻松的手段生成Makefile呢? autotools系列工具正是在这样的呼声中诞生的. 它只需用户输入简单的目标文件, 依赖文件, 文件目录等就可以轻松地生成Makefile了. 另外, 这些工具还可以完成系统配置信息的收集, 从而可以方便地处理各种移植性问题.

autotools是系列工具, 它含有:

? ? ? ? ?

aclocal autoscan autoconf autoheader automake

autotools 使用流程

下面用一个简单的hello.c程序, 演示autotools的使用流程. hello.c如下:

wangsheng@pc01:~/work/train/make/automake$ ls hello.c wangsheng@pc01:~/work/train/make/automake$ cat hello.c #include int main() { printf(\ return 0; } (1) 使用autoscan命令自动生成configure.scan文件

它会在给定目录及其子目录树中检查源文件, 若没有给出目录, 就在当前目录及其子目录树中进行检查.它会搜索源文件以寻找一般的移植性问题并创建一个文件”configure.scan”, 该文件就是接下来autoconf要用到的”configure.in”原型.

wangsheng@pc01:~/work/train/make/automake$ autoscan wangsheng@pc01:~/work/train/make/automake$ ls autoscan.log configure.scan hello.c (2)将configure.scan重命名为configure.in, 并做适当修改 configure.scan的内容:

wangsheng@pc01:~/work/train/make/automake$ cat configure.scan # -*- Autoconf -*- # Process this file with autoconf to produce a configure script. AC_PREREQ([2.65]) AC_INIT([FULL-PACKAGE-NAME], [VERSION], [BUG-REPORT-ADDRESS]) AC_CONFIG_SRCDIR([hello.c]) AC_CONFIG_HEADERS([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_OUTPUT 将configure.scan重命名为configure.in

wangsheng@pc01:~/work/train/make/automake$ mv configure.scan configure.in 根据具体情况, 适当修改, 以下加粗部分是修改的内容:

wangsheng@pc01:~/work/train/make/automake$ cat configure.in # -*- Autoconf -*- # Process this file with autoconf to produce a configure script. AC_PREREQ([2.65]) #AC_INIT([FULL-PACKAGE-NAME], [VERSION], [BUG-REPORT-ADDRESS]) AC_INIT(hello,1.0) AM_INIT_AUTOMAKE(hello,1.0) AC_CONFIG_SRCDIR([hello.c]) AC_CONFIG_HEADERS([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]) AC_OUTPUT 说明:

? ? ? ?

以”#”号开始的行为注释

AC_PREREQ宏声明本文要求的autoconf版本, 如本例中的版本 2.65

AC_INIT宏用来定义软件的名称和版本等信息, 在本例中省略了BUG-REPROT-ADDRESS, 一般为作者的E-mail AM_INIT_AUTOMAKE是手动添加的, 它是automake所必备的宏, 也同前面一样, PACKAGE是所要产生软件套件的名称,VERSION是版本编号.

?

AC_CONFIG_SCRDIR宏用来侦测所指定的源码文件是否存在, 来确定源码目录的有效性. 在此处指当前目录下hello.c

?

AC_CONFIG_FILES宏用于生成相应的Makefile文件.

(3) 运行aclocal命令,生成”aclocal.m4″文件, 该文件主要处理本地的宏定义

wangsheng@pc01:~/work/train/make/automake$ aclocal wangsheng@pc01:~/work/train/make/automake$ ls aclocal.m4 autom4te.cache autoscan.log configure.in hello.c (4) 运行autoconf命令生成configure可执行文件

wangsheng@pc01:~/work/train/make/automake$ autoconf

wangsheng@pc01:~/work/train/make/automake$ ls aclocal.m4 autom4te.cache autoscan.log configure configure.in hello.c (5) 运行autoheader命令, 生成config.h.in文件.

该工具通常会从”acconfig.h”文件中复制用户附加的符号定义. 本例中没有附加的符号定义, 所以不需要创建”acconfig.h”文件.

wangsheng@pc01:~/work/train/make/automake$ autoheader wangsheng@pc01:~/work/train/make/automake$ ls aclocal.m4 autom4te.cache autoscan.log config.h.in configure configure.in hello.c (6) 运行automake命令, 生成Makefile.in文件

这一步是创建Makefile很重要的一步, automake要用的脚本配置文件是Makefile.am, 用户需要自己创建相应的文件. 之后, automake工具将自动转换成Makefile.in 本例中, 创建的文件为Makefile.am, 内容如下:

wangsheng@pc01:~/work/train/make/automake$ cat Makefile.am AUTOMAKE_OPTIONS=foreign bin_PROGRAMS=hello hello_SOURCES=hello.c 说明:

?

其中的AUTOMAKE_OPTIONS为设置automake的选项. 由于GNU对自己发布的软件有严格的规范, 比如必须附带许可证声明文件COPYING等, 否则automake执行时会报错. automake提供了3中软件等级:foreign, gnu和gnits, 供用户选择. 默认级别是gnu. 在本例中, 使用了foreign等级, 它只检测必须的文件.

? ?

bin_PROGRAMS定义要产生的执行文件名. 如果要产生多个执行文件, 每个文件名用空格隔开

hello_SOURCES 定义”hello”这个可执行程序所需的原始文件. 如果”hello”这个程序是由多个源文件所产生的, 则必须把它所用到的所有源文件都列出来, 并用空格隔开. 如果要定义多个可执行程序, 那么需要对每个可执行程序建立对应的file_SOURCES.

在这里使用”–add-missiing”选项可以让automake自动添加一些必须的脚本文件.

wangsheng@pc01:~/work/train/make/automake$ automake --add-missing configure.in:7: installing `./install-sh' configure.in:7: installing `./missing' Makefile.am: installing `./depcomp' wangsheng@pc01:~/work/train/make/automake$ ls aclocal.m4 autoscan.log configure depcomp install-sh Makefile.in autom4te.cache config.h.in configure.in hello.c Makefile.am missing (7)运行configure, 生成Makfefile文件

wangsheng@pc01:~/work/train/make/automake$ ./configure checking for a BSD-compatible install... /usr/bin/install -c checking whether build environment is sane... yes checking for a thread-safe mkdir -p... /bin/mkdir -p checking for gawk... gawk checking whether make sets $(MAKE)... yes checking for gcc... gcc checking whether the C compiler works... yes checking for C compiler default output file name... a.out checking for suffix of executables... checking whether we are cross compiling... no checking for suffix of object files... o checking whether we are using the GNU C compiler... yes checking whether gcc accepts -g... yes checking for gcc option to accept ISO C89... none needed checking for style of include used by make... GNU checking dependency style of gcc... gcc3 configure: creating ./config.status config.status: creating Makefile config.status: creating config.h config.status: executing depfiles commands wangsheng@pc01:~/work/train/make/automake$ ls aclocal.m4 config.h config.status depcomp Makefile missing autom4te.cache config.h.in configure hello.c Makefile.am stamp-h1 autoscan.log config.log configure.in install-sh Makefile.in autotools生成Makefile流程图如下:

使用由autotools生成的Makefile

autotools生成的Makefile具有以下主要功能: (1) make

编译源程序, 键入make, 默认执行”make all”命令

wangsheng@pc01:~/work/train/make/automake$ make make all-am make[1]: Entering directory `/home/wangsheng/work/train/make/automake' gcc -DHAVE_CONFIG_H -I. -g -O2 -MT hello.o -MD -MP -MF .deps/hello.Tpo -c -o hello.o hello.c mv -f .deps/hello.Tpo .deps/hello.Po gcc -g -O2 -o hello hello.o make[1]: Leaving directory `/home/wangsheng/work/train/make/automake' 此时在本目录下就生成了可执行文件”hello”, 运行”./hello”就能看到程序的执行结果:

wangsheng@pc01:~/work/train/make/automake$ ./hello Hello, autotools! (2) make install

执行该命令, 可以把程序安装到系统目录中

wangsheng@pc01:~/work/train/make/automake$ sudo make install 此时, 直接在console输入hello, 就可以看到程序的运行结果

(3) make clean

清除之前所编译的可执行文件及目标文件

wangsheng@pc01:~/work/train/make/automake$ make clean test -z \rm -f *.o (4) make dist

将程序和相关的文档打包为一个压缩文档以供发布

wangsheng@pc01:~/work/train/make/automake$ make dist wangsheng@pc01:~/work/train/make/automake$ ls -l hello-1.0.tar.gz hello-1.0.tar.gz 可见该命令生成了一个hello-1.0.tar.gz的压缩文档.

4.2 编辑 Makefile.am 档

接下来我们要编辑 Makefile.am 档，Automake 会根据 configure.in 中

的巨集把Makefile.am 转成 Makefile.in 档。Makefile.am 档定义我们所

要产的目标：

AUTOMAKE_OPTIONS

设定 automake 的选项。Automake 主要是帮助开发 GNU 软体的人员

维护软体套件，所以在执行 automake 时，会检查目录下是否存在标

准 GNU 软体套件中应具备的文件档案，例如 'NEWS'、'AUTHOR'、

'ChangeLog' 等文件档。设成 foreign 时，automake 会改用一般软

体套件的标准来检查。

bin_PROGRAMS

定义我们所要产生的执行档档名。如果要产生多个执行档，每个档名

用空白字元隔开。

hello_SOURCES

定义 'hello' 这个执行档所需要的原始档。如果 'hello' 这个程序

是由多个原始档所产生，必须把它所用到的原始档都列出来，以空白

字元隔开。假设 'hello' 这个程序需要 'hello.c'、'main.c'、

'hello.h' 三个档案的话，则定义

hello_SOURCES= hello.c main.c hello.h

如果我们定义多个执行档，则对每个执行档都要定义相对的

filename_SOURCES。

编辑好 Makefile.am 档，就可以用 automake --add-missing 来产生

Makefile.in。加上 --add-missing 选项是告诉 automake 顺便帮我们加

入包装一个软体套件所必备的档案。Automake 产生出来的 Makefile.in

档是完全符合 GNU Makefile 的惯例，我们只要执行 configure 这个

shell script 便可以产生合适的 Makefile 档了。

configure.in Makefile.am解析

(2010-04-07 13:25:01)

引用自：http://blog.chinaunix.net/u/22878/showart_421774.html

用前面所介绍的基本概念，已经可以编译全功能的Gtk+/Gnome应用程序了。但是还有一个大问题：如何配置编译选项？一些实用工具如automake、autoconf、libtool等，可以用来简化这一过程。

为了方便维护，同时，也是为了便于使用这些实用工具，应该在编写代码时遵从一些约定。如果要将程序发布为自由软件，最好能使程序源代码的目录结构遵从“GNU项目编码标准”。即使应用程序是私有的商用程序，不想公开源代码，从技术上来说，这么做也是一个非常好的选择，因为这些标准都是经过实践检验，能够让你节省大量的时间和精力。另外还应该在程序代码中包含INSTALL、README的文件。

2.11.1生成源代码树

差不多所有的Gnome应用程序都使用同样的基于GNU工具automake、autoconf和libtool的编译系统。Gtk+和 Gnome提供了一套autoconf宏，用于生成可移植的、符合标准的编译设置。我们用一个称GnomeHello的应用程序来演示Gnome的特性。

Gnome应用程序遵从一系列的约定来生成源代码树和发布的tar文件，大多数约定被自由软件社区广泛使用。这些约定的许多方面已经在“GNU项目编码标准”(GNUProject?sCodingStandards

http://www.gnu.org/prep/standards_toc.html)和Linux文件系统层次标准 (LinuxFilesystemHierarchyStandard：http://www.pathname.com/fhs/)中正式化了。GNU 工具集，包括automake和autoconf使遵从这些标准变得很容易。然而，有时候你可能不想使用GNU工具集，例如，你也许需要一个统一的在 Windows和MacOS平台上都能工作的编译工具(一些工具确实能在Windows平台上工作，它们使用Cygnus的“Cygwin”环境，参看 http://sourceware.cygnus.com/cygwin)。

如果使用了autoconf和automake，除了编译应用程序，用户并不需要有这些工具。使用这些工具的目的是创建能在用户环境使用的、可移植的shell脚本和Makefile文件。Autoconf实际上是一个工具集，其中包含aclocal、autoheader和autoconf等可执行文件。这些工具生成一个可移植的shell脚本—configure，configure和软件包一起发布给用户。它探查编译系统，生成 Makefile文件和一个特殊的头文件config.h。由configure生成的文件能适应用户系统的特定环境。configure脚本从一个称为 Makefile.in的模板文件生成每个Makefile文件。

automake由一个手写的Makefile.am生成Makefile.in文件。Makefile.in文件随软件一同发布，当用户运行 configure时会自动生成Makefile。Libtool软件包是第三个重要的GNU工具，它的作用是确定共享库在特定平台上的特性。因为共享库在不同平台上可能会有所不同。

下面有一些Gnome软件包应该具有的特征：

一个README文件，介绍软件包。

一个INSTALL文件，解释怎样编译、安装软件包。

一个configure脚本，能使程序自动适应特定平台的特征(或者该平台所缺乏的特性)。configure可以带一个参数--prefix，指定要安装的软件包的位置。标准的make目标，比如clean等等。

一个COPYING文件，包含软件包的版权信息。

一个ChangeLog文件，记录了软件的变化。

打包文件，一般用gzip压缩，在名字中包含软件包的版本(例如foo-0.2.1.tar.gz)。它们应该解开到单个目录中，目录应该以软件包及其版本命名，比如foo-0.2.1。

国际化是由GNUgettext软件包提供的。将gettext软件包随应用程序提供给用户，这样用户没有gettext也能够实现国际化。

下面是创建Gtk+/Gnome应用程序源代码树框架的重要步骤：

1)创建一个顶级目录，用以容纳应用程序的所有组件，包括编译文件、文档以及翻译文件。

2)通常在顶级目录下创建一个src子目录，将所有的源代码放在该目录下，并与其他文件分开。

3)在顶级目录下，创建AUTHORS、NEWS、COPYING和README文件。还可以创建一个空的ChangeLog文件。

4)写一个configure.in文件；configure.in文件的主要作用是决定使用什么样的编译器、编译标志以及链接标志。configure.in还可以使用#define符号反映当前平台的特征；它把这些优先放在自动生成的config.h文件里。

5)写一个acconfig.h文件。它是config.h.in文件要使用的模板文件。这个文件应该撤销每个可能在config.h中定义了的符号以避免重复定义（一般在config.h中用#define定义，用#undef撤销定义）autoheader程序基于acconfig.h创建 config.h.in文件，autoconf程序创建config.h文件。autoheader是autoconf软件包中的实用程序。

6)创建一个空的stamp.h.in文件。在configure.in中的AM_CONFIG_HEADER宏会用到它。

7)在顶级目录下，写一个Makefile.am文件，在其中列出每个包含源代码的子目录；在每个子目录中也写一个Makefile.am文件。

8)运行gettext软件包中的gettextize程序。这样可以创建intl和po目录，这是软件国际化所需要的。在intl目录中包含 GNUgettext源代码。如果编译程序的用户没有gettext，它们可以在执行configure脚本时传一个--with-included- gettext参数，让configure在intl目录下自动编译一个gettext的静态版本。在po容纳了翻译文件后，gettextize也会创建一个称为po/Makefile.in.in的文件，用于编译翻译文件。

9)创建一个po/POTFILES.in文件，在其中列出应该扫描字符串以便翻译的源文件。最初的POTFILES.in文件可以是空的。

10)从其他的Gnome模块中复制一个autogen.sh文件和它的宏目录。必须根据自己的软件包的名称修改autogen.sh文件。运行autogen.sh文件将调用libtoolize、aclocal、autoheader、automake以及autoconf。

11)autogen.sh用--add-missing参数调用文件automake。这会添加一些文件，比如带有通用安装指导的 INSTALL文件。编辑INSTALL，在其中包含任何针对应用程序的安装指南。autogen.sh会在每个目录下创建一个Makefile。

2.11.2configure.in文件

autoconf处理configure.in文件，生成一个configure脚本。configure是一个可移植的shell脚本，它检查编译环境以决定哪些库可用，所用平台有什么特征，哪些库和头文件已经找到等等。基于这些信息，它修改编译标记，生成Makefile文件，并/或输出一个包含已定义的预处理符号的config.h文件。configure并不需要运行autoconf，所以在发布应用程序之前生成这个文件，这样，用户就不必有autoconf软件包。

眼前的任务就是写一个configure.in文件。文件基本上是一系列的m4宏，根据传递给它们的参数，这些宏扩展为shell脚本代码段。还可以手工书写shell代码。要真正理解怎样写configure.in文件要求有一些m4的知识以及一些 Bourneshell的知识。幸运的是，有省事的方法；可以找一个已有的configure.in文件，然后修改它以适应你的应用程序。还有一个很全面的autoconf手册，里面介绍了很多随autoconf发布的预先写好的宏。

Gtk+和Gnome的开发者已经进一步简化了这些工作，提供了一些宏用于在用户的系统中定位Gtk+和Gnome。 下面是一个简单的configure.in文件，来自于Gnome版的“Hello,World”：

AC_INIT(src/hello.c)

AM_CONFIG_HEADER(config.h) AM_INIT_AUTOMAKE(GnomeHello,0.1) AM_MAINTAINER_MODE AM_ACLOCAL_INCLUDE(macros) GNOME_INIT AC_PROG_CC AC_ISC_POSIX AC_HEADER_STDC

AC_ARG_PROGRAM AM_PROG_LIBTOOL

GNOME_COMPILE_WARNINGS ALL_LINGUAS=\ AM_GNU_GETTEXT AC_SUBST(CFLAGS) AC_SUBST(CPPFLAGS) AC_SUBST(LDFLAGS) AC_OUTPUT([ Makefile macros/Makefile src/Makefile intl/Makefile po/Makefile.in pixmaps/Makefile doc/Makefile doc/C/Makefile doc/es/Makefile ])

上面以AC开头的宏来自autoconf，以AM开头的宏来自automake。要从autoconf或 automake中寻求帮助，这一点很有用。以GNOME开头的宏来自于Gnomemacros目录。这些宏都是用m4宏语言写的。如果将 autoconf和automake安装在/usr目录下，autoconf和automake中的标准宏一般放在/usr/share/aclocal 目录下。

AC_INIT总是configure.in中的第一个宏。它扩展为许多可由其他configure脚本共享的模板文件代码。这些代码解析传到 configure中的命令行参数。这个宏的一个参数是一个文件名，这个文件应该在源代码目录中，它用于健全性检查，以保证configure脚本已正确定位源文件目录。

AM_CONFIG_HEADER指定了要创建的头文件，差不多总是config.h。创建的头文件包含由configure定义的C预处理符号。最低限度应该定义PACKAGE和VERSION符号，这样可以将应用程序名称和版本传送到代码中，而无须对它们硬编码(非公用的源文件应该包含 config.h(#include)以利用这些定义。然而，不要将

config.h文件安装到系统中，因为它有可能与其他的软件包冲突)。

AM_INIT_AUTOMAKE初始化automake。传到这个宏里的参数是要编译的应用程序的名称和版本号(这些参数成为config.h中定义的PACKAGE和VERSION值)。

AM_MAINTAINER_MODE关闭缺省时仅供程序维护者使用的makefile目标，并修改以使configure能理解 --enable-maintainer-mode选项。--enable-maintainer-mode将maintaineronly目标重新打开。仅供维护者使用的makefile目标允许最终用户清除自动生成的文件，比如configure，这意味着要修复编译故障，必须安装有autoconf和automake软件。注意，因为autogen.sh脚本主要是给开发人员用的，autogen.sh会自动传递一个--enable- maintainer-mode选项给configure。

AM_ACLOCAL_INCLUDE指定一个附加的目录，用于搜索m4宏。在这里，它指定为macros子目录。在这个目录中应该有Gnome宏的拷贝。

GNOME_INIT给configure添加一个与Gnome相关的命令行参数个数，并为Gnome程序定义一些makefile变量，这些变量中包含了必要的预处理程序和链接程序标志。这些标志是由gnome-config脚本取得的。安装gnome-libs时会安装gnome- config脚本。

AC_PROG_CC定位C编译器。

AC_ISC_POSIX添加一些在某些平台上实现POSIX兼容需要的标志。

AC_HEADER_STDC检查当前平台上是否有标准的ANSI头文件，如果有，则定义STDC_HEADERS。

AC_ARG_PROGRAM添加一些选项到configure中，让用户能够修改安装程序的名称(如果在用户系统上碰巧有一个与要安装的程序名称相同的程序，这是很有用的)。

AM_PROG_LIBTOOL是由automake用来设置libtool的用途的。只在计划编译共享库或动态可加载模块时才需要设置这个值。

GNOME_COMPILE_WARNINGS给gcc命令行添加许多警告选项，但是在其他绝大多数的编译器上什么也不做。

ALL_LINGUAS=“es”不是一个宏，只是一句shell代码。它包含一个由空格分隔的语言种类缩写表，对应于

po子目录下的.po文件。.po文件包含翻译成其他语言的文本，所以ALL_LINGUAS应该列出程序已经被翻译成的所有语言。

AM_GNU_GETTEXT由automake使用，但是这个宏会随gettext软件包发布。它让 automake执行一些与国际化相关的任务。

AC_SUBST输出一个变量到由configure生成的文件中。具体内容将在后面说明。

AC_OUTPUT列出由configure脚本创建的文件。这些文件都是由带.in后缀的同名文件生成的。例如，src/Makefile是由src/Makefile.in生成的，config.h是由config.h.in生成的。在执行AC_OUTPUT宏时，configure脚本处理包含有两个@符号标志的变量(例如@PACKAGE@)的文件。只有用AC_SUBST输出了变量，它才能识别这些变量(许多在上面讨论过的预先写好的宏都用AC_SUBST定义变量)。这些特征用于将一个Makefile.in文件转换成一个Makefile文件。典型情况下，Makefile.in 是由automake从Makefile.am生成的(不过，你可以只用autoconf，而不用automake，自己编写一个 Makefile.in)。

2.11.3Makefile.am文件

automake处理Makefile.am，生成一个符合标准的Makefile.in文件。automake会做很多工作：例如，它维护源文件之间的依赖关系；生成所有的标准目标，比如install和clean；它还生成更复杂的目标：如果Makefile.am是正确的，简单输入 makedist就会创建一个标准的.tar.gz文件。

一般情况是在最上层目录下写一个Makefile.am，然后在每一个子目录下分别写一个Makefile.am文件。automake会从最上层开始递归处理各个Makefile.am，然后生成一个Makefile.in。在最上层目录的Makefile.am通常都很简单，下面是一个例子：

SUBDIRS=macrospointlsrcpixmapsdoc EXTRA_DIST=\\ gnome-hello.desktop

Applicationsdir=$(datadir)/gnome/apps/Applications Applications_DATA=gnome-hello.desktop

上面程序的第一行通知automake在给定的子目录中递归查找Makefile.am文件。在src子目录的Makefile.am是这样的：

INCLUDES=-I$(top_srcdir)-I$(includedir)$(GNOME_INCLUDEDIR)\\ -DG_LOG_DOMAIN=\ -DGNOMELOCALEDIR=\ -I../intl-I$(top_srcdir)/intl bin_PROGRAMS=gnome-hello gnome_hello_SOURCES=\\ app.c\\ hello.c\\ menus.c\\ app.h\\ hello.h\\ menus.h

gnome_hello_LDADD=$(GNOMEUI_LIBS)$(GNOME_LIBDIR)$(INTLLIBS)

automake能够理解许多“不可思议的变量”，并用这些变量创建Makefile.in文件。在上面的小例子中，用到了下面的变量：

INCLUDES指定了在编译阶段(与连接阶段相对)中传递给C编译器的标志。这一行用到的变量来自

2.11.2节中的configure.in文件。

bin_PROGRAMS列出了要编译的程序。

hello_SOURCES列出了要编译和连接的文件，这些文件是依赖生成hello程序的。程序名必须列在bin_PROGRAMS中。在这个变量中的所有文件都被自动包含在发布包中。

hello_LDADD列出了要传递给连接程序的标志。在这个例子中是由configure决定的Gnome库标志。

INCLUDES行中有几个在所有的Gnome程序中都应该用到的元素。应该定义G_LOG_DOMAIN，来自与校验和断言代码中的错误信息会报告这个值，这样就能够判定错误是发生在什么地方(在代码中，还是在一个库中)。GNOMELOCALEDIR用于定位翻译文件。intl目录被添加到了头文件的搜索路径，这样应用程序就能够找到intl头文件。

在Makefile.am中还可以做很多复杂的事，特别是，可以添加两端带有@符号的、能带入到configure脚本中的变量。可以有条件地包含基于configure校验的Makefile文件中的一部分，还可以建立库。automake的手册介绍了细节内容。

表2-1概括了由automake生成的最常见的make目标。当然，缺省的make目标是all，它编译整个程序。GNU代码标准 (http://www.gnu.org/prep/standards_toc.html)中有这些make目标和GNUMakefile文件的详细信息。

2.11.4安装支持文件

完整的Gnome应用程序还有许多代码以外的东西。它们有在线帮助(要列在Gnome的主菜单上)，有界面翻译，还有一个桌面图标。它们也许带一个pixmap以及一个用在“关于”对话框上的徽标、一个用于“向导”的图形或者一个用以帮助用户快速区别菜单项或列表元素的小图标。下面的内容介绍怎样发布这些文件。

1.安装数据文件：文档和pixmap

文档和pixmap的安装方法是差不多的。automake允许你将数据文件安装到任意位置，可以用配置文件中定义的变量决定将它们安装到哪里。

(1)pixmap

要从Makefile.am中安装数据文件，只需简单地为安装目标指定一个名字(pixmap就不错)然后为该目录和要安装到目录里的文件分别创建一个变量。例如：

EXTRA_DIST=gnome-hello-logo.png pixmapdir=$(datadir)/pixmaps pixmap_DATA=gnome-hello-logo.png fill

“pixmap”字符串将pixmap_DATA变量和pixmapdir变量连接起来。automake解释_DATA前缀，并在 Makefile.in中生成适当的安装规则。这个Makefile.am片断将gnome-hello-logo.png文件安装到$(datadir)/pixmaps目录下，$(datadir)是由configure分配的变量。典型情况下，$(datadir)是/usr /local/share(更精确的说，是$(prefix)/share)，这是独立于体系结构的数据文件(也就是，几个具有不同二进制文件格式的系统共享的文件)的标

准位置。

Gnome的pixmap图片的标准位置是$(datadir)/pixmaps，所以在例子中我们这样用。Gnome项目鼓励在所有的 pixmap图片中使用PNG格式，这个格式是gdk_imlib(Gnome图象加载库)支持的。它的文件尺寸小，速度快，也不存在专利问题。

(2)文档

安装文档使用同样的原则，不过稍有一点复杂。Gnome文档通常是用DocBook写的。DocBook是一个 SGMLDTD(DocumentTypeDefinition，文档类型定义)，就像HTML一样。然而，DocBook的文档标签是为技术文档设计的。用DocBook写的文档可以转换为其他格式，包括PostScript和HTML。依照标准，应该安装HTML格式的文档，用户就可以用Web浏览器或Gnome帮助浏览器阅读文档。

Gnome库和帮助浏览器能理解一个名为topic.dat的文件，这个文件只是一个含有相应URL的帮助主题列表。它起应用程序帮助主题索引的作用。下面是一个例子，只有两条：

gnome-hello.htmlGnomeHellomanual advanced.htmlAdvancedTopics

URL路径相对于所安装的帮助文件的目录。

应该预先考虑文档可能会翻译为其他语言。最好为每一个地区建立一个子目录，例如，缺省地区(C)或es(西班牙语)。使用这种方法翻译程序不会引起混乱。一般将Gnome帮助安装在以地区开头的目录下，这种做法用其他观点来看也是很方便的。文档目录看起来也许和GnomeHello示例程序差不多：

doc/ Makefile.am C/

Makefile.am gnome-hello.sgml topic.dat es/ Makefile.am

gnome-hello.sgml topic.dat

下面是doc/C/Makefile.am：

gnome_hello_helpdir=$(datadir)/gnome/help/gnome-hello/C gnome_hello_help_DATA=\\ gnome-hello.html\\ topic.dat SGML_FILES=\\ gnome-hello.sgml

#filesthataren?tinabinary/data/librarytargethavetobelistedhere #tobeincludedinthetarballwhenyou?makedist? EXTRA_DIST=\\ topic.dat\\ $(SGML_FILES)

##The-beforethecommandmeanstoignoreitifitfails.Thatway ##peoplecanstillbuildthesoftwarewithoutthedocbooktools all:

gnome-hello.html:gnome-hello/gnome-hello.html -cpgnome-hello/gnome-hello.html.

gnome-hello/gnome-hello.html:$(SGML_FILES) -db2htmlgnome-hello.sgml

##whenwemakedist,weincludethegeneratedHTMLsopeopledon?t ##havetohavethedocbooktools dist-hook:

mkdir$(distdir)/gnome-hello

-cpgnome-hello/*.htmlgnome-hello/*.css$(distdir)/gnome-hello -cpgnome-hello.html$(distdir) install-data-local:gnome-hello.html

$(mkinstalldirs)$(gnome_hello_helpdir)/images

-forfilein$(srcdir)/gnome-hello/*.html$(srcdir)/gnome-hello/*.css;do\\ basefile=`basename$$file`;\\

$(INSTALL_DATA)$(srcdir)/$$file$(gnome_hello_helpdir)/$$basefile;\\ done

gnome-hello.ps:gnome-hello.sgml -db2ps$<

gnome-hello.rtf:gnome-hello.sgml -db2rtf$<

需要特别注意的是生成的HTML文件的安装目录：$(datadir)/gnome/help/gnome-hello/C。Gnome库在这里查找帮助文件。每个应用程序的帮助都放在$(datadir)/gnome/help下的它自己的目录下。每个地区的文档都安装在应用程序目录的对应于地区的子目录下。

2..desktop入口

Gnome程序带有一个.desktop入口，它是一个以desktop为后缀的文本文件，描述应用程序应该放在Gnome主菜单的什么位置。安装一个.desktop入口文件可以让应用程序显示在Gnome面板菜单（主菜单）中。下面是gnome-hello.desktop文件：

[DesktopEntry] Name=GnomeHello Name[es]=GnomeHola Name[fi]=GNOME-hei Name[no]=Gnomehallo Name[sv]=GnomeHej Comment=HelloWorld Comment[es]=HolaMundo Comment[fi]=Hei,maailma Comment[sv]=HejV?rlden Comment[no]=Halloverden

Exec=gnome-hello Icon=gnome-hello-logo.png Terminal=0 Type=Application

这个文件由键－值对组成。Name键指定在缺省地区场合的名称；任何键都可以有一个用于标明地区的字符串，放在一对方括号里面。当登录到X窗口时，如果指定了不同的地区，系统会根据语言从这里读取相应的字符串。Comment键是一个“工具提示”或“暗示”，用以更详细地描述应用程序。Exec 是用来执行程序的命令行。Terminal是布尔类型，如果为非0值，程序在一个终端内运行。在这里Type应该是“Application” 安装一个.desktop条目很简单。下面是GnomeHello中的最顶层的Makefile.am文件：

SUBDIRS=macrospointlsrcpixmapsdoc EXTRA_DIST=\\ gnome-hello.desktop

Applicationsdir=$(datadir)/gnome/apps/Applications Applications_DATA=gnome-hello.desktop

注意，在$(datadir)/gnome/apps/下有一个目录树，可以将应用程序安装到下面子目录所对应的类别中。GnomeHello 将自己安装在“Applications”类中，而其他的应用程序也许会选择Games、Graphics、Internet或者其他合适的地方。尽量选择一个已经存在的类别，而不是自己建一个。

Makefile.am中的EXTRA_DIST变量列出了需要包含在发布软件包(压缩的tar文件)中的文件。最重要的文件会自动包含进来，例如，所有作为二进制或库的源文件的文件都会自动包含。

然而，automake并不认识.desktop文件，或SGML文档，所有这些文件必须列在EXTRA_DIST中。如果将这些文件留在EXTRA_DIST之外，用makedistcheck命令编译发布程序通常会失败。

本文来源：https://www.bwwdw.com/article/s9fw.html