CMakeToolchain:向依赖项注入任意 CMake 变量

您可以在 GitHub 上的 examples2 仓库中找到重现此项目的源代码

$ git clone https://github.com/conan-io/examples2.git
$ cd examples2/examples/tools/cmake/cmake_toolchain/user_toolchain_profile

一般来说,Conan 包的配方(recipes)通过设置(settings)、配置(confs)和选项(options)提供了必要的抽象,以控制构建的不同方面。许多配方定义了 options 来激活或禁用功能、可选依赖项或二进制特性。像 tools.build:cxxflags 这样的配置可用于注入任意 C++ 编译标志。

在某些特殊情况下,可能需要将 CMake 变量直接注入到进行 CMake 构建的依赖项中。当这些依赖项使用 CMakeToolchain 集成时,这是可行的。让我们通过这个简单的例子来验证一下。

如果我们有以下包配方,包含一个简单的 conanfile.py 文件和一个打印变量的 CMakeLists.txt 文件

conanfile.py
from conan import ConanFile
from conan.tools.cmake import CMake

class AppConan(ConanFile):
    name = "foo"
    version = "1.0"
    settings = "os", "compiler", "build_type", "arch"
    exports_sources = "CMakeLists.txt"

    generators = "CMakeToolchain"

    def build(self):
        cmake = CMake(self)
        cmake.configure()
        cmake.build()
CMakeLists.txt
cmake_minimum_required(VERSION 3.15)
project(foo LANGUAGES NONE)
message(STATUS "MYVAR1 ${MY_USER_VAR1}!!")

我们可以定义一个配置文件和一个 myvars.cmake 文件(两者都在同一个文件夹中),如下所示:

myprofile
include(default)
[conf]
tools.cmake.cmaketoolchain:user_toolchain+={{profile_dir}}/myvars.cmake

请注意,{{profile_dir}} 是一个 jinja 模板表达式,它会解析为当前配置文件所在的文件夹,从而可以计算出 myvars.cmake 文件的必要路径。tools.cmake.cmaketoolchain:user_toolchain 是一个要注入到生成的 conan_toolchain.cmake 文件中的文件列表,因此使用了 += 运算符来追加。

这个 myvars.cmake 文件可以定义任意数量的变量

myvars.cmake
set(MY_USER_VAR1 "MYVALUE1")

应用此配置文件后,我们可以看到包的 CMake 构建有效地使用了外部 myvars.cmake 文件中提供的变量

$ conan create . -pr=myprofile
...
-- MY_USER_VAR1 MYVALUE1

请注意,在为 tools.cmake.cmaketoolchain:system_name 等配置定义值时,也支持使用 user_toolchain

此外,user_toolchain 文件可以为交叉编译定义变量,例如 CMAKE_SYSTEM_NAMECMAKE_SYSTEM_VERSIONCMAKE_SYSTEM_PROCESSOR。如果这些变量在用户工具链文件中定义,它们将被尊重,并且 conan_toolchain.cmake 推导出的变量不会覆盖用户定义的变量。如果这些变量未在用户工具链文件中定义,则将使用 Conan 自动推导出的变量。

tools.cmake.cmaketoolchain:user_toolchain 配置值也可以通过命令行 -c 参数传递,但 myvars.cmake 的位置需要是绝对路径才能找到,因为 jinja 替换不会在命令行中发生。