mooon编译系统介绍（可复用Makefile）

目录

1. 简要 1

2. 文件组成 1

2.1. 各文件的渊源关系图 2

3. 操作步骤：您需要做的 5

4. 修改configure.ac.in文件 5

5. 修改Make.rule.in文件 6

6. 修改主目录Makefile.am文件 6

7. 修改子目录Makefile.am.in文件 7

7.1. 静态库 7

7.2. 共享库 7

7.3. 可执行程序 8

7.4. _SOURCES 8

附1：编译系统文件包 9

附2：常见Makefile.am变量 9

附3：其它渊源关系图 11

渊源关系图1 12

渊源关系图2 13

渊源关系图3 14

渊源关系图4 14

1. 简要

不需要花时间去学习automake和Makefile，任何C/C++项目，都可以非常容易的复用mooon（http://code.google.com/p/mooon）的编译系统。

它基于标准的automake，但在automake的基础上增加了一个bootstrap.sh脚本文件。bootstrap.sh做了些自动化工作，从而简化了automake的使用，其中一个重要作用是基于模板Makefile.am.in生成Makefile.am。不再需要手工一个个地去填写源代码文件。

※建议：mooon编译系统虽易于使用，但仍建议对Makefile和automake做些了解。

2. 文件组成

原始文件		bootstrap.sh新生成文件
主目录下	子目录下	主目录下	子目录下
bootstrap.sh 以下三个是需要修改的文件： configure.ac.in Make.rules.in Makefile.am 以下文件可不做任何修改，直接拿过去即可： AUTHORS ChangeLog COPYING INSTALL ttmain.sh NEWS README	Makefile.am.in或 Makefile.am 这两个文件也是需要修改的	configure.ac Make.rules	Makefile.am

※上表格中后缀为.in的文件为模板文件，是bootstrap.sh需要的，而不是标准automake规定的。经过bootstrap.sh后，会发生Makefile.am同目录下有Makefile.in文件，它是automake命令根据Makefile.am生成的Makefile模板文件。

2.1. 各文件的渊源关系图

以下几个图（均取自互联网，版权归原作者所有，在此借用表示感谢）都是同一个意思，同时放上来，有助于更详细的了解它们间的渊源关系：

渊源关系图1

渊源关系图2

渊源关系图3

渊源关系图4

configure.in和configure.ac两者只需要一个，configure.ac是新的命名方式。基于bootstrap.sh的automake，省去了configure.scan，原因是直接使用了现存的configure.ac.in。

在configure.ac.in中，有一行是“AC_PREREQ(AUTOCONF_VERSION)”，bootstrap.sh会将“AUTOCONF_VERSION”替换成实际的autoconf版本号，具体实现可参见bootstrap.sh中的replace_autoconf_version()函数实现。

3. 操作步骤：您需要做的

1) 配置好如下几个文件：

configure.ac.in

Make.rule.in

主目录下的Makefile.am

子目录下的Makefile.am.in或Makefile.am

2) 执行bootstrap.sh脚本文件，以生成以下文件：

configure.ac

Make.rule

子目录下的Makefile.am

※这一步是非标准automake要求的，而是mooon编译系统独特增加的一步，经历这一步之后，就和标准的automake完全相同了，只要没有源代码文件的增、减和改名，执行一次后，就不用再次执行。

从下面开始的步骤，和标准的automake完全相同：

3) 执行configure脚本文件，以生成Makefile文件

4) 执行make命令，开始编译

5) 编译成功后，可以再执行make install命令进行安装

4. 修改configure.ac.in文件

只有一处是必须修改的，如下：

AC_CONFIG_FILES([

Makefile

x/Makefile

])

其中，上述第二行的Makefile是必须的，而第二行之后的内容根据实际处理，上述表示需要在子目录x下生成一个Makefile文件。假设有多个子目录（分别为：abc，bbb和xyz），则如下：

AC_CONFIG_FILES([

Makefile

abc/Makefile

bbb/Makefile

xyz/Makefile

])

※注：子目录可是多级目录，如mooon-common_component主目录下的configure.ac.in：

AC_CONFIG_FILES([

Makefile

conf/Makefile

loader/Makefile

server/Makefile

http_parser/Makefile

dispatcher/Makefile

observer/Makefile

agent/Makefile

agent/tester/Makefile

agent/center/Makefile

])

上述的tester和center就是多级子目录了。

对于configure.ac.in文件，除了上述修改外，还可以修改如下两行（但不是必须的）：

AC_INIT(jian, 0.1.0, eyjian@qq.com)

AM_INIT_AUTOMAKE(common_library, 0.1.0)

其中common_library为库的名称，或者产品名称等，0.1.0则是版本号。jian可以改成公司名或个人名等。

5. 修改Make.rule.in文件

Make.rule.in用于定义公共的编译选项和链接用参数，如果没有这方面的需求，则可对Make.rule.in不做任何修改。

但推荐良好的做法：

1) 将用到的第三方库的include定义在Make.rule.in，以方便在子目录的Makefile.am.in中直接引用；

2) 将用到的第三方库的lib定义在Make.rule.in，以方便在子目录的Makefile.am.in中直接引用；

3) 其它的通用编译选项和链接用参数等。

