使用 Conan 依赖项构建简单的 Autotools 项目¶
警告
此示例仅适用于 Linux 和 OSX 环境,不支持 Windows,包括 msys2/cygwin 子系统。但是,Windows 子系统 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://www.gnu.org/software/autoconf/manual/autoconf-2.60/html_node/Writing-configure_002eac.html>_,其中包括 fmt pkg-config 依赖项以及 main.cpp 中字符串格式化程序的源代码。
让我们看一下 main.cpp 文件,它只打印一条简单的消息,但使用 fmt::print
方法来实现。
#include <cstdlib>
#include <fmt/core.h>
int main() {
fmt::print("{} - The C++ Package Manager!\n", "Conan");
return EXIT_SUCCESS;
}
The configure.ac
文件使用 AC_PROG_CXX
宏检查 C++ 编译器,并使用 PKG_CHECK_MODULES
宏检查 fmt.pc
pkg-config 模块。
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
The Makefile.am 指定 string_formatter
是预期的可执行文件,并且应该链接到 fmt
库。
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)
The conanfile.txt 看起来很简单,因为它只是安装 fmt 包并使用两个生成器来构建我们的项目。
[requires]
fmt/9.1.0
[generators]
AutotoolsToolchain
PkgConfigDeps
在本例中,我们将使用 PkgConfigDeps 来生成关于 fmt 库文件安装位置的信息(感谢 *.pc 文件)以及 AutotoolsToolchain 来通过描述编译环境的 conanbuild[.sh|.bat] 文件将构建信息传递给 autotools。
我们将使用 Conan 来安装 fmt 库,为 Autotools 生成工具链,以及为 pkg-config 查找 fmt 生成 .pc 文件。
在 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
The conanbuild.sh
是 VirtualBuildEnv 生成的默认文件,它可以帮助我们加载其他脚本文件,因此我们无需执行更多手动步骤来加载每个生成器文件。它将加载由 AutotoolsToolchain 生成的 conanautotoolstoolchain.sh
,该文件根据运行 conan install
命令时使用的 Conan 配置文件定义环境变量。配置的环境变量与编译器和 autotools
相关,例如 CFLAGS
、CPPFLAGS
、LDFLAGS
和 PKG_CONFIG_PATH
。
下一步,我们可以通过按顺序运行以下命令来配置项目
aclocal
automake --add-missing
autoconf
./configure
The aclocal 命令将读取 configure.ac
文件并生成一个名为 aclocal.m4
的新文件,其中包含 automake
所需的宏。第二步,automake 命令将读取 Makefile.am
,并生成 Makefile.in
文件。因此,autoconf 命令将使用这些文件并生成 configure
文件。一旦我们运行 configure
,所有环境变量都将被使用。 fmt.pc
也将在这一步加载,因为 autotools
使用自定义的 PKG_CONFIG_PATH
来查找它。
然后,最后,我们可以构建项目以生成字符串格式化应用程序。现在我们运行 make
命令,该命令将使用由 autotools
生成的 Makefile
。
make
The make
命令将读取 Makefile
并调用编译器,然后构建 main.cpp
,在同一文件夹中生成可执行文件 string_formatter
。
./string_formatter
Conan - The C++ Package Manager!
最终输出是一个新应用程序的结果,它在 fmt
库的帮助下打印一条消息,并由 Autotools
构建。