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

警告

此示例仅适用于 Linux 和 OSX 环境，不直接支持 Windows，包括 msys2/cygwin 子系统。但是，Windows Subsystem for Linux (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://gnu.ac.cn/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 配置文件，但 fmt 与许多不同的配置高度兼容。因此，它应该主要与 GCC 和 Clang 编译器的版本一起工作。

作为第一步，我们应该安装 conanfile.txt 中列出的所有依赖项。命令 :ref: conan install<reference_commands_install> 不仅会安装 fmt 包，而且如果您的配置文件与远程仓库中的预构建二进制文件不匹配，还会从源代码构建它。此外，它还将提供 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 生成的默认文件，可帮助我们加载其他脚本文件，因此我们无需执行更多手动步骤来加载每个生成器文件。它将加载 AutotoolsToolchain 生成的 conanautotoolstoolchain.sh，它根据我们在运行 conan install 命令时使用的 Conan 配置文件定义环境变量。这些配置的环境变量与编译器和 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 构建。