[forward] cmake, CMakeLists.txt梳理

cmake intro

原文请见 cmake使用总结(转）—工程主目录CMakeList文件编写

在 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)

（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")

ref

https://www.ibm.com/developerworks/cn/linux/l-cn-cmake/