cmake阅读笔记

1. cmake使用

1.1 查看cmake各种变量

# 仅查看缓存变量
cmake -L -S .  -B build
# 查看该变量的更多帮助信息
cmake -LH -S . -B build
cmake -LHA -S . -B build
# 但是, -D 的不会打印出来

1.2 调试信息

cmake --log-level=ERROR|WARNING|NOTICE|STATUS|VERBOSE|DEBUG|TRACE
cmake --trace -S . -B build

1.3 清理构建树

cmake --fresh -S . -B build

1.4 编译项目

# cmake --build <build tree>, 这里<build tree> == -B时传入的参数
# cmake --build <build tree> -- <build tool options>
cmake --build build
# 并行编译
cmake --build build -j
# 编译指定的target
cmake --build <build tree> --target <target1> ...
# 清理构建树
cmake --build <build tree> -t clean
# 语法糖
cmake --build <build tree> --clean-first
# 指定构建类型(比如Debug或者Release)，默认值是Debug
cmake --build <build tree> --config Debug
cmake --build <build tree> --config RelWithDebInfo
# 调试构建过程
cmake --build <build tree> --verbose
cmake --build <build tree> -v

1.5 安装项目

cmake --install <build tree> [<options>]
# 自定义安装路径
cmake --instlal <build tree> --install-prefix <prefix>
cmake --install <build tree> --prefix <prefix>
# 多配置生成器，可以安装Debug/Release/MinSizeRel/RelWithDebInfo
cmake --install <build tree> --prefix <prefix> --config Release
# cmake --install build --prefix install --config Release
# 调试信息
cmake --install <build tree> -v
cmake --install <build tree> --verbose

1.6 命令行工具

cmake -E <command> [<options>]

1.7 CTest

# ctest --build-and-test <source tree>  <build tree> --build-generator "Visual Studio 16 2019"
ctest --build-and-test . build --build-generator "Visual Studio 16 2019"
ctest --build-and-test . build --build-generator "Unix Makefiles"
# 在 build tree目录下, 执行ctest才能进行测试

2.可视化

cmake --graphviz=test.dot