以一个实例说明 CMakeLists.txt 文件的编写


在 Linux 下进行开发很多人选择编写 makefile 文件进行项目环境搭建，而makefile 文件依赖关系复杂，工作量很大。采用自动化的项目构建工具CMake
可以将程序员从复杂的 makefile 文件中解脱出来。CMake
根据内置的规则和语法来自动生成相关的 makefile 文件进行编译，
同时还支持静态库和动态库的构建

具体cmake的介绍和详细语法还是参考官方文档（http://www.cmake.org/）。

使用 cmake 很简单，只需要执行 cmake, make 两个命令即可，考虑如下的项目结构。

假设当前的项目代码在 src 目录。 src 下有如下子目录（subdirectory）：
server —– 存放项目的主功能类文件
utility —– 存放项目要用到相关库文件，便已成为库文件存放到子目录lib 中
lib —– 存放utility 生成的库
bin —– 存放association 生成的二进制文件
build —– 编译目录，存放编译生成的中间文件

cmake 要求工程主目录和所有存放源代码子目录下都要编写CMakeLists.txt 文件，注意大小写.

（1）src/CMakeLists.txt 文件如下：

CMAKE_MINIMUM_REQUIRED(VERSION 2.8)       # CMake 最低版本要求，低于2.6 构建过程会被终止。

PROJECT(server_project)                                             #定义工程名称

MESSAGE(STATUS "Project: SERVER")               # 打印相关消息消息
MESSAGE(STATUS "Project Directory: ${PROJECT_SOURCE_DIR}")

SET(CMAKE_BUILE_TYPE DEBUG)                      # 指定编译类型，debug 或者为 release
# debug 版会生成相关调试信息，可以使用 GDB 进行
# release不会生成调试信息。当无法进行调试时查看此处是否设置为 debug.

SET(CMAKE_C_FLAGS_DEBUG "-g -Wall")          # 指定编译器
# CMAKE_C_FLAGS_DEBUG            ----  C 编译器
# CMAKE_CXX_FLAGS_DEBUG        ----  C++ 编译器
# -g：只是编译器，在编译的时候，产生调试信息。
# -Wall：生成所有警告信息。一下是具体的选项，可以单独使用

ADD_SUBDIRECTORY(utility)                    # 添加子目录
ADD_SUBDIRECTORY(server)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

（2）子目录 Utility 下的 CMakeLists.txt 文件如下

SET(SOURCE_FILES ConfigParser.cpp StrUtility.cpp) # 设置变量，表示所有的源文件

INCLUDE_DIRECTORIES(/usr/local/include ${PROJET_SOURCE_DIR}/utility)
# 相关头文件的目录

LINK_DIRECTORIES(/usr/local/lib)
# 相关库文件的目录

ADD_LIBRARY(association ${SOURCE_FILES})         # 生成静态链接库libassociation.a

TARGET_LINK_LIBRARY(association core）            # 依赖的库文件

SET_TARGET_PROPERTIES(utility  PROPERTIES    # 表示生成的执行文件所在路径
RUNTIME_OUTPUT_DIRECTORY> "${PROJECT_SOURCE_DIR}/lib")

1
2
3
4
5
6
7
8
9
10
11
12
13
14


1
2
3
4
5
6
7
8
9
10
11
12