如何在 Autotools 中添加和实现配置标志？答案

【问题标题】：How to add and implement configure flags in Autotools?如何在 Autotools 中添加和实现配置标志？
【发布时间】：2009-08-18 18:53:11
【问题描述】：

我们研究小组的一部分程序具有ctemplate 库提供的辅助功能。在我们过时的集群上，由于编译，我们无法构建软件，所以我想分离这个功能并通过configure标志控制是否包含它，例如--disable-ctemplate。

该软件用 C++ 编写，使用 Autotools 构建系统——我对这两个系统都没有太多经验。我的理解是，要完成这个任务，我需要做到以下几点：

通过在configure.ac 中创建一个新的AC_ARG_ENABLE 条目，向配置脚本添加一个新标志。
在使用ctemplate 库的代码以及调用该代码的任何代码周围添加一些#ifdef（或可能是#ifndef）语句。

我认为第一步应该是这样的：

AC_ARG_ENABLE(ctemplate,
[  --disable-ctemplate    Disable HTML output],
[case "${enableval}" in
  yes) ctemplate=false ;;
  no)  ctemplate=true ;;
  *) AC_MSG_ERROR(bad value ${enableval} for --disable-ctemplate) ;;
esac],[ctemplate=true])
AM_CONDITIONAL(NOCTEMPLATE, test x$ctemplate = xfalse)

虽然我不知道逻辑是否正确，因为我已经根据使用 --enable-FLAG 而不是 --disable-FLAG 的示例改编了这个示例。

对于第二步，我会将部分包装在预处理器标志中，例如

#ifndef NOCTEMPLATE
void Class::MethodUsingCtemplate(...)
{
    ...
}
#endif

如果我这样做了configure --disable-ctemplate，这会正确地“连接”所有内容吗？

另外，这是否会确保程序不会进入ctemplate 库进行编译？如果没有，那么这一切都是徒劳的；我必须阻止 ctemplate 库和依赖组件的编译。

我将重申我对 C++ 和 Autotools 都不熟悉；我采取了一种非常幼稚的第一种方法来解决这个问题。如果您在这方面有经验，我将非常感谢您的更正和您可以提供的任何解释。

【问题讨论】：

＋1。这应该在 Autotools 手册中，而不是要求人们将其拼凑在一起，在邮件列表或 Stack Overflow 上查找。

标签： configuration build-process autotools

【解决方案1】：

这是我在阅读了文档、教程、帮助线程、邮件列表等之后整理出来的解决方案，我只是简单地尝试了一些事情，直到它们起作用，我可以解释它们为什么起作用。

在configure.ac中，我放置了以下几行代码

# This adds the option of compiling without using the ctemplate library,
# which has proved troublesome for compilation on some platforms
AC_ARG_ENABLE(ctemplate,
  [ --disable-ctemplate   Disable compilation with ctemplate and HTML output],
  [case "${enableval}" in
     yes | no ) WITH_CTEMPLATE="${enableval}" ;;
     *) AC_MSG_ERROR(bad value ${enableval} for --disable-ctemplate) ;;
   esac],
  [WITH_CTEMPLATE="yes"]
)

dnl Make sure we register this option with Automake, so we know whether to
dnl descend into ctemplate for more configuration or not
AM_CONDITIONAL([WITH_CTEMPLATE], [test "x$WITH_CTEMPLATE" = "xyes"])

# Define CTEMPLATE in config.h if we're going to compile against it
if test "x$WITH_CTEMPLATE" = "xyes"; then
    AC_DEFINE([CTEMPLATE], [], ["build using ctemplate library"])
    AC_MSG_NOTICE([ctemplate will be used, HTML output enabled])
else
    AC_MSG_NOTICE([ctemplate will not be used, HTML output disabled])
fi

在下一步中，我将顶层的Makefile.am 更改为以下内容：

if WITH_CTEMPLATE
  MAYBE_CTEMPLATE = ctemplate
endif

SUBDIRS = boost libgsl $(MAYBE_CTEMPLATE) libutil ...

在较低级别Makefile.ams，我添加了

if WITH_CTEMPLATE
    # some change to the configuration
else
    # some other change to the configuration
endif

最后，我必须确保关键的 C++ 头文件之一（包含在代码的其他部分中）具有以下内容：

#ifdef HAVE_CONFIG_H
#    include "config.h"
#endif

config.h 包含使用AC_DEFINE 创建的任何新定义，因此该文件必须包含在检查由该路由创建的宏定义是否已定义（或未定义）的部分中。

这花费了我很多时间，并克服了我的挫败感；我只能希望在这里记录这个解释可以让其他人免于同样的命运。

【讨论】：

【解决方案2】：

为了防止构建尝试在 ctemplate 子目录中编译，您需要执行以下操作：

如果 CTEMPLATE 子目录 += ctemplate 万一

在 Makefile.am 中

【讨论】：