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文件里。


  1. 笔者仅测试且使用于Windows操作系统,不保证这些命令可用于或不可用于其他操作系统下的CMake工具。 ↩︎

  2. 指随笔所述的命令及方法适用于极大多数需要CMake来生成构建文件的源码项目。 ↩︎

posted @ 2021-07-24 17:57  U_N_Owen  阅读(1060)  评论(0编辑  收藏  举报