6. 修改主目录Makefile.am文件

请注意，主目录下只有Makefile.am，而不会有Makefile.am.in。它的内容非常简单，模板中仅包括如下两行内容：

EXTRA_DIST =

SUBDIRS = x

EXTRA_DIST和SUBDIRS都是标准automake的关键词。一般只需要关注SUBDIRS，它后面跟着书写各子目录名（需要生成Makefile文件的子目录名），可以包含多个子目录和多级子目录，如下面是mooon-common_component的主目录Makefile.am的内容：

EXTRA_DIST =

SUBDIRS = conf loader server http_parser observer dispatcher agent agent/tester agent/center

※注：等号左右两边的空格不是必须的，可有可无。

7. 修改子目录Makefile.am.in文件

Makefile.am.in主要是配置需要生成的静态库文件、共享库（也叫动态库）文件和可执行程序文件。它们三个的配置是可以并存，同时出现的，只要名称不同，各都可出现多次。

请特别注意，bootstrap.sh只会处理Makefile.am.in，通过它生成Makefile.am。如果不想bootstrap.sh做任何处理，只需要去掉Makefile.am.in文件，直接使用Makefile.am即可。

7.1. 静态库

静态库必须包括的内容如下：

libdir=$(prefix)/lib

lib_LIBRARIES = libx.a

libx_a_SOURCES =

其中libx.a是静态库的文件名，需要根据实际修改，请注意它的书写方式。libdir用于指定make install后静态库安装的路径。lib_LIBRARIES用于需要生成的静态库名称。

7.2. 共享库

共享库必须包括的内容如下：

moduledir=$(prefix)/lib

module_PROGRAMS = libx.so

libx_so_SOURCES =

对于共享库，AM_LDFLAGS和AM_CXXFLAGS中包含-fPIC是必须的，而且AM_LDFLAGS中必须包含-shared以表示生成共享库。

其中libx.so是共享库的文件名，请注意它的书写方式。moduledir用于指定make install后共享库的安装路径；module_PROGRAMS用于需要生成的共享库名称。

7.3. 可执行程序

可执行程序必须包括的内容如下：

bindir=$(prefix)/lib

bin_PROGRAMS = x

x_SOURCES =

其中x是可执行程序的文件名，请注意它的书写方式。bindir用于指定make install后可执行程序的安装路径；bin_PROGRAMS用于需要生成的可执行程序名称。

7.4. _SOURCES

“_SOURCES”用于指定需要编译哪些源代码文件（必须包括实现文件，也可选包含头文件）。

在模板中，我们可以看到含“_SOURCES”一行都是空的的，等号后没有内容。注意等号后虽然是空的，但等号仍是必须的。

bootstrap.sh存在的一个最重要的原因是在执行bootstrap.sh时，自动填充“_SOURCES”的值。

bootstrap.sh中的gen_makefile_am()函数完成填充“_SOURCES”的值。

共有四种方式来确定“_SOURCES”的值内容：

1) 手工填写，如：libx_a_SOURCES = x.cpp x.h；

2) 保留为空，让bootstrap.sh自动填写：

如果“_SOURCES”为空，则bootstrap.sh会使用“find . -maxdepth 2 | awk '/.cpp$|.cc$|.h$|.hpp$/{printf("%s ", $0)}'”命令输出的结果作为它的值。

bootstrap.sh会自动切换到与Makefile.am.in相同的子目录下执行find命令。

3) 使用脚本文件的输出结果作为“_SOURCES”的值：libx_a_SOURCES = x.sh。这里，“x.sh”是一个可执行脚本文件，bootstrap.sh使用它的输出替换掉x.sh。注意x.sh也是在与Makefile.am.in相同的子目录下被执行。

4) 使用一段脚本代码作为“_SOURCES”的值：libx_a_SOURCES = ls *.cpp。这里“ls *.cpp”是一段可执行的脚本代码，而不是脚本文件，bootstrap.sh使用它的输出作为“_SOURCES”的值。注意也是在与Makefile.am.in相同的子目录下被执行

附1：编译系统文件包

x.zip（下载网址：https://mooon.googlecode.com/svn/trunk/x.zip）

解压后结构如下图所示：

附2：常见Makefile.am变量

这里讲的是可能需要修改的变量：

变量名	变量说明
INCLUDES	用于指定编译时搜索的头文件所在路径，多行时使用“+=”连接起来
LDADD	用于指定链接参数，多行时使用“+=”连接起
AM_LDFLAGS	用于指定链接参数，多行时使用“+=”连接起
AM_CXXFLAGS	用于指定C++代码的编译参数，多行时使用“+=”连接起

如果在一个Makefile.am或Makefile.am.in中有多个生成目标（静态库、共享库和可执行程序），编译和链接参数不同时，可以采用：

目标名称_LDADD

目标名称_LDFLAGS

来指定，如生成x需要使用到libx.a，而不需要libz.a：

x_LDADD = libx.a

z_LDADD = libz.a

但请注意，将它们放置于相应的“_SOURCES”之前。

n Makefile.am

附3：其它渊源关系图

特别声明：以下图片均来自互联网，版本归原作者所有，在此借用表示感谢。

渊源关系图1

渊源关系图2

渊源关系图3

渊源关系图4