[笔记] GNU libtool 与 autotools 结合使用

一. 介绍以及文档:

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],[[email protected]])

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 
#include "math.h"

int main() {
    printf("3 & 1 = %d", and(3, 1));
    return 0;
}