使用automake主要会用到aclocal、autoscan、autoconf、autoheader和automake这几个命令。
首先简略的说一下用automake生成makefile的步骤:(1)创建源代码文件,使用”autoscan”生成configure.scan文件,将其重命名为configure.ac,并做适当修改,然后使用”aclocal”命令生成aclocal.m4文件,使用”autoconf”命令由configure.ac和aclocal.m4文件生成configure文件。
(2)手工编辑Makefile.am文件,使用”automake”命令生成configure.in文件。
(3)手工编辑或由系统给定acconfig.h文件,使用”autoheader”命令生成config.h.in文件。
(4)使用”configure”命令由configure、configure.in和config.h.in文件生成Makefile文件。从而完成Makefile文件的创建过程。
下面用一个经典的hello world的例子说明automake的用法
1.编辑源文件
root@ubuntu:~# mkdir hello
root@ubuntu:~# cd hello
root@ubuntu:~/hello# vim hello.c
root@ubuntu:~/hello# cat hello.c
#include "stdio.h"
int main()
{
printf("hello world\n");
return 0;
}
2.使用Autoscan工具生成configure.ac文件
Autoscan工具用来扫描源代码以搜寻一般的可移植性问题,比如检查编译器、库和头文件等,并创建configure.scan文件,它会在给定目录及其子目录树中检查源文件,若没有给出目录,就在当前目录及其子目录树中进行检查。
root@ubuntu:~/hello# autoscan //扫描源文件,生成configure.scan
root@ubuntu:~/hello# ls
autoscan.log configure.scan hello.c
root@ubuntu:~/hello# cat configure.scan
# -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.
AC_PREREQ([2.65])
AC_INIT([FULL-PACKAGE-NAME], [VERSION], [BUG-REPORT-ADDRESS])
AC_CONFIG_SRCDIR([hello.c])
AC_CONFIG_HEADERS([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_OUTPUT
下面给出本文件的简要说明(所有以”#”号开始的行为注释):
(1)AC_PREREQ宏声明本文件要求的autoconf版本,本例使用的版本为2.59。
(2)AC_INIT宏用来定义软件的名称和版本等信息,”FULL-PACKAGE-NAME”为软件包名称,”VERSION”为软件版本号,”BUG-REPORT-ADDRESS”为BUG报告地址(一般为软件作者邮件地址)。
(3)AC_CONFIG_SRCDIR宏用来侦测所指定的源码文件是否存在,来确定源码目录的有效性。此处为当前目录下的hello.c。
(4)AC_CONFIG_HEADER宏用于生成config.h文件,以便autoheader使用。
(5)AC_PROG_CC用来指定编译器,如果不指定,选用默认gcc。
(6)AC_OUTPUT用来设定 configure 所要产生的文件,如果是makefile,configure会把它检查出来的结果带入makefile.in文件产生合适的makefile。使用Automake时,还需要一些其他的参数,这些额外的宏用aclocal工具产生。
此文件只是下面要使用的configure.ac文件的原型,当然我们还要对其做一定的修改:
root@ubuntu:~/hello# mv configure.scan configure.ac #将名字改成configure.in也行
root@ubuntu:~/hello# vim configure.ac
root@ubuntu:~/hello# cat configure.ac
# -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.
AC_PREREQ([2.65]) //automake版本
AC_INIT(hello, 1.0, xx@163.com) //设置软件包信息
AM_INIT_AUTOMAKE(hello, 1.0) //这个需要手动添加,它是automake必备的宏
AC_CONFIG_SRCDIR([hello.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_OUTPUT([Makefile]) //要输出的文件名
3.使用aclocal工具生成aclocal.m4
aclocal根据configure.ac生成aclocal.m4
root@ubuntu:~/hello# aclocal
root@ubuntu:~/hello# ls
aclocal.m4 autom4te.cache autoscan.log configure.ac hello.c
4.使用autoconf工具生成configure文件
将configure.ac中的宏展开,生成configure脚本。这个过程可能要用到aclocal.m4中定义的宏。
root@ubuntu:~/hello# autoconf
root@ubuntu:~/hello# ls
aclocal.m4 autom4te.cache autoscan.log configure configure.ac hello.c
5.生成config.h.in文件
运行 autoheader,它负责生成config.h.in文件。该工具通常会从“acconfig.h”文件中复制用户附加的符号定义,因此此处没有附加符号定义,且我们在上面2中已经注释掉了AC_CONFIG_HEADERS([config.h]) ,所以不需要创建“config.h.in”文件。
假如我们没有注释掉,运行autoheader后的状态如下:
[root@localhost main]# autoheader
[root@localhost main]# ls
aclocal.m4 autoscan.log configure configure.in~
autom4te.cache config.h.in configure.in hello.c
6.创建Makefile.am文件
Automake工具会根据configure.in中的参量把Makefile.am转换成Makefile.in文件。所以在使用automake之前我们需要自己创建Makefile.am文件
root@ubuntu:~/hello# vim Makefile.am
root@ubuntu:~/hello# cat Makefile.am
AUTOMAKE_OPTIONS=foreign //软件等级
bin_PROGRAMS=hello //可执行文件名
hello_SOURCES=hello.c //源文件名
其中:
(1)AUTOMAKE_OPTIONS为设置Automake的选项。由于GNU对自己发布的软件有严格的规范,比如必须附带许可证声明文件COPYING等,否则Automake执行时会报错。Automake提供了3种软件等级:foreign、gnu和gnits,供用户选择,默认等级为gnu。本例使需用foreign等级,它只检测必须的文件。
(2)bin_PROGRAMS定义要产生的执行文件名。如果要产生多个执行文件,每个文件名用空格隔开。
(3)hello_SOURCES定义”hello”这个执行程序所需要的原始文件。如果”hello”这个程序是由多个原始文件所产生的,则必须把它所用到的所有原始文件都列出来,并用空格隔开。例如:若目标体”hello”需要”hello.c”、”hello.h”两个依赖文件,则定义hello_SOURCES=hello.c hello.h。
7.使用Automake生成Makefile.in文件
下面使用Automake生成”Makefile.in”文件,使用选项”–add-missing”可以让Automake自动添加一些必需的脚本文件。如下所示:
root@ubuntu:~/hello# automake --add-missing
configure.ac:6: installing `./install-sh'
configure.ac:6: installing `./missing'
Makefile.am: installing `./depcomp'
root@ubuntu:~/hello# ls
aclocal.m4 autoscan.log configure.ac hello.c Makefile.am missing
autom4te.cache configure depcomp install-sh Makefile.in
8.执行./configure 生成Makefile
9.测试
root@ubuntu:~/hello# ls
aclocal.m4 config.log configure.ac hello.c Makefile missing
autom4te.cache config.status depcomp hello.o Makefile.am
autoscan.log configure hello install-sh Makefile.in
root@ubuntu:~/hello# ./hello
hello world
使用”make dist”命令将程序和相关的文档打包为一个压缩文档以供发布。
root@ubuntu:~/hello# make dist
root@ubuntu:~/hello# ls
aclocal.m4 config.status hello install-sh missing
autom4te.cache configure hello-1.0.tar.gz Makefile
autoscan.log configure.ac hello.c Makefile.am
config.log depcomp hello.o Makefile.in
hello-1.0.tar.gz为打包过后的文件
下面是另一种文档结构
|-- conf
| `-- test.conf
`-- src
|-- test1.c
|-- test2.c
`-- test2.h
src为源文件目录,conf为配置文件的目录。创建Makefile的方式和上面有一点点不同
1.执行autoscan命令
root@ubuntu:~/test# autoscan
root@ubuntu:~/test# ls
autoscan.log conf configure.scan src
root@ubuntu:~/test# cat configure.scan
# -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.
AC_PREREQ([2.65])
AC_INIT([FULL-PACKAGE-NAME], [VERSION], [BUG-REPORT-ADDRESS])
AC_CONFIG_SRCDIR([src/test2.h])
AC_CONFIG_HEADERS([config.h])
# Checks for programs.
AC_PROG_CC
# Checks for libraries.
# Checks for header files.
AC_CHECK_HEADERS([stdlib.h string.h])
# Checks for typedefs, structures, and compiler characteristics.
# Checks for library functions.
AC_OUTPUT
修改configure.scan为configure.ac
root@ubuntu:~/test# mv configure.scan configure.ac
root@ubuntu:~/test# vim configure.ac
root@ubuntu:~/test# cat configure.ac
# -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.
AC_PREREQ([2.65])
AC_INIT(test, 1.0)
AM_INIT_AUTOMAKE(test, 1.0)
AC_CONFIG_SRCDIR([src/test2.h])
# Checks for programs.
AC_PROG_CC
# Checks for libraries.
AC_CHECK_LIB(pthread, pthread_create) //pthread为链接库名字, pthread_create为库中的一个函数
# Checks for header files.
AC_CHECK_HEADERS(stdlib.h string.h pthread.h)
# Checks for typedefs, structures, and compiler characteristics.
# Checks for library functions.
AC_OUTPUT([Makefile
src/Makefile
conf/Makefile]) //每一个目录需要输出一个Makefile文件
2.使用aclocal工具生成aclocal.m4
3.使用autoconf工具生成configure文件
4. 创建Makefile.am
在顶层目录创建的Makefile.am的内容如下
root@ubuntu:~/test# vim Makefile.am
root@ubuntu:~/test# cat Makefile.am
SUBDIRS= src conf
在src目录下创建的Makefile.am内容如下
root@ubuntu:~/test# cd src/
root@ubuntu:~/test/src# vim Makefile.am
root@ubuntu:~/test/src# cat Makefile.am
bin_PROGRAMS= test
test_SOURCES= test1.c test2.c
在conf目录下创建的Makefile.am内容如下
root@ubuntu:~/test/conf# vim Makefile.am
root@ubuntu:~/test/conf# cat Makefile.am
configdir = /etc //这个数据文件将要移动到的目录
config_DATA = test.conf //数据文件名,如果有多个文件则这样写config_DATA = test1.dat test2.dat
5.使用Automake生成Makefile.in文件
root@ubuntu:~/test# automake --add-missing
Makefile.am: required file `./NEWS' not found
Makefile.am: required file `./README' not found
Makefile.am: required file `./AUTHORS' not found
Makefile.am: required file `./ChangeLog' not found
这里出现了一个问题,NEWS, README这几个文件不存在, 那么我们就手工创建他们
root@ubuntu:~/test# touch NEWS README AUTHORS ChangeLog
再次执行automake
root@ubuntu:~/test# automake
6.后面的步骤就和上面的例子一样了
相关推荐
### 使用AutoMake轻松生成Makefile #### 知识点概览 1. **Makefile的基础概念** 2. **AutoMake的简介与优势** 3. **系统环境准备** 4. **AutoMake工作流程详解** - **步骤1:使用autoscan生成configure.scan文件*...
大型项目使用Automake/Autoconf完成编译配置使用过开源C/C++项目的同学们都知道,标准的编译过程已经变成了简单的三部曲:configure/make/make install,使用起来很方便,不像平时自己写代码,要手写一堆复杂的...
在开始使用 AutoMake 之前,确保你的系统安装了以下工具: 1. GNU Automake 2. GNU Autoconf 3. GNU m4 4. Perl 5. GNU Libtool(如果需要创建共享库) 建议使用 GNU 工具链,包括 GNU C/C++ 编译器和 GNU Make,...
使用Automake,Autoconf生成Makefile,介绍软件打包发布
如何使用 automake
通过下载并解压 `automake-1.16.1.tar.xz` 文件,你可以获取到源代码,然后按照上述步骤进行编译和安装,从而在你的项目中使用这个版本的automake。在开发和维护开源软件时,automake是一个非常有用的工具,它可以极...
automake便是这样一款工具,它与autoconf配合使用,为开发者提供了跨平台的构建系统。本文将深入探讨automake-1.15.1版本在hi3861开发环境中的应用和相关知识点。 automake是一款开源的自动化构建系统,它遵循GNU...
### automake的使用 在软件开发领域,特别是针对C/C++项目,自动化构建工具能够显著提升开发效率。本文将详细介绍如何使用automake结合其他工具(如autoconf、m4、libtool)来自动生成makefile,并实现项目的自动化...
通常,automake会配合autoconf使用,autoconf生成configure脚本,用于检测系统的特性并创建配置文件,而automake则负责创建Makefile规则,使得编译和安装过程标准化。 **automake的工作原理** 当开发一个新的软件...
### automake工具链使用详解 #### 一、Makefile与automake的重要性 Makefile是一种用于自动化构建过程的脚本文件,它可以智能地管理项目中的多个文件,并根据文件间的依赖关系来决定哪些文件需要重新编译。这对于...
### AutoMake使用概览 AutoMake简化了Makefile的编写过程,它通过分析`Makefile.am`文件(AutoMake的输入文件),自动生成Makefile。这种方式避免了手动编写复杂的Makefile规则,提高了开发效率和代码的可维护性。 ...
此外,Automake还假设项目使用Autoconf(一个配置脚本生成器)来生成`configure`脚本,这确保了软件能够适应各种系统环境。 在运行Automake时,它会解析`Makefile.am`文件,应用预定义的规则和宏,然后生成`...
1. `INSTALL`:一份指南,解释如何在目标系统上安装和使用Automake。 2. `NEWS`:列出自上一版本以来的更改和改进。 3. `README`:提供项目的一般信息,包括使用提示和贡献指南。 4. `configure.ac`:这是配置脚本的...
这部分内容涉及了 Automake 作为 Autotools 组件的基本概念以及如何开始使用 Automake。 #### 九、总结 **Automake** 是一个强大的工具,可以极大地简化 Makefile 的管理和维护过程,尤其适用于遵循 GNU 构建标准...
《automake-1.8在Ubuntu中的应用与详解》 automake是一款自动化工具...通过了解和熟练掌握automake的使用,开发者可以更高效地开发和维护软件,尤其对于那些遵循GNU编程规范的项目来说,automake更是不可或缺的伙伴。
`automake` 是一个广泛使用的开源工具,主要用于创建遵循 GNU 编译标准的 Makefile 文件。这个模板提供了使用 `automake` 创建自定义 Makefile 的基础结构,使开发者能够快速适应并应用于自己的项目。 `automake` ...
通过使用`Makefile.am`模板文件,Automake极大地简化了构建过程,并确保项目遵循一致且标准化的构建流程。此文档为Automake版本1.11.1(2009年12月8日发布),由David MacKenzie、Tom Tromey和Alexandre Duret-Lutz...