automake使用
antuomake 流程图:
http://blog.csdn.net/houwei544/article/details/8185916 这个教程不错
https://www.ibm.com/developerworks/cn/linux/l-makefile/
使用antuomake工具方法:
以程序add.c为例:
准备条件:先makedir一个目录,把需要的add.c文件放入到目录中
Ubantu下 安装:sudo apt-get install automake
1.在add.c所在的目录下通过autoscan命令生成autoscan.log configure.scan .
Autoscan工具用来扫描源代码以搜寻一般的可移植性问题,比如检查编译器、库和头文件等,并创建configure.scan文件,它会在给定目录及其子目录树中检查源文件,若没有给出目录,就在当前目录及其子目录树中进行检查。
configure.ac (sometimes also named: configure.in) is an input file for autoconf.
vim configure.scan 内容如下:
#####################################################################################################
# -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.
AC_PREREQ([2.69]) #autoscan 工具版本号2.69
AC_INIT([FULL-PACKAGE-NAME], [VERSION], [BUG-REPORT-ADDRESS])
# AC_INIT宏用来定义软件的名称和版本等信息,”FULL-PACKAGE-NAME”为软件包名称,#”VERSION”为软件版本号,”BUG-REPORT-ADDRESS”为BUG报告地址(一般为软件作者邮#件地址)。
AC_CONFIG_SRCDIR([add.c])
#AC_CONFIG_SRCDIR宏用来侦测所指定的源码文件是否存在,来确定源码目录的有效性。此#处为当前目录下的hello.c。
AC_CONFIG_HEADERS([config.h])
#AC_CONFIG_HEADER宏用于生成config.h文件,以便autoheader使用。
# Checks for programs.
AC_PROG_CC
#AC_PROG_CC用来指定编译器,如果不指定,选用默认gcc。
# 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_OUTPUT用来设定 configure 所要产生的文件,如果是makefile,configure会把它检查出来的结果带入makefile.in文件产生合适的makefile。使用Automake时,还需要一些其他的参数,这些额外的宏用aclocal工具产生。
####################################################################################################
修改configure.scan 为configure.in或者configure.ac内容如下:
# -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.
AC_PREREQ([2.69]) //automake版本
AC_INIT(add, 1.0 ,277538911@qq.com) //设置软件包信息
AM_INIT_AUTOMAKE(add, 1.0) //这个需要手动添加,它是automake必备的宏
AC_CONFIG_SRCDIR([add.c]) //源文件名
#AC_CONFIG_HEADERS([config.h])//config.h 文件, 这个地方我们不需要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
####################################################
2.同步骤一运行aclocal命令:会生成如下文件
aclocal.m4 add.c autom4te.cache autoscan.log configure.in
//aclocal程序来生成你的 aclocal.m4 ,aclocal根据configure.in文件的 内容,自动生成aclocal.m4文件,aclocal是 一个perl 脚本程序
//注意:如果只有autom4te.cache 没有aclocal.m4可能忘记了贴加宏 AM_INIT_AUTOMAKE(add, 1.0)这个需要手动添加,它是automake必备的宏
3.运行autoconf命令生成执行文件configure
autoconf 是 用来生成自动配置软件源代码脚本(configure)的 工具,configure脚本能独立于autoconf运行,且在 运行的 过程中,不需要用户的 干预.
4.新建Makefile.am文件(第四部会根据工程的不同,编写的makefile.am内容有所不同)
(1)以add.c单独的文件为例子 ,Makefile.am内容如下:
编辑:
cat Makefile.am
AUTOMAKE_OPTIONS=foreign //软件等级
bin_PROGRAMS=add //可执行文件名
add_SOURCES=add.c //源文件名
automake会根据你写的 Makefile.am来自动生成Makefile.in.
其中:
AUTOMAKE_OPTIONS为设置Automake的选项。由于GNU对自己发布的软件有严格的规范,比如必须附带许可证声明文件COPYING等,否则Automake执行时会报错。Automake提供了3种软件等级:foreign、gnu和gnits,供用户选择,默认等级为gnu。本例使需用foreign等级,它只检测必须的文件。
bin_PROGRAMS定义要产生的执行文件名。如果要产生多个执行文件,每个文件名用空格隔开。
add_SOURCES定义”add”这个执行程序所需要的原始文件。如果”add”这个程序是由多个原始文件所产生的,则必须把它所用到的所有原始文件都列出来,并用空格隔开。例如:若目标体”add”需要”add.c”、”add.h”两个依赖文件,则定义add_SOURCES=add.c add.h。
(2)工程中如果含有文件夹,程序用到了静态库,或者动态库 ,就有一些区别(每个目录下都必须有 Makefile.am 文件,Makefile.am内容不同 ,configure.in文件的内容也有所不同)
(1)为顶层目录创建Makefile.am文件
在Makefile.am文件中贴加内容:
AUTOMAKE_OPTIONS=foreign
#指示automake代码级别,默认级别为gnu,GNU规定自由软件发布必 NEWS/README/AUTHORS/ChangeLog说明文件,这里将级别降为foreign,从而 避免准备这些文件.
SUBDIRS=src inc
#指定需要处理的子目录,如果要处理多个子目录,以空格隔开.这里只 有src inc
ROOTDIR=$(shell /bin/pwd)
#利用pwd取得当前路径
export INCLUDES=-I$(ROOTDIR)/inc
#指定头文件所在路径,并导出供子目录Makefile.am使用
bin_PROGRAMS=target
#指定要产生的执行文件名
target_SOURCES=main.c xxx1.c xxx2.c
#指定产生执行文件需要的源文件,如果有多个,以空格隔开
target_LDADD=$(ROOTDIR)/src/libname.a
#(利用src创建静态库) 或者 LIBS+=... 增加链接库
######################################
Automake制作静态库makefile:
以为 src inc 目录文件为例:里面有源文件student.c class.c student.h class.h
1.在主文件夹下写Makefile.am
AUTOMAKE_OPTIONS=foreign
SUBDIRS= src inc #需要处理的子目录,多个以空格分开
ROOTDIR=$(shell /bin/pwd)
INCLUDES=-I$(ROOTDIR)/inc #指定头文件所在路径,并导出供子目录Makefile.am使用
export INCLUDES #使之变成全局变量
bin_PROGRAMS=my_test #生成的目标文件
my_test_SOURCES=main.c #指定产生执行文件需要的源文件,如果有多个,以空格隔开
my_test_LDADD=$(ROOTDIR)/src/libmy_test.a(自己定义的静态库名称) #把src中的文件变成静态库的方式
2.在src源文件下写Makefile.am
noinst_LIBRARIES=libmy_test.a(自己定义的静态库名称) #这里的libmy_test.a与主目录下的Makefile.am 一致
libmy_test_a_SOURCES= class.c student.c #说明libmy_test.a由哪几个源文件产生的
3.在inc头文件下写Makefile.am
EXTRA_DIST=class.h student.h #EXTRA_DIST表示用来定义要额外打包的文件名称
4.准备autoconf必需的配置文件configure.in 将configure.scan更名为configure.in,并对脚本进行如下修改
(1)修改AC_INIT宏,指定软件包名称/版本/bug报告地址
(2)加入automake必需的宏AM_INIT_AUTOMAKE()
(3)屏蔽AC_CONFIG_HEADER宏
(4)由于我们将要把src目录内的源文件编译成静态库,需要加入AC_PROG_RANLIB宏
如果程序用到了其他的系统静态库
#########################################
(2)、在src子目录创建Makefile.am文件
noinst_LIBRARIES=libname.a (自己定义的静态库名)
#在src子目录生成静态库libname.a,以便顶层目录主文件链接使用
libname_a_SOURCES(与库名对应)=src1.c src2.c(对应.c文件名)
#产生静态库libname.a需要的源文件,以空格隔开
(3)、在inc目录增Makefile.am
EXTRA_DIST=inc1.h inc2.h (对应.h文件名)
#EXTRA_DIST表示用来定义要额外打包的文件名称
(4)configure.in 文件也需要做相应的修改
——————————————————————————————————————————————————————————————
5.运行:automake --add-missing #-add-missing 自动贴加缺少的选项
运行完成后会显示如下文件:
guigu@guigu:~/work/automake_test$ ls
aclocal.m4 autoscan.log configure.in Makefile.am
add.c compile depcomp Makefile.in
autom4te.cache configure install-sh missing
6.执行configure生成makefile
configure 作为编译配置脚本,有大量选项可供不同编译需求,这些选项直
接作用到最终生成的Makefile文件
1、help 查看所有选项
2、--prefix = PEWFIX 输入安装目录前缀.如: ./configure --prefix=/usr/local/bin
3、编译器选项,如:
CFLAGS=“-Wall -g” ./configure
LDFLAGS=“-L libpath–l libname -static” ./configure
CC=“arm-linux-gcc” ./configure
4、--host 指定软件运行的系统平台
如:嵌入式arm-linux通常用 --host=arm-linux
./configure --host=arm-linux
生成完成makefile后可以对make命令执行下列操作
make
make clean
make dist
make install
make distclean 把makefile都会删掉 需要再次执行./congigure命令生成makefile命令
make uninstall
.深入浅出
针对上面提到的 各个命令,我们再做些详细的 介绍.
1. autoscan
autoscan是 用来扫描源代码目录生成configure.scan文件的 .autoscan
可以用目录名做为参数,但如果你不使用参数的 话,那么autoscan将认为使用的是当前目录.
autoscan将扫描你所指定目录中的 源文件,并创建configure.scan文件.
2. configure.scan
configure.scan包含了系统配置的 基本选项,里面都是 一些宏定义.我们需要将它改名为
configure.in
3. aclocal
aclocal是 一个perl 脚本程序.aclocal根据configure.in文件的 内容
,自动生成aclocal.m4文件.aclocal的 定义是 :"aclocal - create
aclocal.m4 by scanning configure.ac".
4. autoconf
autoconf是 用来产生configure文件的 .configure是 一个脚本,它能设置
源程序来适应各种不同的操作系统平台,并且根据不同的 系统来产生合适的 Makefile,从而可以使
你的源代码能在不同的操作系统平台上被编译出来.
configure.in文件的 内容是 一些宏,这些宏经过autoconf 处理后会变成检查系统
特性.环境变量.软件必须的 参数的 shell脚本.configure.in文件中的 宏的 顺序并没
有规定,但是 你必须在 所有宏的 最前面和最后面分别加上AC_INIT宏和AC_OUTPUT宏.
在 configure.ini中:
#号表示注释,这个宏后面的 内容将被忽略.
AC_INIT(FILE)
这个宏用来检查源代码所在 的 路径.
AM_INIT_AUTOMAKE(PACKAGE, VERSION)
这个宏是 必须的 ,它描述了我们将要生成的 软件包的 名字及其版本号:PACKAGE是软件包
的名字,VERSION是 版本号.当你使用make dist命令时,它会给你生成一个类似
helloworld-1.0.tar.gz的 软件发行包,其中就有对应的 软件包的 名字和版本号.
AC_PROG_CC
这个宏将检查系统所用的 C编译器.
AC_OUTPUT(FILE)
这个宏是 我们要输出的 Makefile的 名字.
我们在 使用automake时,实际上还需要用到其他的 一些宏,但我们可以用aclocal 来帮
我们自动产生.执行aclocal后我们会得到aclocal.m4文件.
产生了configure.in和aclocal.m4 两个宏文件后,我们就可以使用autocon
f来产生configure文件了.
5. Makefile.am
Makefile.am是 用来生成Makefile.in的 ,需要你手工书写.Makefile.
am中定义了一些内容:
AUTOMAKE_OPTIONS
这个是 automake的 选项.在 执行automake时,它会检查目录下是 否存在 标准
GNU软件包中应具备的各种文件,例如AUTHORS.ChangeLog.NEWS等文件.
我们将其设置成foreign时,automake会改用一般软件包的 标准来检查.
bin_PROGRAMS
这个是 指定我们所要产生的 可执行文件的 文件名.如果你要产生多个可执行文件,
那么在各个名字间用空格隔开.
helloworld_SOURCES
这个是 指定产生"helloworld"时所需要的 源代码.如果它用到了多个源文件,
那么请使用空格符号将它们隔开.比如需要helloworld.h,helloworld.c那么请写成:
helloworld_SOURCES= helloworld.h helloworld.c.
如果你在 bin_PROGRAMS定义了多个可执行文件,则对应每个可执行文件都要定义相对的
filename_SOURCES.
6. automake
我们使用automake --add-missing来产生Makefile.in.
选项--add-missing的 定义是 "add missing standard files
to package",它会让automake加入一个标准的 软件包所必须的 一些文件.
我们用automake产生出来的 Makefile.in文件是 符合GNU Makefile惯例
的 ,接下来我们只要执行configure这个shell 脚本就可以产生合适的 Makefile 文
件了.
7. Makefile
在 符合GNU Makefiel惯例的 Makefile中,包含了一些基本的 预先定义的 操作:
make
根据Makefile编译源代码,连接,生成目标文件,可执行文件.
make clean
清除上次的 make命令所产生的 object文件(后缀为".o"的 文件)及可执行文件.
make install
将编译成功的 可执行文件安装到系统目录中,一般为/usr/local/bin目录.
make dist
产生发布软件包文件(即distribution package).这个命令将会将可执行文件及相关
文件打包成一个tar.gz压缩的 文件用来作为发布软件的 软件包.
它会在 当前目录下生成一个名字类似"PACKAGE-VERSION.tar.gz"的 文件.PA
CKAGE和VERSION,是 我们在 configure.in中定义的 AM_INIT_AUTOM
AKE(PACKAGE, VERSION).
make distcheck
生成发布软件包并对其进行测试检查,以确定发布包的正确性.