网站备案的幕布是什么意思,网站被黑怎么恢复,昆山周市建设局网站,代做网站地图1. CMake概述
CMake 是一个项目构建工具#xff0c;并且是跨平台的。关于项目构建我们所熟知的还有Makefile#xff08;通过 make 命令进行项目的构建#xff09;#xff0c;大多是IDE软件都集成了make#xff0c;比如#xff1a;VS 的 nmake、linux 下的 GNU make、Qt …1. CMake概述
CMake 是一个项目构建工具并且是跨平台的。关于项目构建我们所熟知的还有Makefile通过 make 命令进行项目的构建大多是IDE软件都集成了make比如VS 的 nmake、linux 下的 GNU make、Qt 的 qmake等如果自己动手写 makefile会发现makefile 通常依赖于当前的编译平台而且编写 makefile 的工作量比较大解决依赖关系时也容易出错。
而 CMake 恰好能解决上述问题 其允许开发者指定整个工程的编译流程在根据编译平台自动生成本地化的Makefile和工程文件最后用户只需make编译即可所以可以把CMake看成一款自动生成 Makefile的工具其编译流程如下图
蓝色虚线表示使用makefile构建项目的过程红色实线表示使用cmake构建项目的过程
介绍完CMake的作用之后再来总结一下它的优点
跨平台能够管理大型项目简化编译构建过程和编译过程可扩展可以为 cmake 编写特定功能的模块扩充 cmake 功能
2. CMake的使用
CMake支持大写、小写、混合大小写的命令。如果在编写CMakeLists.txt文件时使用的工具有对应的命令提示那么大小写随缘即可不要太过在意。
2.1 注释
2.1.1 注释行
CMake 使用 # 进行行注释可以放在任何位置。
# 这是一个 CMakeLists.txt 文件
cmake_minimum_required(VERSION 3.0.0)2.1.2 注释块
CMake 使用 #[[ ]] 形式进行块注释。
#[[ 这是一个 CMakeLists.txt 文件。
这是一个 CMakeLists.txt 文件
这是一个 CMakeLists.txt 文件]]
cmake_minimum_required(VERSION 3.0.0)2.2 只有源文件
2.2.1 共处一室
1、准备工作为了方便测试在我本地电脑准备了这么几个测试文件
add.c
#include stdio.h
#include head.hint add(int a, int b)
{return ab;
}
sub.c
#include stdio.h
#include head.h// 你好
int subtract(int a, int b)
{return a-b;
}mult.c
#include stdio.h
#include head.hint multiply(int a, int b)
{return a*b;
}div.c
#include stdio.h
#include head.hdouble divide(int a, int b)
{return (double)a/b;
}head.h
#ifndef _HEAD_H
#define _HEAD_H
// 加法
int add(int a, int b);
// 减法
int subtract(int a, int b);
// 乘法
int multiply(int a, int b);
// 除法
double divide(int a, int b);
#endifmain.c
#include stdio.h
#include head.hint main()
{int a 20;int b 12;printf(a %d, b %d\n, a, b);printf(a b %d\n, add(a, b));printf(a - b %d\n, subtract(a, b));printf(a * b %d\n, multiply(a, b));printf(a / b %f\n, divide(a, b));return 0;
}2、上述文件的目录结构如下
$ tree
.
├── add.c
├── div.c
├── head.h
├── main.c
├── mult.c
└── sub.c3、添加 CMakeLists.txt 文件
在上述源文件所在目录下添加一个新文件 CMakeLists.txt文件内容如下
cmake_minimum_required(VERSION 3.0)
project(CALC)
add_executable(app add.c div.c main.c mult.c sub.c)
接下来依次介绍一下在 CMakeLists.txt 文件中添加的三个命令:
cmake_minimum_required指定使用的 cmake 的最低版本
可选非必须如果不加可能会有警告
project定义工程名称并可指定工程的版本、工程描述、web主页地址、支持的语言默认情况支持所有语言如果不需要这些都是可以忽略的只需要指定出工程名字即可。
# PROJECT 指令的语法是
project(PROJECT-NAME [language-name...])
project(PROJECT-NAME[VERSION major[.minor[.patch[.tweak]]]][DESCRIPTION project-description-string][HOMEPAGE_URL url-string][LANGUAGES language-name...])add_executable定义工程会生成一个可执行程序
add_executable(可执行程序名 源文件名称)这里的可执行程序名和project中的项目名没有任何关系 源文件名可以是一个也可以是多个如有多个可用空格或;间隔
# 样式1
add_executable(app add.c div.c main.c mult.c sub.c)
# 样式2
add_executable(app add.c;div.c;main.c;mult.c;sub.c)
4、执行CMake 命令
万事俱备只欠东风将 CMakeLists.txt 文件编辑好之后就可以执行 cmake命令了。
# cmake 命令原型
$ cmake CMakeLists.txt文件所在路径$ tree
.
├── add.c
├── CMakeLists.txt
├── div.c
├── head.h
├── main.c
├── mult.c
└── sub.c0 directories, 7 files
robinOS:~/Linux/3Day/calc$ cmake .当执行cmake命令之后CMakeLists.txt 中的命令就会被执行所以一定要注意给cmake 命令指定路径的时候一定不能出错。
执行命令之后看一下源文件所在目录中是否多了一些文件
$ tree -L 1
.
├── add.c
├── CMakeCache.txt # new add file
├── CMakeFiles # new add dir
├── cmake_install.cmake # new add file
├── CMakeLists.txt
├── div.c
├── head.h
├── main.c
├── Makefile # new add file
├── mult.c
└── sub.c我们可以看到在对应的目录下生成了一个makefile文件此时再执行make命令就可以对项目进行构建得到所需的可执行程序了。
$ make
Scanning dependencies of target app
[ 16%] Building C object CMakeFiles/app.dir/add.c.o
[ 33%] Building C object CMakeFiles/app.dir/div.c.o
[ 50%] Building C object CMakeFiles/app.dir/main.c.o
[ 66%] Building C object CMakeFiles/app.dir/mult.c.o
[ 83%] Building C object CMakeFiles/app.dir/sub.c.o
[100%] Linking C executable app
[100%] Built target app# 查看可执行程序是否已经生成
$ tree -L 1
.
├── add.c
├── app # 生成的可执行程序
├── CMakeCache.txt
├── CMakeFiles
├── cmake_install.cmake
├── CMakeLists.txt
├── div.c
├── head.h
├── main.c
├── Makefile
├── mult.c
└── sub.c最终可执行程序app就被编译出来了这个名字是在CMakeLists.txt中指定的。
2.2.2 VIP 包房
通过上面的例子可以看出如果在CMakeLists.txt文件所在目录执行了cmake命令之后就会生成一些目录和文件包括 makefile 文件如果再基于makefile文件执行make命令程序在编译过程中还会生成一些中间文件和一个可执行文件这样会导致整个项目目录看起来很混乱不太容易管理和维护此时我们就可以把生成的这些与项目源码无关的文件统一放到一个对应的目录里边比如将这个目录命名为build:
$ mkdir build
$ cd build
$ cmake ..
-- The C compiler identification is GNU 5.4.0
-- The CXX compiler identification is GNU 5.4.0
-- Check for working C compiler: /usr/bin/cc
-- Check for working C compiler: /usr/bin/cc -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Detecting C compile features
-- Detecting C compile features - done
-- Check for working CXX compiler: /usr/bin/c
-- Check for working CXX compiler: /usr/bin/c -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Configuring done
-- Generating done
-- Build files have been written to: /home/robin/Linux/build现在cmake命令是在build目录中执行的但是CMakeLists.txt文件是build目录的上一级目录中所以cmake 命令后指定的路径为…即当前目录的上一级目录。
当命令执行完毕之后在build目录中会生成一个makefile文件
$ tree build -L 1
build
├── CMakeCache.txt
├── CMakeFiles
├── cmake_install.cmake
└── Makefile1 directory, 3 files这样就可以在build目录中执行make命令编译项目生成的相关文件自然也就被存储到build目录中了。这样通过cmake和make生成的所有文件就全部和项目源文件隔离开了各回各家各找各妈。
2.3 私人订制
2.3.1 定义变量
在上面的例子中一共提供了5个源文件假设这五个源文件需要反复被使用每次都直接将它们的名字写出来确实是很麻烦此时我们就需要定义一个变量将文件名对应的字符串存储起来在cmake里定义变量需要使用set。
# SET 指令的语法是
# [] 中的参数为可选项, 如不需要可以不写
SET(VAR [VALUE] [CACHE TYPE DOCSTRING [FORCE]])VAR变量名VALUE变量值
# 方式1: 各个源文件之间使用空格间隔
# set(SRC_LIST add.c div.c main.c mult.c sub.c)# 方式2: 各个源文件之间使用分号 ; 间隔
set(SRC_LIST add.c;div.c;main.c;mult.c;sub.c)
add_executable(app ${SRC_LIST})2.3.2 指定使用的C标准
在编写C程序的时候可能会用到C11、C14、C17、C20等新特性那么就需要在编译的时候在编译命令中制定出要使用哪个标准
$ g *.cpp -stdc11 -o app上面的例子中通过参数-stdc11指定出要使用c11标准编译程序C标准对应有一宏叫做DCMAKE_CXX_STANDARD。在CMake中想要指定C标准有两种方式
1、在 CMakeLists.txt 中通过 set 命令指定
#增加-stdc11
set(CMAKE_CXX_STANDARD 11)
#增加-stdc14
set(CMAKE_CXX_STANDARD 14)
#增加-stdc17
set(CMAKE_CXX_STANDARD 17)2、在执行 cmake 命令的时候指定出这个宏的值
#增加-stdc11
cmake CMakeLists.txt文件路径 -DCMAKE_CXX_STANDARD11
#增加-stdc14
cmake CMakeLists.txt文件路径 -DCMAKE_CXX_STANDARD14
#增加-stdc17
cmake CMakeLists.txt文件路径 -DCMAKE_CXX_STANDARD17在上面例子中 CMake 后的路径需要根据实际情况酌情修改。
2.3.3 指定输出的路径
在CMake中指定可执行程序输出的路径也对应一个宏叫做EXECUTABLE_OUTPUT_PATH它的值还是通过set命令进行设置:
set(HOME /home/robin/Linux/Sort)
set(EXECUTABLE_OUTPUT_PATH ${HOME}/bin)第一行定义一个变量用于存储一个绝对路径第二行将拼接好的路径值设置给EXECUTABLE_OUTPUT_PATH宏 如果这个路径中的子目录不存在会自动生成无需自己手动创建
由于可执行程序是基于 cmake 命令生成的 makefile 文件然后再执行 make 命令得到的所以如果此处指定可执行程序生成路径的时候使用的是相对路径 ./xxx/xxx那么这个路径中的 ./ 对应的就是 makefile 文件所在的那个目录。
2.4 搜索文件
如果一个项目里边的源文件很多在编写CMakeLists.txt文件的时候不可能将项目目录的各个文件一一罗列出来这样太麻烦也不现实。所以在CMake中为我们提供了搜索文件的命令可以使用aux_source_directory命令或者file命令。
2.4.1 方式1
在 CMake 中使用aux_source_directory 命令可以查找某个路径下的所有源文件命令格式为
aux_source_directory( dir variable )dir要搜索的目录variable将从dir目录下搜索到的源文件列表存储到该变量中
cmake_minimum_required(VERSION 3.0)
project(CALC)
include_directories(${PROJECT_SOURCE_DIR}/include)
# 搜索 src 目录下的源文件
aux_source_directory(${CMAKE_CURRENT_SOURCE_DIR}/src SRC_LIST)
add_executable(app ${SRC_LIST})2.4.2 方式2
如果一个项目里边的源文件很多在编写CMakeLists.txt文件的时候不可能将项目目录的各个文件一一罗列出来这样太麻烦了。所以在CMake中为我们提供了搜索文件的命令他就是file当然除了搜索以外通过 file 还可以做其他事情。
file(GLOB/GLOB_RECURSE 变量名 要搜索的文件路径和文件类型)GLOB: 将指定目录下搜索到的满足条件的所有文件名生成一个列表并将其存储到变量中。GLOB_RECURSE递归搜索指定目录将搜索到的满足条件的文件名生成一个列表并将其存储到变量中。
搜索当前目录的src目录下所有的源文件并存储到变量中
file(GLOB MAIN_SRC ${CMAKE_CURRENT_SOURCE_DIR}/src/*.cpp)
file(GLOB MAIN_HEAD ${CMAKE_CURRENT_SOURCE_DIR}/include/*.h)CMAKE_CURRENT_SOURCE_DIR 宏表示当前访问的 CMakeLists.txt文件所在的路径。 关于要搜索的文件路径和类型可加双引号也可不加:
file(GLOB MAIN_HEAD ${CMAKE_CURRENT_SOURCE_DIR}/src/*.h)2.5 包含头文件
在编译项目源文件的时候很多时候都需要将源文件对应的头文件路径指定出来这样才能保证在编译过程中编译器能够找到这些头文件并顺利通过编译。在CMake中设置要包含的目录也很简单通过一个命令就可以搞定了他就是include_directories:
include_directories(headpath)举例说明有源文件若干其目录结构如下
$ tree
.
├── build
├── CMakeLists.txt
├── include
│ └── head.h
└── src├── add.cpp├── div.cpp├── main.cpp├── mult.cpp└── sub.cpp3 directories, 7 filesCMakeLists.txt文件内容如下:
cmake_minimum_required(VERSION 3.0)
project(CALC)
set(CMAKE_CXX_STANDARD 11)
set(HOME /home/robin/Linux/calc)
set(EXECUTABLE_OUTPUT_PATH ${HOME}/bin/)
include_directories(${PROJECT_SOURCE_DIR}/include)
file(GLOB SRC_LIST ${CMAKE_CURRENT_SOURCE_DIR}/src/*.cpp)
add_executable(app ${SRC_LIST})其中第六行指定就是头文件的路径PROJECT_SOURCE_DIR宏对应的值就是我们在使用cmake命令时后面紧跟的目录一般是工程的根目录。
2.6 制作动态库或静态库
有些时候我们编写的源代码并不需要将他们编译生成可执行程序而是生成一些静态库或动态库提供给第三方使用下面来讲解在cmake中生成这两类库文件的方法。
2.6.1 制作静态库
在cmake中如果要制作静态库需要使用的命令如下
add_library(库名称 STATIC 源文件1 [源文件2] ...) 在Linux中静态库名字分为三部分lib库名字.a此处只需要指定出库的名字就可以了另外两部分在生成该文件的时候会自动填充。
在Windows中虽然库名和Linux格式不同但也只需指定出名字即可。
下面有一个目录需要将src目录中的源文件编译成静态库然后再使用
.
├── build
├── CMakeLists.txt
├── include # 头文件目录
│ └── head.h
├── main.cpp # 用于测试的源文件
└── src # 源文件目录├── add.cpp├── div.cpp├── mult.cpp└── sub.cpp根据上面的目录结构可以这样编写CMakeLists.txt文件:
cmake_minimum_required(VERSION 3.0)
project(CALC)
include_directories(${PROJECT_SOURCE_DIR}/include)
file(GLOB SRC_LIST ${CMAKE_CURRENT_SOURCE_DIR}/src/*.cpp)
add_library(calc STATIC ${SRC_LIST})这样最终就会生成对应的静态库文件libcalc.a。
2.6.2 制作动态库
在cmake中如果要制作动态库需要使用的命令如下
add_library(库名称 SHARED 源文件1 [源文件2] ...) 在Linux中动态库名字分为三部分lib库名字.so此处只需要指定出库的名字就可以了另外两部分在生成该文件的时候会自动填充。
在Windows中虽然库名和Linux格式不同但也只需指定出名字即可。
根据上面的目录结构可以这样编写CMakeLists.txt文件:
cmake_minimum_required(VERSION 3.0)
project(CALC)
include_directories(${PROJECT_SOURCE_DIR}/include)
file(GLOB SRC_LIST ${CMAKE_CURRENT_SOURCE_DIR}/src/*.cpp)
add_library(calc SHARED ${SRC_LIST})这样最终就会生成对应的动态库文件libcalc.so。
2.6.3 指定输出的路径
方式1 - 适用于动态库
对于生成的库文件来说和可执行程序一样都可以指定输出路径。由于在Linux下生成的动态库默认是有执行权限的所以可以按照生成可执行程序的方式去指定它生成的目录
cmake_minimum_required(VERSION 3.0)
project(CALC)
include_directories(${PROJECT_SOURCE_DIR}/include)
file(GLOB SRC_LIST ${CMAKE_CURRENT_SOURCE_DIR}/src/*.cpp)
# 设置动态库生成路径
set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/lib)
add_library(calc SHARED ${SRC_LIST})对于这种方式来说其实就是通过set命令给EXECUTABLE_OUTPUT_PATH宏设置了一个路径这个路径就是可执行文件生成的路径。
方式2 - 都适用
由于在Linux下生成的静态库默认不具有可执行权限所以在指定静态库生成的路径的时候就不能使用EXECUTABLE_OUTPUT_PATH宏了而应该使用LIBRARY_OUTPUT_PATH这个宏对应静态库文件和动态库文件都适用。
cmake_minimum_required(VERSION 3.0)
project(CALC)
include_directories(${PROJECT_SOURCE_DIR}/include)
file(GLOB SRC_LIST ${CMAKE_CURRENT_SOURCE_DIR}/src/*.cpp)
# 设置动态库/静态库生成路径
set(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/lib)
# 生成动态库
#add_library(calc SHARED ${SRC_LIST})
# 生成静态库
add_library(calc STATIC ${SRC_LIST})2.7 包含库文件
在编写程序的过程中可能会用到一些系统提供的动态库或者自己制作出的动态库或者静态库文件cmake中也为我们提供了相关的加载动态库的命令。
2.7.1 链接静态库
src
├── add.cpp
├── div.cpp
├── main.cpp
├── mult.cpp
└── sub.cpp现在我们把上面src目录中的add.cpp、div.cpp、mult.cpp、sub.cpp编译成一个静态库文件libcalc.a。通过命令制作并使用静态链接库
测试目录结构如下
$ tree
.
├── build
├── CMakeLists.txt
├── include
│ └── head.h
├── lib
│ └── libcalc.a # 制作出的静态库的名字
└── src└── main.cpp4 directories, 4 files在cmake中链接静态库的命令如下
link_libraries(static lib [static lib...])用于设置全局链接库这些库会链接到之后定义的所有目标上。
参数1指定出要链接的静态库的名字 可以是全名 libxxx.a也可以是掐头lib去尾.a之后的名字 xxx 参数2-N要链接的其它静态库的名字
如果该静态库不是系统提供的自己制作或者使用第三方提供的静态库可能出现静态库找不到的情况此时可以将静态库的路径也指定出来
link_directories(lib path)这样修改之后的CMakeLists.txt文件内容如下:
cmake_minimum_required(VERSION 3.0)
project(CALC)
# 搜索指定目录下源文件
file(GLOB SRC_LIST ${CMAKE_CURRENT_SOURCE_DIR}/src/*.cpp)
# 包含头文件路径
include_directories(${PROJECT_SOURCE_DIR}/include)
# 包含静态库路径
link_directories(${PROJECT_SOURCE_DIR}/lib)
# 链接静态库
link_libraries(calc)
add_executable(app ${SRC_LIST})添加了第8行的代码就可以根据参数指定的路径找到这个静态库了。
2.7.2 链接动态库
在程序编写过程中除了在项目中引入静态库好多时候也会使用一些标准的或者第三方提供的一些动态库关于动态库的制作、使用以及在内存中的加载方式和静态库都是不同的在此不再过多赘述如有疑惑请参考Linux 静态库和动态库
在cmake中链接动态库的命令如下:
target_link_libraries(target PRIVATE|PUBLIC|INTERFACE item... [PRIVATE|PUBLIC|INTERFACE item...]...)用于指定一个目标如可执行文件或库在编译时需要链接哪些库。它支持指定库的名称、路径以及链接库的顺序。 target指定要加载的库的文件的名字 该文件可能是一个源文件该文件可能是一个动态库/静态库文件该文件可能是一个可执行文件 PRIVATE|PUBLIC|INTERFACE动态库的访问权限默认为PUBLIC 如果各个动态库之间没有依赖关系无需做任何设置三者没有没有区别一般无需指定使用默认的 PUBLIC 即可。 动态库的链接具有传递性如果动态库 A 链接了动态库B、C动态库D链接了动态库A此时动态库D相当于也链接了动态库B、C并可以使用动态库B、C中定义的方法。
target_link_libraries(A B C)
target_link_libraries(D A)PUBLIC在public后面的库会被Link到前面的target中并且里面的符号也会被导出提供给第三方使用。PRIVATE在private后面的库仅被link到前面的target中并且终结掉第三方不能感知你调了啥库INTERFACE在interface后面引入的库不会被链接到前面的target中只会导出符号。
2.7.3链接系统动态库
动态库的链接和静态库是完全不同的
静态库会在生成可执行程序的链接阶段被打包到可执行程序中所以可执行程序启动静态库就被加载到内存中了。动态库在生成可执行程序的链接阶段不会被打包到可执行程序中当可执行程序被启动并且调用了动态库中的函数的时候动态库才会被加载到内存
因此在cmake中指定要链接的动态库的时候应该将命令写到生成了可执行文件之后
cmake_minimum_required(VERSION 3.0)
project(TEST)
file(GLOB SRC_LIST ${CMAKE_CURRENT_SOURCE_DIR}/*.cpp)
# 添加并指定最终生成的可执行程序名
add_executable(app ${SRC_LIST})
# 指定可执行程序要链接的动态库名字
target_link_libraries(app pthread)在target_link_libraries(app pthread)中
app: 对应的是最终生成的可执行程序的名字pthread这是可执行程序要加载的动态库这个库是系统提供的线程库全名为libpthread.so在指定的时候一般会掐头lib去尾.so。
2.7.4 链接第三方动态库
现在自己生成了一个动态库对应的目录结构如下
$ tree
.
├── build
├── CMakeLists.txt
├── include
│ └── head.h # 动态库对应的头文件
├── lib
│ └── libcalc.so # 自己制作的动态库文件
└── main.cpp # 测试用的源文件3 directories, 4 files假设在测试文件main.cpp中既使用了自己制作的动态库libcalc.so又使用了系统提供的线程库此时CMakeLists.txt文件可以这样写
cmake_minimum_required(VERSION 3.0)
project(TEST)
file(GLOB SRC_LIST ${CMAKE_CURRENT_SOURCE_DIR}/*.cpp)
include_directories(${PROJECT_SOURCE_DIR}/include)
add_executable(app ${SRC_LIST})
target_link_libraries(app pthread calc)在第六行中pthread、calc都是可执行程序app要链接的动态库的名字。当可执行程序app生成之后并执行该文件会提示有如下错误信息
$ ./app
./app: error while loading shared libraries: libcalc.so: cannot open shared object file: No such file or directory这是因为可执行程序启动之后去加载calc这个动态库但是不知道这个动态库被放到了什么位置解决动态库无法加载的问题所以就加载失败了在 CMake 中可以在生成可执行程序之前通过命令指定出要链接的动态库的位置指定静态库位置使用的也是这个命令
link_directories(path)所以修改之后的CMakeLists.txt文件应该是这样的
cmake_minimum_required(VERSION 3.0)
project(TEST)
file(GLOB SRC_LIST ${CMAKE_CURRENT_SOURCE_DIR}/*.cpp)
# 指定源文件或者动态库对应的头文件路径
include_directories(${PROJECT_SOURCE_DIR}/include)
# 指定要链接的动态库的路径
link_directories(${PROJECT_SOURCE_DIR}/lib)
# 添加并生成一个可执行程序
add_executable(app ${SRC_LIST})
# 指定要链接的动态库
target_link_libraries(app pthread calc)通过link_directories指定了动态库的路径之后在执行生成的可执行程序的时候就不会出现找不到动态库的问题了。
2.7.5 总结
温馨提示target_link_libraries 和 link_libraries 是 CMake 中用于链接库的两个命令都可以用于链接动态库和静态库但它们的使用场景和功能有所不同。下面是关于二者的总结
1、target_link_libraries 功能: target_link_libraries 用于指定一个目标如可执行文件或库在编译时需要链接哪些库。它支持指定库的名称、路径以及链接库的顺序。 语法:
target_link_libraries(target_name [item1 [item2 [...]]][debug|optimized|general lib1 [lib2 [...]]])优点: 更精确地控制目标的链接库。可以指定库的不同链接条件如调试版本、发布版本。支持多个目标和多个库之间的复杂关系。更加灵活和易于维护特别是在大型项目中。 示例:
add_executable(my_executable main.cpp)
target_link_libraries(my_executable PRIVATE my_dynamic_library)2、link_libraries 功能: link_libraries 用于设置全局链接库这些库会链接到之后定义的所有目标上。它会影响所有的目标适用于全局设置但不如 target_link_libraries 精确。 语法:
link_libraries(lib1 lib2 [...])缺点: 缺乏针对具体目标的控制不适合复杂的项目结构。容易导致意外的依赖关系因为它对所有目标都生效。一旦设置全局影响可能导致难以追踪的链接问题。 示例:
link_libraries(my_static_library)
add_executable(my_executable main.cpp)3、总结
target_link_libraries 是更推荐的方式因为它允许更精确的控制和管理链接库的依赖特别是在大型项目中它能够避免全局设置可能带来的问题。 link_libraries 虽然简单但在复杂的项目中可能会导致意外的问题通常适用于简单的项目或临时设置。 建议在 CMake 项目中优先使用 target_link_libraries。
2.8 日志
在CMake中可以用用户显示一条消息该命令的名字为message
message([STATUS|WARNING|AUTHOR_WARNING|FATAL_ERROR|SEND_ERROR] message to display ...)(无) 重要消息STATUS 非重要消息WARNINGCMake 警告, 会继续执行AUTHOR_WARNINGCMake 警告 (dev), 会继续执行SEND_ERRORCMake 错误, 继续执行但是会跳过生成的步骤FATAL_ERRORCMake 错误, 终止所有处理过程 CMake的命令行工具会在stdout上显示STATUS消息在stderr上显示其他所有消息。CMake的GUI会在它的log区域显示所有消息。
CMake警告和错误消息的文本显示使用的是一种简单的标记语言。文本没有缩进超过长度的行会回卷段落之间以新行做为分隔符。
# 输出一般日志信息
message(STATUS source path: ${PROJECT_SOURCE_DIR})
# 输出警告信息
message(WARNING source path: ${PROJECT_SOURCE_DIR})
# 输出错误信息
message(FATAL_ERROR source path: ${PROJECT_SOURCE_DIR})2.9 变量操作
2.9.1 追加
有时候项目中的源文件并不一定都在同一个目录中但是这些源文件最终却需要一起进行编译来生成最终的可执行文件或者库文件。如果我们通过file命令对各个目录下的源文件进行搜索最后还需要做一个字符串拼接的操作关于字符串拼接可以使用set命令也可以使用list命令。
1、使用set拼接 如果使用set进行字符串拼接对应的命令格式如下
set(变量名1 ${变量名1} ${变量名2} ...)关于上面的命令其实就是将从第二个参数开始往后所有的字符串进行拼接最后将结果存储到第一个参数中如果第一个参数中原来有数据会对原数据就行覆盖。
cmake_minimum_required(VERSION 3.0)
project(TEST)
set(TEMP hello,world)
file(GLOB SRC_1 ${PROJECT_SOURCE_DIR}/src1/*.cpp)
file(GLOB SRC_2 ${PROJECT_SOURCE_DIR}/src2/*.cpp)
# 追加(拼接)
set(SRC_1 ${SRC_1} ${SRC_2} ${TEMP})
message(STATUS message: ${SRC_1})2、使用list拼接 如果使用list进行字符串拼接对应的命令格式如下
list(APPEND list [element ...])list命令的功能比set要强大字符串拼接只是它的其中一个功能所以需要在它第一个参数的位置指定出我们要做的操作APPEND表示进行数据追加后边的参数和set就一样了。
cmake_minimum_required(VERSION 3.0)
project(TEST)
set(TEMP hello,world)
file(GLOB SRC_1 ${PROJECT_SOURCE_DIR}/src1/*.cpp)
file(GLOB SRC_2 ${PROJECT_SOURCE_DIR}/src2/*.cpp)
# 追加(拼接)
list(APPEND SRC_1 ${SRC_1} ${SRC_2} ${TEMP})
message(STATUS message: ${SRC_1})在CMake中使用set命令可以创建一个list。一个在list内部是一个由分号;分割的一组字符串。例如set(var a b c d e)命令将会创建一个list:a;b;c;d;e但是最终打印变量值的时候得到的是abcde。
set(tmp1 a;b;c;d;e)
set(tmp2 a b c d e)
message(${tmp1})
message(${tmp2})输出的结果:
abcde
abcde2.9.2 字符串移除
我们在通过file搜索某个目录就得到了该目录下所有的源文件但是其中有些源文件并不是我们所需要的比如
$ tree
.
├── add.cpp
├── div.cpp
├── main.cpp
├── mult.cpp
└── sub.cpp0 directories, 5 files在当前这么目录有五个源文件其中main.cpp是一个测试文件。如果我们想要把计算器相关的源文件生成一个动态库给别人使用那么只需要add.cpp、div.cp、mult.cpp、sub.cpp这四个源文件就可以了。此时就需要将main.cpp从搜索到的数据中剔除出去想要实现这个功能也可以使用list
list(REMOVE_ITEM list value [value ...])通过上面的命令原型可以看到删除和追加数据类似只不过是第一个参数变成了REMOVE_ITEM。
cmake_minimum_required(VERSION 3.0)
project(TEST)
set(TEMP hello,world)
file(GLOB SRC_1 ${PROJECT_SOURCE_DIR}/*.cpp)
# 移除前日志
message(STATUS message: ${SRC_1})
# 移除 main.cpp
list(REMOVE_ITEM SRC_1 ${PROJECT_SOURCE_DIR}/main.cpp)
# 移除后日志
message(STATUS message: ${SRC_1})可以看到在第8行把将要移除的文件的名字指定给list就可以了。但是一定要注意通过 file 命令搜索源文件的时候得到的是文件的绝对路径在list中每个文件对应的路径都是一个item并且都是绝对路径那么在移除的时候也要将该文件的绝对路径指定出来才可以否是移除操作不会成功。
关于list命令还有其它功能但是并不常用在此就不一一进行举例介绍了。
1、获取 list 的长度。
list(LENGTH list output variable)LENGTH子命令LENGTH用于读取列表长度list当前操作的列表output variable新创建的变量用于存储列表的长度。
2、读取列表中指定索引的的元素可以指定多个索引
list(GET list element index [element index ...] output variable)list当前操作的列表 element index列表元素的索引 从0开始编号索引0的元素为列表中的第一个元素索引也可以是负数-1表示列表的最后一个元素-2表示列表倒数第二个元素以此类推当索引不管是正还是负超过列表的长度运行会报错 output variable新创建的变量存储指定索引元素的返回结果也是一个列表。
3、将列表中的元素用连接符字符串连接起来组成一个字符串
list (JOIN list glue output variable)list当前操作的列表glue指定的连接符字符串output variable新创建的变量存储返回的字符串
4、查找列表是否存在指定的元素若果未找到返回-1
list(FIND list value output variable)list当前操作的列表value需要再列表中搜索的元素output variable新创建的变量 如果列表中存在那么返回在列表中的索引如果未找到则返回-1。
5、将元素追加到列表中
list (APPEND list [element ...])6、在list中指定的位置插入若干元素
list(INSERT list element_index element [element ...])7、将元素插入到列表的0索引位置
list (PREPEND list [element ...])8、将列表中最后元素移除
list (POP_BACK list [out-var...])9、将列表中第一个元素移除
list (POP_FRONT list [out-var...])10、将指定的元素从列表中移除
list (REMOVE_ITEM list value [value ...])11、将指定索引的元素从列表中移除
list (REMOVE_AT list index [index ...])12、移除列表中的重复元素
list (REMOVE_DUPLICATES list)13、列表翻转
list(REVERSE list)14、列表排序
list (SORT list [COMPARE compare] [CASE case] [ORDER order])COMPARE指定排序方法。有如下几种值可选 STRING:按照字母顺序进行排序为默认的排序方法FILE_BASENAME如果是一系列路径名会使用basename进行排序NATURAL使用自然数顺序排序 CASE指明是否大小写敏感。有如下几种值可选 SENSITIVE: 按照大小写敏感的方式进行排序为默认值INSENSITIVE按照大小写不敏感方式进行排序 ORDER指明排序的顺序。有如下几种值可选 ASCENDING:按照升序排列为默认值DESCENDING按照降序排列
2.10 宏定义
在进行程序测试的时候我们可以在代码中添加一些宏定义通过这些宏来控制这些代码是否生效如下所示
#include stdio.h
#define NUMBER 3int main()
{int a 10;
#ifdef DEBUGprintf(我是一个程序猿, 我不会爬树...\n);
#endiffor(int i0; iNUMBER; i){printf(hello, GCC!!!\n);}return 0;
}在程序的第七行对DEBUG宏进行了判断如果该宏被定义了那么第八行就会进行日志输出如果没有定义这个宏第八行就相当于被注释掉了因此最终无法看到日志输入出上述代码中并没有定义这个宏。
为了让测试更灵活我们可以不在代码中定义这个宏而是在测试的时候去把它定义出来其中一种方式就是在gcc/g命令中去指定如下
$ gcc test.c -DDEBUG -o app在gcc/g命令中通过参数 -D指定出要定义的宏的名字这样就相当于在代码中定义了一个宏其名字为DEBUG。
在CMake中我们也可以做类似的事情对应的命令叫做add_definitions:
add_definitions(-D宏名称)针对于上面的源文件编写一个CMakeLists.txt内容如下
cmake_minimum_required(VERSION 3.0)
project(TEST)
# 自定义 DEBUG 宏
add_definitions(-DDEBUG)
add_executable(app ./test.c)通过这种方式上述代码中的第八行日志就能够被输出出来了。
3. 预定义宏
下面的列表中为大家整理了一些CMake中常用的宏
宏功能PROJECT_SOURCE_DIR使用cmake命令后紧跟的目录一般是工程的根目录PROJECT_BINARY_DIR执行cmake命令的目录CMAKE_CURRENT_SOURCE_DIR当前处理的CMakeLists.txt所在的路径CMAKE_CURRENT_BINARY_DIRtarget 编译目录EXECUTABLE_OUTPUT_PATH重新定义目标二进制可执行文件的存放位置LIBRARY_OUTPUT_PATH重新定义目标链接库文件的存放位置PROJECT_NAME返回通过PROJECT指令定义的项目名称CMAKE_BINARY_DIR项目实际构建路径假设在build目录进行的构建那么得到的就是这个目录的路径
