Autoconf：Linux自动生成Makefile的详解

源代码目录结构：
├── configure.ac    ← Autoconf的输入文件
├── Makefile.am     ← Automake的输入文件
├── 各种源文件
└── 生成：
    ├── configure   ← 由autoconf生成的配置脚本
    └── Makefile.in ← 由automake生成的模板

开发者侧：
1. 编写 configure.ac（配置需求）
2. 编写 Makefile.am（编译规则）
3. 运行 autoconf 生成 configure
4. 运行 automake 生成 Makefile.in

用户侧：
1. 运行 ./configure（检测系统环境）
2. 生成 config.h 和 Makefile
3. 运行 make（编译程序）
4. 运行 make install（安装程序）

mathlib/
├── src/
│   ├── add.c
│   ├── subtract.c
│   └── math.h
├── tests/
│   └── test_math.c
└── examples/
    └── demo.c

# -*- Autoconf -*-
# 初始化项目信息
AC_INIT([MathLib], [1.0], [bug@example.com])
AC_CONFIG_SRCDIR([src/add.c])

# 检查C编译器
AC_PROG_CC

# 检查标准头文件
AC_CHECK_HEADERS([stdio.h stdlib.h math.h])

# 检查数学库（链接时需要-lm）
AC_CHECK_LIB([m], [sqrt], [HAVE_LIBM=yes], [HAVE_LIBM=no])

# 启用调试模式选项
AC_ARG_ENABLE([debug],
    [AS_HELP_STRING([--enable-debug],
        [启用调试模式])],
    [enable_debug=$enableval],
    [enable_debug=no])

if test "x$enable_debug" = "xyes"; then
    CFLAGS="$CFLAGS -g -O0"
    AC_DEFINE([DEBUG], [1], [启用调试])
fi

# 指定生成的配置文件
AC_CONFIG_FILES([Makefile src/Makefile tests/Makefile])
AC_OUTPUT

# 顶级目录的Makefile.am
SUBDIRS = src tests examples
dist_doc_DATA = README.md LICENSE

# 源代码目录的Makefile.am
lib_LTLIBRARIES = libmath.la
libmath_la_SOURCES = add.c subtract.c math.h
include_HEADERS = math.h

# 如果检测到数学库，添加链接选项
if HAVE_LIBM
libmath_la_LIBADD = -lm
endif

# 1. 生成configure脚本
autoconf

# 2. 生成Makefile.in模板
automake --add-missing

# 3. 打包发布
make dist
# 生成：mathlib-1.0.tar.gz

# 1. 解压
tar -xzf mathlib-1.0.tar.gz
cd mathlib-1.0

# 2. 配置（检测系统环境）
./configure --prefix=/usr/local --enable-debug
# configure输出示例：
# checking for gcc... gcc
# checking whether the C compiler works... yes
# checking for math.h... yes
# checking for library containing sqrt... -lm
# configure: creating ./config.status

# 3. 编译
make
# 输出：libmath.so, 测试程序等

# 4. 安装
sudo make install
# 安装到：/usr/local/lib/libmath.so
#         /usr/local/include/math.h

# 5. 清理（可选）
make clean          # 清理编译文件
make distclean      # 恢复到解压状态
make uninstall      # 卸载（需要Makefile支持）

# 检查pthread库
AC_CHECK_LIB([pthread], [pthread_create], 
    [HAVE_PTHREAD=yes], [HAVE_PTHREAD=no])

# 根据结果设置条件
if test "x$HAVE_PTHREAD" = "xyes"; then
    LIBS="$LIBS -lpthread"
    AC_DEFINE([HAVE_PTHREAD], [1], [支持多线程])
fi

# 在Makefile.am中使用
# if HAVE_PTHREAD
# bin_PROGRAMS = threaded_app
# else
# bin_PROGRAMS = single_app
# endif

推荐：直接手写Makefile
原因：
- 系统环境确定
- 依赖简单
- 快速开发，无需学习Autoconf

CC = gcc
CFLAGS = -Wall -O2
TARGET = mytool
SRCS = main.c utils.c

$(TARGET): $(SRCS)
	$(CC) $(CFLAGS) -o $@ $^

推荐：Autoconf + Automake
原因：
- 支持多种Unix-like系统
- 用户自定义安装路径
- 自动检测系统特性
- 标准化的安装流程

推荐：Autoconf完整套件
包含：
- Autoconf：配置检测
- Automake：生成标准Makefile
- Libtool：管理共享库
- gettext：国际化支持
- pkg-config：依赖管理