CMakeToolchain:使用 Conan 生成的预设扩展您的 CMakePresets¶
在此示例中,我们将看到如何扩展您自己的 CMakePresets 以包含 Conan 生成的预设。
注意
我们在本例中使用 CMake presets。这需要 CMake >= 3.23,因为 CMakeUserPresets.json
到 CMakePresets.json
的“include”功能自该版本起才受支持。如果您不想使用 presets,可以使用类似以下的方式:
cmake <path> -G <CMake generator> -DCMAKE_TOOLCHAIN_FILE=<path to
conan_toolchain.cmake> -DCMAKE_BUILD_TYPE=Release
如果您无法使用预设功能,Conan 将在每次运行 conan install
时显示确切的 CMake 命令。
请首先克隆源代码以重新创建此项目。您可以在 GitHub 的 examples2 仓库中找到它们。
$ git clone https://github.com/conan-io/examples2.git
$ cd examples2/examples/tools/cmake/cmake_toolchain/extend_own_cmake_presets
请打开 conanfile.py 并查看它是如何设置 tc.user_presets_path = 'ConanPresets.json'
的。通过修改 CMakeToolchain 的此属性,您可以更改生成预设的默认文件名。
def generate(self):
tc = CMakeToolchain(self)
tc.user_presets_path = 'ConanPresets.json'
tc.generate()
...
现在,除了 CMakeLists.txt
之外,您还可以提供自己的 CMakePresets.json
CMakePresets.json¶
{
"version": 4,
"include": ["./ConanPresets.json"],
"configurePresets": [
{
"name": "default",
"displayName": "multi config",
"inherits": "conan-default"
},
{
"name": "release",
"displayName": "release single config",
"inherits": "conan-release"
},
{
"name": "debug",
"displayName": "debug single config",
"inherits": "conan-debug"
}
],
"buildPresets": [
{
"name": "multi-release",
"configurePreset": "default",
"configuration": "Release",
"inherits": "conan-release"
},
{
"name": "multi-debug",
"configurePreset": "default",
"configuration": "Debug",
"inherits": "conan-debug"
},
{
"name": "release",
"configurePreset": "release",
"configuration": "Release",
"inherits": "conan-release"
},
{
"name": "debug",
"configurePreset": "debug",
"configuration": "Debug",
"inherits": "conan-debug"
}
]
}
请注意 "include": ["./ConanPresets.json"],
以及每个预设都 继承
了 Conan 生成的一个。
现在我们可以为 Release 和 Debug(以及其他配置,如果需要,还可以借助 build_folder_vars
)进行安装
$ conan install .
$ conan install . -s build_type=Debug
并构建和运行我们的应用程序,方法是使用 **我们自己的预设** 来扩展 Conan 生成的预设
# Linux (single-config, 2 configure, 2 builds)
$ cmake --preset debug
$ cmake --build --preset debug
$ ./build/Debug/foo
> Hello World Debug!
$ cmake --preset release
$ cmake --build --preset release
$ ./build/Release/foo
> Hello World Release!
# Windows VS (Multi-config, 1 configure 2 builds)
$ cmake --preset default
$ cmake --build --preset multi-debug
$ build\\Debug\\foo
> Hello World Debug!
$ cmake --build --preset multi-release
$ build\\Release\\foo
> Hello World Release!