以一个实例说明 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

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