CMake处理多源文件目录及查找并使用其他程序库的方法
来源:互联网 发布:name.com域名备案 编辑:程序博客网 时间:2024/06/05 00:54
CMake 简介
CMake 是一个跨平台的自动化建构系统,它使用一个名为 CMakeLists.txt 的文件来描述构建过程,可以产生标准的构建文件,如 Unix 的 Makefile 或Windows Visual C++ 的 projects/workspaces 。文件 CMakeLists.txt 需要手工编写,也可以通过编写脚本进行半自动的生成。CMake 提供了比 autoconfig 更简洁的语法。在 linux 平台下使用 CMake 生成 Makefile 并编译的流程如下:
编写
CmakeLists.txt
。
执行命令
“
cmake PATH
”
或者
“
ccmake PATH
”
生成
Makefile ( PATH
是
CMakeLists.txt
所在的目录
)
。
使用
make
命令进行编译。
第一个工程
第一个工程
现假设我们的项目中只有一
个源文件
main.cpp
清单 1 源文件 main.cpp
清单 1 源文件 main.cpp
1 #include<
iostream
>
2
3 int main()
4 {
5 std::cout<<"Hello word!"<<std::endl;
6 return 0;
7 }
为了构建该项目,我们需要编写文件 CMakeLists.txt 并将其与 main.cpp 放在 同一个目录下:
清单 2 CMakeLists.txt
1 PROJECT(main)
2 CMAKE_MINIMUM_REQUIRED(VERSION 2.6)
3 AUX_SOURCE_DIRECTORY(. DIR_SRCS)
4 ADD_EXECUTABLE(main ${DIR_SRCS})
CMakeLists.txt 的语法比较简单,由命令、注释和空格组成,其中命令是不区分大小写的,符号"#"后面的内容被认为是注释。命令由命令名称、小括号和参数组成,参数之间使用空格进行间隔。例如对于清单2的 CMakeLists.txt 文件:第一行是一条命令,名称是 PROJECT ,参数是 main ,该命令表示项目的名称是 main 。第二行的命令限定了 CMake 的版本。第三行使用命令 AUX_SOURCE_DIRECTORY 将当前目录中的源文件名称赋值给变量 DIR_SRCS 。 CMake 手册中对命令 AUX_SOURCE_DIRECTORY 的描述如下:
aux_source_directory(<
dir
> <
variable
>)
该命令会把参数 <dir> 中所有的源文件名称赋值给参数 <variable> 。 第四行使用命令 ADD_EXECUTABLE 指示变量 DIR_SRCS 中的源文件需要编译 成一个名称为 main 的可执行文件。
完成了文件 CMakeLists.txt 的编写后需要使用 cmake 或 ccmake 命令生成Makefile 。 ccmake 与命令 cmake 的不同之处在于 ccmake 提供了一个图形化的操作界面。cmake 命令的执行方式如下:
cmake [options] <
path-to-source
>
这里我们进入了 main.cpp 所在的目录后执行 “cmake .” 后就可以得到 Makefile 并使用 make 进行编译,如下图所示。
图 1. camke 的运行结果
处理多源文件目录的方法
CMake
处理源代码分
布在不同目录中的情况也十分简单。现假设我们的源代码分布情况如下
:
图 2. 源代码分布情况
其中 src 目录下的文件要编译成一个链接库。
第一步,项目主目录中的 CMakeLists.txt
在目录 step2 中创建文件 CMakeLists.txt 。文件内容如下:
清单 3 目录 step2 中的 CMakeLists.txt
1 PROJECT(main)
2 CMAKE_MINIMUM_REQUIRED(VERSION 2.6)
3 ADD_SUBDIRECTORY( src )
4 AUX_SOURCE_DIRECTORY(. DIR_SRCS)
5 ADD_EXECUTABLE(main ${DIR_SRCS} )
6 TARGET_LINK_LIBRARIES( main Test )
相对于清单 2,该文件添加了下面的内容: 第三行,使用命令 ADD_SUBDIRECTORY 指明本项目包含一个子目录 src 。第六行,使用命令 TARGET_LINK_LIBRARIES 指明可执行文件 main 需要连接一个名为Test的链接库 。
第二步,子目录中的 CmakeLists.txt
在子目录 src 中创建 CmakeLists.txt。文件内容如下:
清单 4. 目录 src 中的 CmakeLists.txt
1 AUX_SOURCE_DIRECTORY(. DIR_TEST1_SRCS)
2 ADD_LIBRARY ( Test ${DIR_TEST1_SRCS})
在该文件中使用命令 ADD_LIBRARY 将 src 目录中的源文件编译为共享库。
第三步,执行 cmake
至此我们完成了项目中所有 CMakeLists.txt 文件的编写,进入目录 step2 中依次执行命令 “cmake .” 和 “make” 得到结果如下:
图3. 处理多源文件目录时 cmake 的执行结果
在执行 cmake 的过程中,首先解析目录 step2 中的 CMakeLists.txt ,当程序执行命令 ADD_SUBDIRECTORY( src ) 时进入目录 src 对其中的 CMakeLists.txt 进行解析。
在工程中查找并使用其他程序库的方法
在开发软件的时候我们会用到一些函数库,这些函数库在不同的系统中安装的位置可能不同,编译的时候需要首先找到这些软件包的头文件以及链接库所在的目录以便生成编译选项。例如一个需要使用博克利数据库项目,需要头文件db_cxx.h 和链接库 libdb_cxx.so ,现在该项目中有一个源代码文件 main.cpp ,放在项目的根目录中。
第一步,程序库说明文件
在项目的根目录中创建目录 cmake/modules/ ,在 cmake/modules/ 下创建文件 Findlibdb_cxx.cmake ,内容如下:
清单 5. 文件 Findlibdb_cxx.cmake
01 MESSAGE(STATUS "Using bundled Findlibdb.cmake...")
0203 FIND_PATH(
04 LIBDB_CXX_INCLUDE_DIR
05 db_cxx.h
06 /usr/include/
07 /usr/local/include/
08 )
09
10 FIND_LIBRARY(
11 LIBDB_CXX_LIBRARIES NAMES db_cxx
12 PATHS /usr/lib/ /usr/local/lib/
13 )
文件 Findlibdb_cxx.cmake 的命名要符合规范: FindlibNAME.cmake ,其中NAME 是函数库的名称。Findlibdb_cxx.cmake 的语法与 CMakeLists.txt 相同。这里使用了三个命令: MESSAGE , FIND_PATH 和 FIND_LIBRARY 。
命令
MESSAGE
会
将参数
的内容
输出到终端
。
命令
FIND_PATH
指明头文件查找的路径,
原型如下
:
find_path(<VAR> name1 [path1 path2 ...])该命令在参数
path*
指示的目录中查找文件
name1
并将查找到的路径保存在变量
VAR
中。清单
5
第
3
-
8
行的意思是在
/usr/include/
和
/usr/local/include/
中查找文件
db_cxx.h ,
并将
db_cxx.h
所在的路径保存在
LIBDB_CXX_INCLUDE_DIR
中。
命令
FIND_LIBRARY
同
FIND_PATH
类似
,
用于查找链接库并将结果保存在变量中。清单
5
第
10
-
13
行的意思是在目录
/usr/lib/
和
/usr/local/lib/
中寻找名称为
db_cxx
的链接库
,
并将结果保存在
LIBDB_CXX_LIBRARIES
。
第二步, 项目的根目录中的 CmakeList.txt
第二步, 项目的根目录中的 CmakeList.txt
在项目的根目录中创建 CmakeList.txt :
清单 6. 可以查找链接库的 CMakeList.txt
清单 6. 可以查找链接库的 CMakeList.txt
01 PROJECT(main)
02 CMAKE_MINIMUM_REQUIRED(VERSION 2.6)
03 SET(CMAKE_SOURCE_DIR .)
04 SET(CMAKE_MODULE_PATH ${CMAKE_ROOT}/Modules ${CMAKE_SOURCE_DIR}/cmake/modules)
05 AUX_SOURCE_DIRECTORY(. DIR_SRCS)
06 ADD_EXECUTABLE(main ${DIR_SRCS})
0708 FIND_PACKAGE( libdb_cxx REQUIRED)
09 MARK_AS_ADVANCED(
10 LIBDB_CXX_INCLUDE_DIR
11 LIBDB_CXX_LIBRARIES
12 )
13 IF (LIBDB_CXX_INCLUDE_DIR AND LIBDB_CXX_LIBRARIES)
14 MESSAGE(STATUS "Found libdb libraries")
15 INCLUDE_DIRECTORIES(${LIBDB_CXX_INCLUDE_DIR})
16 MESSAGE( ${LIBDB_CXX_LIBRARIES} )
17 TARGET_LINK_LIBRARIES(main ${LIBDB_CXX_LIBRARIES}18 )
19 ENDIF (LIBDB_CXX_INCLUDE_DIR AND LIBDB_CXX_LIBRARIES)
在该文件中第4行表示到目录 ./cmake/modules 中查找 Findlibdb_cxx.cmake ,8-19 行表示查找链接库和头文件的过程。第8行使用命令 FIND_PACKAGE 进行查找,这条命令执行后 CMake 会到变量 CMAKE_MODULE_PATH 指示的目录中查找文件 Findlibdb_cxx.cmake 并执行。第13-19行是条件判断语句,表示如果 LIBDB_CXX_INCLUDE_DIR 和 LIBDB_CXX_LIBRARIES 都已经被赋值,则设置编译时到 LIBDB_CXX_INCLUDE_DIR 寻找头文件并且设置可执行文件 main 需要与链接库 LIBDB_CXX_LIBRARIES 进行连接。
第三步,执行 cmake
完成 Findlibdb_cxx.cmake 和 CMakeList.txt 的编写后在项目的根目录依次执行 “cmake . ” 和 “make ” 可以进行编译,结果如下图所示:
图 4. 使用其他程序库时 cmake 的执行结果
来源:https://www.ibm.com/developerworks/cn/linux/l-cn-cmake/
- CMake处理多源文件目录及查找并使用其他程序库的方法
- Cmake中查找并使用其他程序库
- cmake中查找并使用其他程序库
- cmake处理多源文件目录的方法
- 使用Cmake生成CEF的项目源文件,并在VS2015中编译通过
- 编写并使用程序库
- 了解mysql的源码目录及源文件
- vs2012下使用相对路径添加其他目录的方法
- word崩溃 源文件找不到的处理方法
- 效率: 条款23 考虑使用其他程序库
- 条款二十三:使用其他程序库
- cmake将代码安装至其他目录
- javac编译带有多个目录层次的java源文件的方法
- Cmake管理工程时如何使用外部程序库
- [CMake] CMake的使用
- 使用 coredumpctl 查找并处理 BUG
- Ubuntu14.04下安装最新的Cmake-3.8.2并为其配置环境变量(还介绍了其他三种方法)
- 使用CMake将一个源文件编译成一个可执行的二进制文件
- 万树IT:Java基础知识认识static和设计模式
- cmd命令行编译和运行java程序报错 NoClassDefFoundError
- vmware 扩容
- 关于编译时注解
- Intellij IDEA配置Struts开发环境出现Cannot resolve Struts Package "struts default"
- CMake处理多源文件目录及查找并使用其他程序库的方法
- 计算机网络传输层
- css 不使用定位的 div层叠
- 浅谈Linux中ldconfig和ldd的用法
- 我们团队的pipeline
- MVC 中的 ViewModel
- JAVA基础知识面试题
- Java BitSet 源码解析(1)
- nologging