|
博文目录
参考资料
推荐的教学视频
教学视频对应的资料文件 基于VSCode和CMake实现C 开发 - Linux篇V1.0.pdf
CMake
CMake是一个跨平台的安装编译工具，可以用简单的语句来描述所有平台的安装(编译过程)。
CMake可以说已经成为大部分C++开源项目标配
语法特性
重要指令
- cmake_minimum_required - 指定CMake的最小版本要求
- 语法： cmake_minimum_required(VERSION versionNumber [FATAL_ERROR])
# CMake最小版本要求为2.8.3
cmake_minimum_required(VERSION 2.8.3)
- project - 定义工程名称，并可指定工程支持的语言
- 语法： project(projectname [CXX] [C] [Java])
# 指定工程名为HELLOWORLD
project(HELLOWORLD)
- set - 显式的定义变量
- 语法：set(VAR [VALUE] [CACHE TYPE DOCSTRING [FORCE]])
# 定义SRC变量，其值为sayhello.cpp hello.cpp
set(SRC sayhello.cpp hello.cpp)
- include_directories - 向工程添加多个特定的头文件搜索路径 —>相当于指定g++编译器的-I参数
- 语法： include_directories([AFTER|BEFORE] [SYSTEM] dir1 dir2 …)
# 将/usr/include/myincludefolder 和 ./include 添加到头文件搜索路径
include_directories(/usr/include/myincludefolder ./include)
- link_directories - 向工程添加多个特定的库文件搜索路径 —>相当于指定g++编译器的-L参数
- 语法： link_directories(dir1 dir2 …)
# 将/usr/lib/mylibfolder 和 ./lib 添加到库文件搜索路径
link_directories(/usr/lib/mylibfolder ./lib)
- add_library - 生成库文件, SHARED:动态库(.so), STATIC:静态库(.a)
- 语法： add_library(libname [SHARED|STATIC|MODULE] [EXCLUDE_FROM_ALL] source1 source2 … sourceN)
# 通过变量 SRC 生成 libhello.so 共享库
add_library(hello SHARED ${SRC})
- add_compile_options - 添加编译参数
- 语法：add_compile_options(< option> …)
# 添加编译参数 -Wall -std=c++11 -O2
add_compile_options(-Wall -std=c++11 -O2)
- add_executable - 生成可执行文件
- 语法：add_executable(exename source1 source2 … sourceN)
# 编译main.cpp生成可执行文件main
add_executable(main main.cpp)
- target_link_libraries - 为 target 添加需要链接的共享库 —>相同于指定g++编译器-l参数
- 语法： target_link_libraries(target library1<debug | optimized> library2 …)
# 将hello动态库文件链接到可执行文件main
target_link_libraries(main hello)
- add_subdirectory - 向当前工程添加存放源文件的子目录，并可以指定中间二进制和目标二进制存放的位置
- 语法： add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL])
# 添加src子目录，src中需有一个CMakeLists.txt
add_subdirectory(src) 12
- aux_source_directory - 发现一个目录下所有的源代码文件并将列表存储在一个变量中，这个指令临时被用来自动构建源文件列表
- 语法： aux_source_directory(dir VARIABLE)
# 定义SRC变量，其值为当前目录下所有的源代码文件
aux_source_directory(. SRC)
# 编译SRC变量所代表的源代码文件，生成main可执行文件
add_executable(main ${SRC})
常用变量
- CMAKE_C_FLAGS gcc编译选项
- CMAKE_CXX_FLAGS g++编译选项
# 在CMAKE_CXX_FLAGS编译选项后追加-std=c++11
set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11")
- CMAKE_BUILD_TYPE 编译类型(Debug, Release)
# 设定编译类型为debug，调试时需要选择debug
set(CMAKE_BUILD_TYPE Debug)
# 设定编译类型为release，发布时需要选择release
set(CMAKE_BUILD_TYPE Release) 1234
- CMAKE_BINARY_DIR / PROJECT_BINARY_DIR / < projectname>_BINARY_DIR
这三个变量指代的内容是一致的。
如果是 in source build，指的就工程顶层目录。
如果是 out-of-source 编译，指的是工程编译发生的目录。
PROJECT_BINARY_DIR 跟其他指令稍有区别，不过现在，你可以理解为他们是一致的。
- CMAKE_SOURCE_DIR / PROJECT_SOURCE_DIR / < projectname>_SOURCE_DIR
这三个变量指代的内容是一致的,不论采用何种编译方式,都是工程顶层目录。
也就是在 in source build时,他跟 CMAKE_BINARY_DIR 等变量一致。
PROJECT_SOURCE_DIR 跟其他指令稍有区别,现在,你可以理解为他们是一致的。
- CMAKE_C_COMPILER：指定C编译器
- CMAKE_CXX_COMPILER：指定C++编译器
- EXECUTABLE_OUTPUT_PATH：可执行文件输出的存放路径
- LIBRARY_OUTPUT_PATH：库文件输出的存放路径
编译工程
CMake目录结构：项目主目录存在一个CMakeLists.txt文件
两种方式设置编译规则
- 包含源文件的子文件夹包含CMakeLists.txt文件，主目录的CMakeLists.txt通过add_subdirectory添加子目录即可
- 包含源文件的子文件夹未包含CMakeLists.txt文件，子目录编译规则体现在主目录的CMakeLists.txt中
编译流程
在 linux 平台下使用 CMake 构建C/C++工程的流程如下
- 手动编写 CMakeLists.txt
- 执行命令
cmake PATH 生成 Makefile ( PATH 是顶层CMakeLists.txt 所在的目录 ) - 执行命令
make 进行编译
重要提示
- 表示当前目录:
. / ./ - 表示上层目录:
.. / ../
两种构建方式
- 内部构建(in-source build)：不推荐使用
- 内部构建会在同级目录下产生一大堆中间文件，这些中间文件并不是我们最终所需要的，和工程源
文件放在一起会显得杂乱无章。
# 在当前目录下，编译本目录的CMakeLists.txt，生成Makefile和其他文件
cmake .
# 执行make命令，生成target
make
- 外部构建(out-of-source build)：推荐使用
# 1. 在当前目录下，创建build文件夹
mkdir build
# 2. 进入到build文件夹
cd build
# 3. 编译上级目录的CMakeLists.txt，生成Makefile和其他文件
cmake ..
# 4. 执行make命令，生成target
make
代码实践
【实战】CMake代码实践
|