一. 介绍以及文档:
libtool是GNU的一个构建工具
libtool:
https://www.gnu.org/software/libtool/manual/libtool.html
automake:
https://www.gnu.org/software/automake/manual/automake.html
autoconf:
https://www.gnu.org/savannah-checkouts/gnu/autoconf/manual/autoconf-2.71/autoconf.html
二. 测试工程, 目录结构
# 测试工程, 目录结构:
$ tree -L 2
.
├── Makefile.am
├── configure.ac
├── include
│ └── math.h
├── lib1
│ ├── Makefile
│ ├── Makefile.am
│ └── math.c
└── main.c
# 构建步骤:
autoscan => (生成configure.scan模板文件)
=> 编辑configure.ac
=> aclocal
=> autoheader
=> autoconf (有时候configure.ac编写错误, 或使用过时的宏, 可以用autoupdate修复, 修复后继续执行autoconf)
=> glibtoolize --automake --copy --debug --force
=> automake -a (可能缺少文件, 用touch 命令创建缺失的文件, 然后在执行automake -a)
=> ./configure
=> make
=> make install
三. 配置文件: configure.ac, Makefile.am
# ./configure.ac 文件:
AC_PREREQ([2.71])
AC_INIT([main],[1.1],[xxx@gmail.com])
AC_CONFIG_AUX_DIR([build-aux]) # 添加辅助文件目录 (这个必须在下面这行之前)
AM_INIT_AUTOMAKE # 初始化automake
AC_CONFIG_SRCDIR([main.c]) # main()函数入口源文件
AC_CONFIG_HEADERS([config.h])
# Checks for programs.
AC_PROG_CC
# AC_PROG_LIBTOOL 这个宏废弃了, 使用下面这个:
LT_INIT # 初始化 libtool
# 下面这个CHECK宏, 是自动生成的 (检测依赖关系):
# Checks for libraries.
# FIXME: Replace 'main' with a function in '-lmath':
AC_CHECK_LIB([math], [main])
# Checks for header files.
# Checks for typedefs, structures, and compiler characteristics.
# Checks for library functions.
# 不要添加不存在的模块的Makefile!!
AC_CONFIG_FILES([Makefile
lib1/Makefile])
AC_OUTPUT
################################################################################
# ./Makefile.am 文件
# 如果main()函数的源文件在Makefile同级目录的子目录下,
# 则AUTOMAKE_OPTONS应设为 subdir-objects
AUTOMAKE_OPTONS=foreign
# 下面这句一定不能少, 否则就找不到lib库;
# 且不能添加多余的目录, 这里添加的每个目录都表示一个库, 目录下必须有Makefile.am
SUBDIRS = lib1
# SUBDIRS=aa bb ccc , 这里不能乱加目录, 这里添加的目录相当于一个模块, 这个目录下必须有Makefile.am
# 这个目录中的文件会构建出一个库 !
# 如果加入一些空目录, 编译时会找不到Makefile.am而报错, 如下:
# make[1]: *** No rule to make target `Makefile.am', needed by `Makefile.in'. Stop.
bin_PROGRAMS=main
main_SOURCES=main.c
# main_LDADD=lib1/libmath.a 不要用 libxxx.a , 要用 libxxx.la (libtool不会生成libxxx.a的)
main_LDADD=lib1/libmath.la
main_CFLAGS=-Iinclude # 指定头文件目录: include (因为include就在源文件同级目录下)
main_LDFLAGS=-Llib1
LIBS=-lmath
################################################################################
# ./lib1/Makefile.am 文件:
AUTOMAKE_OPTIONS=foreign
# LTLIBRARIES 生成libtool的库描述文件 *.la (入口函数源文件中依赖的就是这个库描述文件*.la, 构建工具会根据这个描述文件生成库文件, 从而屏蔽具体构建工具的细节)
lib_LTLIBRARIES=libmath.la
libmath_la_SOURCES=math.c
libmath_la_LDFLAGS=-shared -fPIC
# 这里指定*.c文件的头文件目录 (*.c文件中导入时不要写前缀: #include "include/xxx.h",
# 正确的写法是: #include "xxx.h" )
libmath_la_CFLAGS=-I../include
四. C 头文件 和 源文件
// include/math.h 文件:
#ifndef __MATH_H__
#define __MATH_H__
int and(int, int);
#endif
// lib1/math.c 文件:
#include "math.h"
int and(int a, int b) {
return a & b;
}
// main.c 文件:
#include <stdio.h>
#include "math.h"
int main() {
printf("3 & 1 = %d", and(3, 1));
return 0;
}