Makefile 管理工具 — Automake and Autoconf
该project下载路径:https://files.cnblogs.com/iTsihang/hello-2.0.zip
automake 參考资料:http://www.linuxforum.net/books/automake.html
autoconf 參考资料:http://www.linuxforum.net/books/autoconf.html
automake源代码下载:ftp://ftp.gnu.org/gnu/automake/
autoconf源代码下载:ftp://ftp.gnu.org/gnu/autoconf/
Automake支持的文件夹结构
眼下automake支持三种文件夹层次:flat、shallow和deep。
- flat(平),指的是全部文件都位于同一个文件夹中
就是全部源文件、头文件以及其它库文件都位于当前文件夹中,且没有子文件夹。Termutils就是这一类。
- shallow(浅),指的是基本的源码都储存在顶层文件夹,其它各个部分则储存在子文件夹中
就是主要源文件在当前文件夹中,而其他一些实现各部分功能的源文件位于各自不同的文件夹。automake本身就是这一类。
- deep(深),指的是全部源码都被储存在子文件夹中;顶层文件夹主要包括配置信息
本样例文件夹结构如图所看到的,属于deep类:
1 hello-2.0
2 ├── aclocal.m4
3 ├── AUTHORS
4 ├── autom4te.cache
5 │ ├── output.0
6 │ ├── output.1
7 │ ├── requests
8 │ ├── traces.0
9 │ └── traces.1
10 ├── autoscan.log
11 ├── ChangeLog
12 ├── configure
13 ├── configure.in
14 ├── COPYING -> /usr/share/automake-1.11/COPYING
15 ├── depcomp -> /usr/share/automake-1.11/depcomp
16 ├── home
17 │ ├── li
18 │ │ ├── inc
19 │ │ │ └── li.h
20 │ │ └── src
21 │ │ ├── li.c
22 │ │ ├── Makefile.am
23 │ │ └── Makefile.in
24 │ ├── wang
25 │ │ ├── inc
26 │ │ │ └── wang.h
27 │ │ └── src
28 │ │ ├── Makefile.am
29 │ │ ├── Makefile.in
30 │ │ └── wang.c
31 │ └── zhang
32 │ ├── inc
33 │ │ └── zhang.h
34 │ └── src
35 │ ├── Makefile.am
36 │ ├── Makefile.in
37 │ └── zhang.c
38 ├── INSTALL -> /usr/share/automake-1.11/INSTALL
39 ├── install-sh -> /usr/share/automake-1.11/install-sh
40 ├── main
41 │ ├── main.c
42 │ ├── Makefile.am
43 │ └── Makefile.in
44 ├── Makefile.am
45 ├── Makefile.in
46 ├── missing -> /usr/share/automake-1.11/missing
47 ├── NEWS
48 ├── park
49 │ ├── Makefile.am
50 │ ├── Makefile.in
51 │ ├── public.c
52 │ └── public.h
53 └── README
54
55 13 directories, 39 files
这是一个主要的架构结构,能够形成一个比較成熟的软件框架。
样例介绍
如上图所看到的为该样例的结构层次,有主文件夹main,家文件夹home和公园文件夹part。home下依据姓氏分了三家:li家,wang家和zhang家,每家都有同样的结构:src和inc;part是三家共有的公共文件夹,里面包括了三家共用的接口;main文件夹是我们的主文件夹,存放运行入口。每家的人(程序)做一件事情,那就是依次在入口(main)中说一句:hello。
1 int main(void)
2 {
3
4 /* access home li */
5 lisayhello();
6
7 /* access home wang */
8 wangsayhello();
9
10 /* access home zhang */
11 zhangsayhello();
12
13 return 0;
14 }
步骤
分别在每一个文件夹下创建Makefile.am文件,并编辑
在使用autoconf和automake自己主动工具生成Makefile的时候,该工具会在project文件夹下查找Makefile.am文件,有该文件的文件夹下会自己主动生成对应的Makefile文件。当然也能够后期手动加入。一般的生成顺序是:
1> 依据project结构,在须要生成Makefile的文件夹下创建Makefile.am文件。
我们须要生成Makefile的文件夹有home/li/src/,home/wang/src/,home/zhang/src/和main/,所以我们共需创建4个Makefile.am文件。
2> 编辑Makefile.am文件,指出须要在该文件夹下完毕的工作,如编译一些源文件,链接某些库文件等等;
这里有三类Makefile.am,如今分类介绍其在整个project文件夹中实现的功能。
家文件夹下的Makefile.am主要用来编译同文件夹下的源文件。比如,编辑home/li/src/Makefile.am例如以下:
1 noinst_PROGRAMS= li #生成的目标
2 li_SOURCES= li.c #生成目标依赖的源
3
4 li_LDADD= #可能须要载入的其它的目标
5 li_LDFLAGS= #载入目标须要的配置參数
6 li_a_LIBADD= #可能须要载入的其它的库
7
8 DEFS += -D_GNU_SOURCE
同理编辑其它两个姓氏文件夹以及公园文件夹下的Makefile.am文件,替换对应字段就可以。
主文件夹下的Makefile.am主要用来生成终于的可运行目标程序,它须要家文件夹下的姓氏提供方法。编辑例如以下:
1 # executable file last created
2
3 noinst_PROGRAMS= hello
4
5 # main entry file
6
7 hello_SOURCES= main.c
8
9 # object file that needed
10
11 OBJECTS= $(top_srcdir)/home/li/src/li.o\
12
13 $(top_srcdir)/home/zhang/src/zhang.o\
14
15 $(top_srcdir)/home/wang/src/wang.o
16
17 # load object file when linking
18
19 hello_LDADD= $(OBJECTS)
20
21 # flags of libs
22
23 hello_LDFLAGS= -D_GNU_SOURCE
24
25 DEFS += -D_GNU_SOURCE
26
27 #LIBS= -lpthread
篇幅有限,每行的详细含义,请自行查看相关文档,或者我提供的链接可能对你有帮助。
顶层文件夹Makefile.am给automake工具提供project下各个子文件夹的路径。在make的时候,告诉automake应该进哪些文件夹运行makefile,运行过程依照SUBDIRS 定义顺序来。编辑例如以下:
1 SUBDIRS= home/li/src\
2
3 home/zhang/src\
4
5 home/wang/src\
6
7 park\
8
9 main
10
11 # automake need known where it is
12
13 CURRENTPATH= $(shell pwd)
14
15 # head files while linking
16
17 INCLUDES= -I$(CURRENTPATH)/park/include -I$(CURRENTPATH)/home/li/inc -I$(CURRENTPATH)/home/wang/inc -I$(CURRENTPATH)/home/zhang/inc
18
19 export INCLUDES
执行autoscan命令,生成configure.scan文件
1 # -*- Autoconf -*-
2
3 # Process this file with autoconf to produce a configure script.
4
5 AC_PREREQ([2.68])
6
7 AC_INIT([FULL-PACKAGE-NAME], [VERSION], [BUG-REPORT-ADDRESS])
8
9 AC_CONFIG_SRCDIR([home/zhang/src/zhang.c])
10
11 AC_CONFIG_HEADERS([config.h])
12
13 # Checks for programs.
14
15 AC_PROG_CC
16
17 # Checks for libraries.
18
19 # Checks for header files.
20
21 # Checks for typedefs, structures, and compiler characteristics.
22
23 # Checks for library functions.
24
25 AC_CONFIG_FILES([Makefile
26
27 home/li/src/Makefile
28
29 home/wang/src/Makefile
30
31 home/zhang/src/Makefile
32
33 park/Makefile
34
35 main/Makefile])
36
37 AC_OUTPUT
通过上面的步骤,能够发现,autoscan工具会自己主动查找project文件夹,包含子文件夹,在发现有Makefile.am存在的文件夹下为即将创建的Makefile指明project路径。当然,能够依据自己的须要,指定该文件,例如以下。
改动configure.scan文件
$ mv configure.scan configure.in(老版本号支持configure.ac,我没用过)
改动例如以下部分:
1 AC_CONFIG_SRCDIR([main/main.c]) #指明文件夹源文件,特指主方法所在源文件
2
3 #AC_CONFIG_HEADERS([config.h])
4
5 AM_INIT_AUTOMAKE("hello", "2.0.0") #终于生成的目标文件和版本号,版本号一般在打包的时候用
6
7 # Checks for programs.
8
9 AC_PROG_CC
10
11 # Checks for libraries.
12
13 # Checks for header files.
14
15 # Checks for typedefs, structures, and compiler characteristics.
16
17 # Checks for library functions.
18
19 AC_OUTPUT([Makefile
20
21 home/li/src/Makefile
22
23 home/wang/src/Makefile
24
25 home/zhang/src/Makefile
26
27 park/Makefile
28
29 main/Makefile])
在project文件夹下创建:NEWS、 README、 ChangeLog 、AUTHORS
touch NEWS README ChangeLog AUTHORS
将/usr/share/automake-1.X/文件夹下的 depcomp 和 complie 文件复制到本文件夹下
1 cp /usr/share/automake-1.x/depcomp .
2 cp /usr/share/automake-1.x/compile .
执行aclocal命令
依据 configure.in 的配置,生成 aclocal.m4 文件和 autom4te.cache 文件夹
执行autoconf
依据configure.in的配置生成配置脚本 — configure。
执行automake --add-missing
执行automake后,就从各个文件夹下的Makefile.am中读取make的宏定义和目标或者很多其它參数,依据这些配置自己主动生成新的文件 — Makefile.in。比如,在Makefile.am中定义了要生成的目标文件,同一时候可能会定义生成目标所需的源文件,依赖文件—包含依赖的头文件,目标文件,目标库等,同一时候也指定软件的载入标志。
当然,为了符合GNU 公布软件的标准,首次执行该命令后会提示缺少:AUTHORS,ChangeLog,NEWS,README。这些文件,你能够手动创建,假设不公布无需编辑。同一时候,也会生成install-sh,missing,INSTALL,COPYING 链接文件,这些链接文件分别指向auto工具默认安装路径:/usr/share/automake-1.XX/文件夹下的对应文件。
此外,最关键的文件就是生成了除过上面的Makefile.in文件外,还生成了我们须要的configure文件。
配置
配置project安装和执行环境,通过该步骤能够向project传递配置和安装信息等,最后生成Makefile。
编译
运行Makefile ,编译project,链接文件,生成目标运行程序。
问题探讨
指定的install-sh,missing,INSTALL,COPYING文件的链接错误
这依据自己系统当前安装的工具而定,你能够将这些链接又一次指向automake安装文件夹下的对应文件,也能够将automake安装文件夹下的文件复制到project文件夹。可是考虑GNU 风格的完整性,建议大家运行拷贝步骤,这样也省去又一次链接的麻烦,更基本的是不会像链接那样对安装路径和版本号的依赖那么高,拷贝会一劳永逸。
假设由于不论什么原因改动了configure.in,改动后假设不运行autoconf命令,那么是不会生成新的configure
在编译的时候,出现类似 “In function `_start'”的错误
我们知道,automake要求在每一个具有源程序的文件夹下都要创建Makefile.am。但是automake编译完毕后,该工具会自己主动运行链接过程,即将编译的目标文件自己主动链接成同名的可运行程序,但是源程序中没有指定的入口(在Linux中为”main”方法),所以在链接的时候无法找到入口而产生 “链接错误”。
改动方法:此时该文件夹下已经生成Makefile.in,编辑找到链接运行出,屏蔽掉。比如本例中屏蔽掉home/li/src/Makefile.in的189行:
# $(li_LINK) $(li_OBJECTS) $(li_LDADD) $(LIBS)
其它类似问题都做同样处理。
各个目标之间的依赖处理
编译的时候,可能会遇到依赖问题。所谓依赖问题,例如以下:
A → B
B → C
…...
A依赖B, B依赖C,那么在生成目标A的时候,就须要将B和C同一时候告知A。在本样例中,生成目标hello的时候须要li.o,wang.o,zhang.o目标,所以在终于链接的时候须要将这些目标链接进去。
如今有个问题我没解决,假设编译目标文件(而非终于的可运行文件)的时候,假设存在上面的依赖关系,怎么处理?在这个样例project的park/public.c文件,假设里面的广播方法被某一家调用,那么这块的Makefile.am怎么写(我没搞定)?
最后,假设因须要,或者不论什么原因改动了Makefile.am,那么须要执行automake更新makefile.in
转载自:http://www.cnblogs.com/iTsihang