automake连载---关于两个文件configure.in和Makefile.am的编写
http://blog.csdn.net/shanzhizi/article/details/30251763
automake主要通过编辑Makefile.am来控制它的行为,下面就常用的三个Makefile.am配置做出说明。
1.1. autotools的工作原理
autotools最终是为了生成Makefile,为此,需要使用到autotools系列工具的如下几个命令:
l autoscan
l aclocal
l autoheader
l autoconf
l automake
另外,还需要有两类输入文件:configure.in和Makefile.am。其中,configure.in是用来生成configure脚本的,configure脚本的作用主要有两个:检测系统的环境,生成Makefile。而Makefile.am则是生成Makefile的参数,它们之间是一一对应的。一般来说,在一个工程中每个目录下都会有一个Makefile来管理当前目录下的文件。所以,基本上每个目录中都需要编写一个Makefile.am,来描述当前目录下生成的Makefile的行为。
有了生成工具和输入文件,下面来看一下生成Makefile的流程,如下图所示:
需要说明的是autoscan工具的使用,autoscan检测当前目录下的所有文件,生成一个configure.scan,这个文件可以作为configure.in文件的雏形,在它的基础上稍做修改就可以作为configure.in文件来使用。所以,autoscan工具只需要在工程创建时运行一次即可。
下面就来具体介绍两个输入文件的编写规则:
1.2. 编写Makefile.am
1.2.1. Makefile.am规则
Makefile.am写起来相对简单,有共有5类规则,如下表
表1.2.1 Makefile.am中的规则
文件类型 |
书写格式 |
可执行文件 |
bin_PROGRAMS = foo foo_SOURCES = xxx.c xxxx.c foo_LDADD = foo_LDFLAGS = foo_DEPENDENCIES = |
静态库 |
lib_LIBRARIES = foo.a foo_a_SOURCES = xxx.c xxxx.c foo_a_LDADD = foo_a_LIBADD = foo_a_LDFLAGS = |
动态库 |
lib_LTLIBRARIES = foo.la foo_la_SOURCES = xxx.c xxxx.c foo_la_LDADD = foo_la_LIBADD = foo_la_LDFLAGS = |
头文件 |
include_HEADERS = foo.h noinst_HEADERS = foo2.h |
数据文件 |
data_DATA = data1 data2 |
其中,生成动态库的同时还会自动生成一个静态库,所以在一般情况下都不直接使用静态库规则。
Makefile.am中还有一些可以直接使用的全局变量,表示所有目标所共享的一些属性,见下表:
表1.2.2 Makefile.am中的变量
变量 |
含义 |
INCLUDES |
编译时所需头文件 |
LDADD |
链接时所需链接的库文件 |
LDFLAGS |
链接时的选项 |
AM_CXXFLAGS |
编译.cpp文件时的选项 |
AM_CFLAGS |
编译.c文件时的选项 |
EXTRA_DIST |
除源代码和一些默认的文件以外,其它需要打如发布包.tar.gz中的文件 |
SUBDIRS |
在处理本目录之前要递归处理的子目录 |
top_srcdir |
工程源码的最顶层目录 |
top_builddir |
工程目标文件的最顶层目录 |
有了以上的规则和变量,我们可以完成最基本的Makefile.am编写,但在某些情况下,我们需要定义一些变量来控制工程中某些目标的生成:比如库的版本号是不断变化的,需要定义一个变量来指代。Makefile.am可以使用宏替换来实现这种功能,可以通过以下方式来引用一个宏:
@宏名@
这个宏的的定义是在configure.in中的,在1.3.节中会介绍它的定义方法。
现在Makefile.am中所需要了解的规则和语法已经介绍完了,下面介绍一下如何使用这些规则来具体生成一个库和可执行程序。
1.2.2. 库的生成
要生成一个库,需要在Makefile.am中加入一套动态库规则(见表1.2.1),如现在要用hello1.cpp和hello2.cpp两个源文件生成动态库libhello.so,库的版本为1.0.10,库需要额外连接一个叫做libworld.so的库,我们可以这样写:
lib_LTLIBRARIES = hello.la
hello_la_SOURCES = hello1.cpp hello2.cpp
hello_la_LIBADD = -lworld
hello_la_LDFLAGS = -version-info 1.0.10
可以看到,在LIBADD规则中链接库文件的方法与使用g++编译时的相同。但LDFLAGS规则中的属性就没有见过了。实际上,这个参数是传给libtool生成库时使用的,除了-version-info这个参数之外,LDFLAGS编译库时还会经常使用下面两个参数:
l -avoid-version 生成不带版本号的库
l -all-static 生成为静态库
1.2.3. 可执行文件的生成
要生成一个可执行文件,需要加入一套可执行文件的规则(见表1.2.1),与生成动态库的规则很类似。下面我们要使用源文件main.cpp生成可执行文件main,该可执行文件需要链接上面生成的库libhello.so,我们可以这样写:
bin_PROGRAMS = main
main_ SOURCES = main.cpp
main_ LDADD = -lhello
main_LDFLAGS = -I./include
1.3. 编写configure.in文件
与Makefile.am相比,configure.in文件写起来更复杂,因为configure.in文件中可以使用的资源要远多与Makefile.am。但通常情况下,我们都可以借助autoscan工具帮助我们生成一个configure.in的模版,在此基础上再完善就可以了。所以,实际上我们只需要在configure.in中修改以下两个参数就可以了:
AC_INIT(package_name, package_version, owner_email)
AC_CONFIG_FILES([makefile1_path
makefile2_path])
AC_INIT()选项中指明了工程的名字,当前工程的版本号,工程所有者的邮箱。
AC_CONFIG_FILES()中指明了所有要生成的Makefile的相对路径,由于每个Makefile都需要一个Makefile.am作参数,所以该选项中Makefile的数量和路径应与当前工程中Makefile.am的状态一致。
在经过上面的修改之后,一个configure.in文件就基本可以使用了,但通常情况下,我们需要对它进行更多的配置。
1.3.1. 在configure.in中定义外部变量
在configure.in中定义变量与写shell脚本时定义变量的语法相同,如我们要定义一个值为nihao的变量hello,我们可以这样写:
hello=nihao
但使用这个变量的方法就有些不同了,比如我们要将hello这个变量赋给hi这个变量,我们可以这样写:
hi=”$hello”
如果这个变量需要被外部引用的话(如在1.2.1节中提到的Makefile.am引用configure.in中定义的变量),需要一个额外的选项来完成,如我们要将hello定义为外部变量,可以写成:
AC_SUBST(hello)
而Makefile.am中也就可以通过对它的引用来完成对某些可变因子的替换,在Makefile.am中的引用方法见1.2.1节。
1.3.2. 给configure配置自定义参数
对于一个已经生成好的configure,执行./configure --help命令可以看到该脚本所支持的所有参数,其中大部分是其自带的。同样,我们可以通过对configure.in的配置来给它添加新的参数。可以配置的参数种类有很多种,常用的有以下2种格式:
--enable-xxx 和 --disable-xxx
--with-xxx 和 --with-out-xxx
可以分别通过以下2个宏来定义这两个参数:
AC_ENABLE (feature, action-if-given, [action-if-not-given])
AC_ARG_WITH (package, help-string, [action-if-given], [action-if-not-given])
这两种格式基本上可以互换,下面就以AC_ARG_WITH()为例,说明如何给configure加上一个自定义参数。
假设我们要增加一个选项表示是否需要编译一个名为agent的模块,可以这样写:
BUILD_AGENT=no
AC_ARG_WITH([agent],
[AS_HELP_STRING([--with-agent],
[build agent(default is no)])],
[BUILD_AGENT=yes],
[BUILD_AGENT=no])
if test "x$BUILD_AGENT" = "xyes";then#判断是否加上了该参数
#做出相应动作
fi
这样,./configure就新添了两个选项--with-agent和--with-out-agent,通过这两个选项可以控制变量BUILD_AGENT的值,然后做出相应的动作。
automake连载---关于两个文件configure.in和Makefile.am的编写的更多相关文章
- automake--关于两个文件configure.in和Makefile.am的编写
http://blog.csdn.net/shanzhizi/article/details/30251763 automake主要通过编辑Makefile.am来控制它的行为,下面就常用的三个Mak ...
- automake连载--Linux下使用automake入门
http://blog.csdn.net/shanzhizi/article/details/30246587 近来重要要总结一下automake的用法了,连载几篇网上已有的文章,以供参考. 作为Li ...
- automake连载--Linux下使用autoconfig automake进阶
http://blog.csdn.net/shanzhizi/article/details/30247325 前言: 这次task,我大概用了4天的时间去完成.四天的时间内,我不停地去查 ...
- putty提供的两个文件传输工具PSCP、PSFTP详细介绍
用 SSH 来传输文件 PuTTY 提供了两个文件传输工具 PSCP (PuTTY Secure Copy client) PSFTP (PuTTY SFTP client) PSCP 通过 SSH ...
- diff 比较两个文件的差异
功能:比较两个文件的差异,并把不同地方的信息显示出来.默认diff格式的信息. diff比较两个文件或文件集合的差异,并记录下来,生成一个diff文件,这也是我们常说的补丁文件.也使用patch命令对 ...
- Linux下对比两个文件夹的方法
最近拿到一份源代码,要命的是这份源代码是浅克隆模式的git包,所以无法完整显示里面的修改的内容. 今天花了一点点时间,找了一个在Linux对比两个文件夹的方法. 其实方法很简单,用meld 去对比两个 ...
- PHP两个文件的相对路径
/** * relativePath 计算两个文件的相对路径 * @param file1 参作为考路径 * @param file2 相对于$file1的路径 */ function relativ ...
- linux 两个文件合并
可以使用cat命令,有两种实现的方式,一种将两个文件合并的到一个新的文件,另一种将一个文件追加到另一个文件的末尾. 方法一:使用cat命令从文件中读入两个文件,然后将重定向到一个新的文件.这种方法可以 ...
- linux两个文件修改主机名
linux修改主机名的方法 用hostname命令可以临时修改机器名,但机器重新启动之后就会恢复原来的值. #hostname //查看机器名#hostname -i //查看本机器名对应的ip ...
随机推荐
- nginx反向代理二级页面
当公司只存在一个公网地址时候,需要影射多个域名,并且域名下面要配置二级目录的时候 可以参照如下配置 upstream h5_game { server 10.0.100.153:80; } serve ...
- Calendar类进行日期操作
import java.util.Calendar; import java.util.Date; import java.util.GregorianCalendar; /** * 测试日期类 * ...
- Python开发基础-Day17面向对象编程介绍、类和对象
面向对象变成介绍 面向过程编程 核心是过程(流水线式思维),过程即解决问题的步骤,面向过程的设计就好比精心设计好一条流水线,考虑周全什么时候处理什么东西.主要应用在一旦完成很少修改的地方,如linux ...
- Python开发基础-Day3-列表、元组和字典
列表 列表定义:[]内以逗号分隔,按照索引,存放各种数据类型,每个位置代表一个元素 特性: 1.可存放多个值 2.可修改指定索引位置对应的值,可变 3.按照从左到右的顺序定义列表元素,下标从0开始顺序 ...
- 文件包含漏洞检测工具fimap
文件包含漏洞检测工具fimap 在Web应用中,文件包含漏洞(FI)是常见的漏洞.根据包含的文件不同,它分为本地文件包含漏洞(LFI)和远程文件包含漏洞(RFL).利用该漏洞,安全人员可以获取服务 ...
- (hdu1007)Quoit Design,求最近点对
Problem Description Have you ever played quoit in a playground? Quoit is a game in which flat rings ...
- [BZOJ4824][CQOI2017]老C的键盘(树形DP)
4824: [Cqoi2017]老C的键盘 Time Limit: 10 Sec Memory Limit: 512 MBSubmit: 193 Solved: 149[Submit][Statu ...
- BZOJ 4025 二分图(时间树+并查集)
[题目链接] http://www.lydsy.com/JudgeOnline/problem.php?id=4025 [题目大意] 给出一张图,有些边只存在一段时间,问在一个每个时间段, 这张图是否 ...
- [AGC026B]rng_10s
题意:一个商店,第一天早上有$A$罐苹果汁,一个人每天上午都会来买$B$罐,每天晚上如果剩余罐数$\leq C$那么会增加$D$罐,问能否无限买 收集一个套路...? 首先如果$B\gt A$或者$B ...
- 【贪心】【堆】Gym - 101128C - Canvas Painting
一些画布,每块有其大小,一开始都是白的,你任意将它们排序,然后一次操作可以选择一段连续的相同颜色的画布,从中任选一个位置,左侧涂上任意一种颜色,右侧涂上另一种.消耗是这一段画布的总的大小.问你要将所有 ...