CMake学习笔记:命令行工具在Windows系统下的通用使用方法
本随笔用于记录CMake命令行工具在Windows[1]操作系统下通用[2]的命令及使用方法,而不是关于如何编写CMakeList文件的教程,且不涉及到CMake工具的介绍。欲了解CMake工具请查阅CMake官方英文文档(3.21版本)
随笔作者还在学习阶段,对工具的使用不是非常透彻,难免在本随笔里出现技术上或书写上的问题,如果出现了类似的问题欢迎在评论区或私信讨论。
生成构建文件
cmake <源码目录>
使用该命令即可在当前文件夹(指DOS命令行窗口运行命令时所在的目录,而不是<源码目录>
)生成构建所需要的文件,该操作不会对<源码目录>
有任何形式的修改,但是会生成新的文件,因此在执行该步骤的时候建议先从DOS命令行窗口切换到一个空的目录上再执行,这样可以保证<源码目录>
的纯净。
构建项目
cmake --build <构建文件目录> --config {Release|Debug}
该命令可在当前文件夹去按照选项--config
指定的配置来构建项目,选项--config
的参数并不一定只有Release和Debug两种。需要注意的是选项--build
传递的参数是生成构建文件步骤创建的文件所在的目录,而不是源码目录。
安装项目
cmake --install <构建文件目录> --config {Release|Debug} --prefix <目标路径>
安装项目指的是将构建好后全部所需的文件复制到指定的目录上,该操作只会复制该库/软件使用过程中必要的文件,而不会复制CMake工具所需的文件。使用该命令会将由选项--config
指定的配置构建好的文件复制到选项--prefix
指定的目录里。
修改变量
cmake -D<变量名>=<新的变量值> <构建文件目录>
该命令会修改CMakeCache文件里对应变量名的值并重新保存到CMakeCache文件里。