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