将 CMakeToolchain 与不同的生成器结合使用:Ninja 示例

本指南演示了如何将 CMakeToolchain 与预定义生成器(如 Ninja)结合使用,以及如何配置它以使用不同的生成器。

注意

我们假设您已经在系统中安装了 Ninja。如果您的系统没有安装 Ninja,您可以通过添加 tool-requires 来在您的配置文件(默认或自定义)中使用 Ninja Conan 包

理解 CMake 生成器

CMake 客户端提供了各种生成器来创建构建系统文件。如果您想使用 CMake 默认选择之外的生成器,可以配置 tools.cmake.cmaketoolchain:generator

注意

请注意,CMake 客户端与 Conan CMake 助手不是一回事。

要查看系统上有哪些生成器可用,请运行

$ cmake --help

您可以将此配置设置在您的配置文件中、直接在命令行中,甚至在您的全局配置中

在配置文件中默认使用 Ninja 生成器

首先,让我们创建一个名为 my_custom_profile 的配置文件,这样我们就可以将 Ninja 生成器设置为使用此配置文件构建的所有 Conan 包的默认生成器。

$ conan profile detect --name=my_custom_profile

要在 my_custom_profile 配置文件中将 Ninja 生成器设置为默认值,请在文件中添加带有生成器值的条目 [conf]

[settings]
os=Linux
arch=x86_64
compiler=gcc
compiler.version=13
compiler.libcxx=libstdc++11
compiler.cppstd=20
build_type=Release

[conf]
tools.cmake.cmaketoolchain:generator=Ninja

现在,我们将创建一个基于 cmake_exe 模板的基本项目,作为 C++ 项目的示例

$ conan new cmake_exe -d name=foo -d version=0.1.0

然后,我们可以使用刚刚创建的配置文件构建您的项目

$ conan create . -pr=my_custom_profile

此配置将传递给由 CMakeToolchain 生成的 conan_toolchain.cmake 文件,然后将使用 Ninja 生成器。您应该看到以下输出片段,指示正在使用 Ninja 生成器

Profile host:
[settings]
...
[conf]
tools.cmake.cmaketoolchain:generator=Ninja

...
foo/0.1.0: Calling build()
foo/0.1.0: Running CMake.configure()
foo/0.1.0: RUN: cmake -G "Ninja" ...

请注意,相同的配置可以传递给默认配置文件,并用于使用该配置文件构建的所有 Conan 包。

如果通过命令行传递生成器配置,则此配置将覆盖配置文件中的配置。