使用 Conan 依赖项构建简单的 Autotools 项目¶

警告

此示例仅适用于 Linux 和 OSX 环境，不直接支持 Windows，包括 msys2/cygwin 子系统。但是，Linux 的 Windows 子系统 (WSL) 应该可以工作，因为它提供了 Linux 环境。虽然 Conan 为在 Windows 环境中使用 Autotools 提供了一定程度的支持，可以通过 win_bash = True 来实现，但这在本教程中不适用。

在这个例子中，我们将创建一个字符串格式化应用程序，它使用最流行的 C++ 库之一：fmt。

我们将使用 Autotools 作为构建系统，并使用 pkg-config 作为辅助工具。因此，在继续进行此示例之前，您应该在 Linux 和 Mac 上安装它们。

请先克隆源代码以重新创建此项目。您可以在 GitHub 上的 examples2 存储库中找到它们

git clone https://github.com/conan-io/examples2.git
cd examples2/examples/tools/autotools/autotoolstoolchain/string_formatter

我们从一个非常简单的 C++ 语言项目开始，其结构如下

.
├── configure.ac
├── Makefile.am
├── conanfile.txt
└── src
    └── main.cpp

此项目包含一个基本的 configure.ac <https://www.gnu.org/software/autoconf/manual/autoconf-2.60/html_node/Writing-configure_002eac.html>_，包括 fmt pkg-config 依赖项和字符串格式化程序在 *main.cpp* 中的源代码。

让我们看一下 *main.cpp* 文件，它只打印一条简单的消息，但使用了 fmt::print 方法。

**main.cpp**¶

#include <cstdlib>
#include <fmt/core.h>

int main() {
    fmt::print("{} - The C++ Package Manager!\n", "Conan");
    return EXIT_SUCCESS;
}

configure.ac 文件使用 AC_PROG_CXX 宏检查 C++ 编译器，并使用 PKG_CHECK_MODULES 宏检查 fmt.pc pkg-config 模块。

**configure.ac**¶

AC_INIT([stringformatter], [0.1.0])
AM_INIT_AUTOMAKE([1.10 -Wall no-define foreign])
AC_CONFIG_SRCDIR([src/main.cpp])
AC_CONFIG_FILES([Makefile])
PKG_CHECK_MODULES([fmt], [fmt])
AC_PROG_CXX
AC_OUTPUT

*Makefile.am* 指定 string_formatter 是预期的可执行文件，并且应该链接到 fmt 库。

**Makefile.am**¶

AUTOMAKE_OPTIONS = subdir-objects
ACLOCAL_AMFLAGS = ${ACLOCAL_FLAGS}

bin_PROGRAMS = string_formatter
string_formatter_SOURCES = src/main.cpp
string_formatter_CPPFLAGS = $(fmt_CFLAGS)
string_formatter_LDADD = $(fmt_LIBS)

*conanfile.txt* 看起来很简单，因为它只安装了 fmt 包并使用两个生成器来构建我们的项目。

**conanfile.txt**¶

[requires]
fmt/9.1.0

[generators]
AutotoolsToolchain
PkgConfigDeps

在这种情况下，我们将使用 PkgConfigDeps 生成有关 fmt 库文件安装位置的信息，这要归功于 *.pc 文件和 AutotoolsToolchain，以使用描述编译环境的 conanbuild[.sh|.bat] 文件将构建信息传递给 *autotools*。

我们将使用 Conan 安装 fmt 库，为 Autotools 生成工具链，并生成 .pc 文件以便 pkg-config 找到 fmt。

在 Linux 和 macOS 上构建¶

首先，我们应该安装一些要求。在 Linux 上，您需要安装 automake、pkgconf 和 make 包，它们的包名称应根据 Linux 发行版而有所不同，但本质上，它应包含构建以下示例所需的所有工具（aclocal、automake、autoconf 和 make）。

对于此示例，我们不考虑特定的 Conan profile，但 fmt 与许多不同的配置高度兼容。因此，它应该主要与 GCC 和 Clang 编译器的版本一起工作。

第一步，我们应该安装 conanfile.txt 中列出的所有依赖项。命令 :ref: conan install<reference_commands_install> 不仅会安装 fmt 包，而且如果您的 profile 与远程仓库中的预构建二进制文件不匹配，还会从源代码构建它。此外，它还会提供 conanfile.txt 中列出的这些生成器

conan install . --build=missing

运行 conan install 命令后，我们应该在 *string_formatter* 文件夹中看到新文件

└── string_formatter
    ├── Makefile.am
    ├── conanautotoolstoolchain.sh
    ├── conanbuild.conf
    ├── conanbuild.sh
    ├── conanbuildenv-release-armv8.sh
    ├── conanfile.txt
    ├── conanrun.sh
    ├── conanrunenv-release-armv8.sh
    ├── configure.ac
    ├── deactivate_conanbuild.sh
    ├── deactivate_conanrun.sh
    ├── fmt-_fmt.pc
    ├── fmt.pc
    ├── run_example.sh
    └── src
        └── main.cpp

这些文件是 conanfile.txt 中列出的这些生成器的结果。一旦生成了构建示例所需的所有文件并安装了 fmt，我们现在可以加载脚本 conanbuild.sh。

source conanbuild.sh

conanbuild.sh 是 VirtualBuildEnv 生成的默认文件，可帮助我们加载其他脚本文件，因此我们不需要执行更多手动步骤来加载每个生成器文件。它将加载 conanautotoolstoolchain.sh，该文件由 AutotoolsToolchain 生成，它根据我们运行 conan install 命令时的 Conan profile 定义环境变量。这些配置的环境变量与编译器和 autotools 相关，例如 CFLAGS、CPPFLAGS、LDFLAGS 和 PKG_CONFIG_PATH。

下一步，我们可以通过按顺序运行以下命令来配置项目

aclocal
automake --add-missing
autoconf
./configure

aclocal 命令将读取文件 configure.ac 并生成一个名为 aclocal.m4 的新文件，该文件包含 automake 所需的宏。第二步，automake 命令将读取 Makefile.am，并生成文件 Makefile.in。因此，autoconf 命令将使用这些文件并生成 configure 文件。一旦我们运行 configure，所有环境变量都将被使用。 fmt.pc 也将在这一步加载，因为 autotools 使用自定义的 PKG_CONFIG_PATH 来查找它。

然后，最后，我们可以构建项目以生成字符串格式化应用程序。现在我们运行 make 命令，该命令将使用 autotools 生成的 Makefile。

make

make 命令将读取 Makefile 并调用编译器，然后构建 main.cpp，在同一文件夹中生成可执行文件 string_formatter。

./string_formatter
Conan - The C++ Package Manager!

最终输出是一个新应用程序的结果，它借助 fmt 库打印消息，并由 Autotools 构建。