Linux autoconf 配置过程详解

autoconf 是 GNU 构建系统中的一个重要工具，用于生成可移植的 shell 脚本（configure 脚本），这些脚本可以自动配置软件源代码以适应各种类 UNIX 系统。以下是 autoconf 的完整配置过程：

基本配置流程

1. 准备 configure.ac 文件

   • 这是 autoconf 的输入文件，包含宏调用
   • 基本模板： m4 AC_INIT([package-name], [version], [bug-report-address]) AM_INIT_AUTOMAKE AC_PROG_CC AC_CONFIG_HEADERS([config.h]) AC_CONFIG_FILES([Makefile]) AC_OUTPUT

2. 运行 autoscan（可选）

   • 扫描源代码目录生成 configure.scan（可重命名为 configure.ac）

   autoscan
   mv configure.scan configure.ac
   

3. 编辑 configure.ac

   • 添加必要的检查项，如：
     • AC_CHECK_LIB - 检查库是否存在
     • AC_CHECK_HEADERS - 检查头文件
     • AC_PATH_PROG - 检查程序路径

4. 运行 aclocal

   • 生成 aclocal.m4 文件，包含本地宏定义

   aclocal
   

5. 运行 autoconf

   • 生成 configure 脚本

   autoconf
   

6. 创建 Makefile.am

   • 用于 automake 生成 Makefile.in
   • 示例： makefile bin_PROGRAMS = hello hello_SOURCES = hello.c

7. 运行 automake

   • 生成 Makefile.in 和其他必要文件

   automake --add-missing
   

8. 最终生成 configure 脚本

   • 现在可以运行生成的 configure 脚本了

   ./configure
   make
   make install
   

高级配置选项

1. 自定义检查

   • 在 configure.ac 中添加自定义检查： m4 AC_MSG_CHECKING([for something special]) # 执行检查代码 AC_MSG_RESULT([yes/no])

2. 条件编译

   • 使用 AM_CONDITIONAL 设置条件： m4 AC_CHECK_HEADER([some_header.h], [has_header=yes], [has_header=no]) AM_CONDITIONAL([HAVE_SOME_HEADER], [test "x$has_header" = "xyes"])

3. 生成头文件

   • 使用 AC_CONFIG_HEADERS 生成 config.h： m4 AC_CONFIG_HEADERS([config.h])

4. 处理子目录

   • 对于多目录项目： m4 AC_CONFIG_FILES([Makefile subdir/Makefile])

常见问题解决

1. "possibly undefined macro" 错误

   • 运行 aclocal 时缺少宏定义
   • 解决方案： bash aclocal -I /path/to/macro/dir

2. 缺少 install-sh 或其他辅助文件

   • 使用 automake --add-missing 自动添加

3. 库或头文件检查失败

   • 确保在 configure.ac 中正确设置了 CPPFLAGS 和 LDFLAGS
   • 示例： m4 AC_CHECK_LIB([m], [sqrt], [], [AC_MSG_ERROR([math library not found])])

最佳实践

1. 保持 configure.ac 文件整洁有序
2. 为每个检查提供有意义的错误消息
3. 使用 AC_ARG_WITH 和 AC_ARG_ENABLE 添加用户配置选项
4. 测试生成的 configure 脚本在不同平台上的行为
5. 将生成的 configure 脚本和 Makefile.in 包含在发布包中，而不是源代码

通过以上步骤，您可以创建一个可移植的自动配置系统，使您的软件能够在各种 UNIX-like 系统上编译安装。