CMake

CMake 构建助手是围绕 cmake 命令行调用的封装。它将把诸如 cmake --build . --config Release 的调用抽象为 Python 方法调用。它还会在 configure() 调用中添加参数 -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake(来自生成器 CMakeToolchain),以及其他可能的参数,例如 -DCMAKE_BUILD_TYPE=<config>。将使用的参数从生成的 CMakePresets.json 文件中获取。

该助手旨在用于 build() 方法中,以便在 Conan 直接构建包时(create, install)自动调用 CMake 命令

from conan import ConanFile
from conan.tools.cmake import CMake, CMakeToolchain, CMakeDeps

class App(ConanFile):
    settings = "os", "arch", "compiler", "build_type"
    requires = "hello/0.1"
    options = {"shared": [True, False], "fPIC": [True, False]}
    default_options = {"shared": False, "fPIC": True}

    def generate(self):
        tc = CMakeToolchain(self)
        tc.generate()
        deps = CMakeDeps(self)
        deps.generate()

    def build(self):
        cmake = CMake(self)
        cmake.configure()
        cmake.build()

参考

class CMake(conanfile)

与 CMakeToolchain 功能一起使用的 CMake 助手

参数:

conanfile – 当前的配方对象。始终使用 self

configure(variables=None, build_script_folder=None, cli_args=None, stdout=None, stderr=None)

读取由 CMakeToolchain 生成的 CMakePresets.json 文件以获取

  • 生成器,以追加 -G="xxx"

  • 工具链路径,并追加 -DCMAKE_TOOLCHAIN_FILE=/path/conan_toolchain.cmake

  • 声明的 cache variables,并追加 -Dxxx

并调用 cmake

参数:
  • variables – 应为 CMake 变量和值的字典,将被映射为命令行 -DVAR=VALUE 参数。请记住,在一般情况下,CMake 的信息应在 CMakeToolchain 中传递,以便在 conan_toolchain.cmake 文件中提供。此 variables 参数旨在用于在工具链方法中无法工作的特殊情况。

  • build_script_folder – CMakeLists.txt 的路径,以防它不在 layout() 方法中声明的 self.folders.source 中。

  • cli_args – 将作为额外命令行参数传递给 cmake 调用的参数列表 [arg1, arg2, ...]

  • stdout – 用于将标准输出重定向到此流

  • stderr – 用于将标准错误重定向到此流

build(build_type=None, target=None, cli_args=None, build_tool_args=None, stdout=None, stderr=None)
参数:
  • build_type – 仅用于覆盖多配置生成器(例如 Visual Studio、XCode)中 settings.build_type 中定义的值。对于单配置生成器,此值将被忽略,它们将在安装步骤中使用工具链文件中定义的值。

  • target – 单个构建目标的名称(字符串形式),或多个构建目标的名称(字符串列表形式),将传递给 --target 参数。

  • cli_args – 参数列表 [arg1, arg2, ...],将直接传递给 cmake --build ... arg1 arg2 命令。

  • build_tool_args – 底层构建系统的参数列表 [barg1, barg2, ...],将在 -- 指示符后传递给命令行:cmake --build ... -- barg1 barg2

  • stdout – 用于将标准输出重定向到此流

  • stderr – 用于将标准错误重定向到此流

install(build_type=None, component=None, cli_args=None, stdout=None, stderr=None)

等同于运行 cmake --install

参数:
  • component – 要安装的特定组件(如果有)

  • build_type – 仅用于覆盖 settings.build_type 中定义的值。如果构建是单配置(例如 Unix Makefiles),它可能会失败,因为在这种情况下,构建类型必须在配置时指定,而不是在构建时指定。

  • cli_args – 底层构建系统的参数列表 [arg1, arg2, ...],将传递给命令行:cmake --install ... arg1 arg2

  • stdout – 用于将标准输出重定向到此流

  • stderr – 用于将标准错误重定向到此流

test(build_type=None, target=None, cli_args=None, build_tool_args=None, env='', stdout=None, stderr=None)

等同于运行 cmake –build . –target=RUN_TESTS。

参数:
  • build_type – 仅用于覆盖 settings.build_type 中定义的值。如果构建是单配置(例如 Unix Makefiles),它可能会失败,因为在这种情况下,构建类型必须在配置时指定,而不是在构建时指定。

  • target – 要运行的构建目标的名称,默认为 RUN_TESTStest

  • cli_args – 同上 build(),一个参数列表 [arg1, arg2, ...],作为额外参数传递给底层构建系统

  • build_tool_args – 同上 build()

  • stdout – 用于将标准输出重定向到此流

  • stderr – 用于将标准错误重定向到此流

ctest(cli_args=None, env='', stdout=None, stderr=None)

等同于运行 ctest …

参数:
  • cli_args – 将作为额外 ctest 命令行参数传递的参数列表 [arg1, arg2, ...]

  • env – 要激活的环境文件,默认为 conanbuild + conanrun

  • stdout – 用于将标准输出重定向到此流

  • stderr – 用于将标准错误重定向到此流

conf

CMake() 构建助手受以下 [conf] 变量影响

  • 当 CMake 使用 Visual Studio 生成器(MSBuild 构建系统)时,tools.build:verbosity 将接受 quietverbose 之一,并传递给 CMake.build() 命令。它通过调用 cmake --build . --config Release -- /verbosity:Diagnostic 作为参数传递给底层构建系统。

  • 当传递给 CMake 时,tools.compilation:verbosity 将接受 quietverbose 之一;如果为 verbose,则会设置 -DCMAKE_VERBOSE_MAKEFILE

  • 运行 Ninja 生成器时,tools.build:jobs 参数对应于 --jobs 参数。

  • 运行 MSBuild 时,tools.microsoft.msbuild:max_cpu_count 参数对应于 /m (/maxCpuCount)。如果 max_cpu_count=0,则将使用不带参数的 /m,这意味着使用所有可用的 CPU。

  • tools.cmake:cmake_program 指定 CMake 可执行文件的位置,而不是使用 PATH 中找到的。

  • tools.cmake:install_strip (已弃用,请使用 tools.build:install_strip) 如果设置为 True,则会将 --strip 传递给 cmake --install 调用。

  • tools.build:install_strip (自 Conan 2.18.0 起) 如果设置为 True,则会将 --strip 传递给 cmake --install 调用。