目录
目录
set 设置变量-------------------------添加版本号
add_definitions-------------------------添加宏定义
使用工具:
vs 2019, Clion
系统: Windows
参考网址:cmake使用教程(一)-起步 - 掘金
创建一个新项目
在main.cpp 同目录下 添加一个新文件 CMakeLists.txt, 一个简单的项目一般包含如下内容:
cmake_minimum_required(VERSION 3.0)
project(TESTCMAKE)
add_executable(test main.cpp)
cmake_minimum_required
:指定使用的 cmake 的最低版本 (非必需,一般都加上,不加会有警告。)project
:定义工程名称(必要),并可指定工程的版本、工程描述、web主页地址、支持的语言(默认情况支持所有语言),如果不需要这些都是可以忽略的,只需要指定出工程名字即可。add_executable
:定义工程会生成一个可执行程序。源文件名可以是一个也可以是多个,如有多个可用空格或分号(;)间隔。
项目设置:
project(<PROJECT-NAME> [VERSION <major>[.<minor>[.<patch>[.<tweak>]]]] [LANGUAGES <language-name>...])
可只设置项目名称:如:
project ("cPulsPlusTestProject")
也可设置一下项目描述,项目地址等
project (cPulsPlusTestPrj
VERSION 1.0.0
DESCRIPTION "项目描述:xxxxx"
HOMEPAGE_URL "项目地址,比如:github 地址"
LANGUAGES CXX)
注意: 上面代码片段大写的必须大写,否则编译通不过,比如(LANGUAGES CXX, DESCRIPTION 等)
构建程序
使用cmake 来构建程序:
cmake CMakeLists.txt文件所在路径
使用 cmake . 命令
构建前:
构建后:
不过我使用 clion 构建的程序一直默认为 vs 2019
构建后:
如果要重新cmake ,需删除 缓存
make
windows下提示make不是内部命令
如果你用MinGW,你的make 叫 mingw32-make
如果你用MSVC,你的make叫 nmake
问题:待解?----已解
cmake . 老是默认为 vs2019
疑似:未理解 cmake 后面的点(.) 是什么意思
经测试应该是路径,确切的应该是 CMakeList.txt 所在位置,所以 我应该是../ 返回上一级
一直使用上一级路径, 所以 cmake 出来 总是默认为 vs 2019
当我进入mingw 下 ,构建的就不是 vs 2019 环境了:如:
set 设置变量-------------------------添加版本号
set(KEY VALUE)
接受两个参数,用来声明变量。在camke语法中使用KEY
并不能直接取到VALUE
,必须使用${KEY}
这种写法来取到VALUE
。
设置系统自带的变量
如:C++ 标准
set(cmake_cxx_standard 11)
设置自定义变量
设置自定义的变量,例如:设置头文件搜索路径
CMAKE_CURRENT_SOURCE_DIR
这是当前处理的CMakeLists.txt所在的目录
添加版本号
首先设置两个变量
set (cPlusPlusTest_version_major 1)
set (cPlusPlusTest_version_minor 0)
configure_file(
"${PROJECT_SOURCE_DIR}/cPlusPlusTestConfig.h.in"
"${PROJECT_BINARY_DIR}/cPlusPlusTestConfig.h"
)
在cPlusPlusTestConfig.h.in 中加入
#define cPlusPlusTest_version_major @cPlusPlusTest_version_major@
#define cPlusPlusTest_version_minor @cPlusPlusTest_version_minor@
使用
扩展:
configure_file(input output options)
将一个文件(由input
参数指定)拷贝到指定位置(由output
参数指定),并根据options
修改其内容。
configure_file命令一般用于自定义编译选项或者自定义宏的场景。configure_file命令会根据options
指定的规则:
- COPYONLY:只拷贝文件,不进行任何的变量替换。这个选项在指定了
NEWLINE_STYLE
选项时不能使用(无效)。 - ESCAPE_QUOTES:躲过任何的反斜杠(C风格)转义。
将input文件复制到output文件,并在输入文件内容中的变量,替换引用为@VAR@或${VAR}的变量值。每个变量引用将替换为该变量的当前值,如果未定义该变量,则为空字符串。
例如:cPlusPlusTestConfig.h.in
1. 定义 CMakeList.txt
set (cPlusPlusTest_version_major 1.9)
set (cPlusPlusTest_version_minor 0)
configure_file(
"${PROJECT_SOURCE_DIR}/cPlusPlusTestConfig.h.in"
"${PROJECT_BINARY_DIR}/cPlusPlusTestConfig.h"
)
2. cPlusPlusTestConfig.h.in(输入文件)
#define cPlusPlusTest_version_major @cPlusPlusTest_version_major@
#define cPlusPlusTest_version_minor @cPlusPlusTest_version_minor@
3. cPlusPlusTestConfig.h(输出文件)
自动生成,无需我们手动操作输入
PROJECT_BINARY_DIR:官方解释是 用于生成项目目录的完整路径
例如:
PROJECT_SOURCE_DIR:
PROJECT_SOURCE_DIR为包含PROJECT()的最近一个CMakeLists.txt文件所在的文件夹。
例如:内层的CMakeLists.txt 中不包project()
此时将出错 告诉我文件不存在
我将其放置于外层,则没有错误
add_definitions-------------------------添加宏定义
添加一个flag用于预处理
添加方式有两种:
- -D开头
- /D开头
例如:add_definitions(-DMyDebug)
使用:
注意:使用时不要前面的 -D