automake使用

Posted 2020-06-10

 

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 ,[email protected]) //设置软件包信息
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 自动贴加缺少的选项

运行完成后会显示如下文件：
[email protected]:~/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
　　生成发布软件包并对其进行测试检查,以确定发布包的正确性.