CMakeList.txt写法

ROS: 创建并运行一个c++的demo_xyzxyz576的博客-CSDN博客

目录

样例

解释如下

1.确定cmake最低版本需求

2.确定工程名

3.添加需要的库

4.添加需要的头文件

5.确定编译语言

6.设定变量

7.添加源代码

8.编译动态库并链接库文件

9.生成可执行文件

10.打印相关消息

 11.设置编译类型

 12.设置编译器的类型

13. 添加要编译的子目录

---

在 linux 下进行开发很多人选择编写makefile 文件进行项目环境搭建，而makefile 文件依赖关系复杂，工作量很大，搞的人头很大。采用自动化的项目构建工具cmake 可以将程序员从复杂的makefile 文件中解脱出来。cmake 根据内置的规则和语法来自动生成相关的makefile 文件进行编译，同时还支持静态库和动态库的构建，我把工作中用到的东东总结在此，方便忘记时随时查看，具体cmake的介绍和详细语法还是参考官方文档 （http://www.cmake.org/），有一篇中文的cmake 实践 写的不错，可以google一下。

     使用cmake 很简单，只需要执行cmake, make 两个命令即可，用我工作中的一个工程举例说明。

样例

假设当前的项目代码在src 目录。 src 下有子目录：server, utility, lib, bin, build

      server -----  存放项目的主功能类文件

      utility  -----  存放项目要用到相关库文件，便已成为库文件存放到子目录lib 中

      lib       -----  存放utility 生成的库

      bin      -----  存放association 生成的二进制文件

      build   -----  编译目录，存放编译生成的中间文件

src/CMakeLists.txt 文件如下：

#cmake file for project association                     #表示注释
#author:>---double__song
#created:>--2011/03/01

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)                      #指定编译类型

SET(CMAKE_C_FLAGS_DEBUG "-g -Wall")          #指定编译器
     
ADD_SUBDIRECTORY(utility)                              #添加子目录
ADD_SUBDIRECTORY(server)

子目录utility 下的CMakeLists.txt 文件如下：

#Cmake file for library utility.a
#Author:       double__song
#Created:     2011/3/3

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_LIBRARIES(association core）                #依赖的库文件

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

子目录server 下的CMakeLists.txt 文件：

SET(SOURCE_FILES
     Gassociation.cpp
     ConfigurationHandler.cpp
     )

INCLUDE_DIRECTORIES（
      /usr/local/include
      ${PROJECT_SOURCE_DIR}/utility
      ${PROJECT_SOURCE_DIR}/association
)

LINK_LIBRARIES(
     /usr/local/lib
     ${PROJECT_SOURCE_DIR}/lib
)

ADD_EXECUTABLE(server  ${SOURCE_FILES})

TARGET_LINK_LIBRARIES(server
     utility
）

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

解释如下

1.确定cmake最低版本需求

cmake_minimum_required(VERSION 3.0.0)

2.确定工程名

project(XXX)

3.添加需要的库

set(CMAKE_PREFIX_PATH ${CMAKE_PREFIX_PATH} "/usr/local/share/OpenCV")
find_package(OpenCV 3.2.0 REQUIRED)

find_package令CMake搜索所有名为Find.cmake的文件，3.2.0 REQUIRED给出需要的具体版本，以避免一台电脑安装了多个版本opencv而造成不必要的错误。通常情况下，通过设置CMAKE_PREFIX_PATH来设置CMake搜索路径，通常情况下不加也可以，但考虑到代码的可移植性，最好还是对搜索路径进行对应设置

4.添加需要的头文件

include_directories(include)
include_directories(${OpenCV_INCLUDE_DIRS})
include_directories(/usr/local/cuda-8.0/include/)

如上，将头文件所在路径写在括号内即可（上例中将头文件放在了include文件夹中），而需要的一些库的头文件可以如2行变量的形式，也可以如3行直接给出库头文件所在的位置

5.确定编译语言

以使用c++为例，可以用set来设定

set(CMAKE_CXX_STANDARD 11)

也可以通过add_definitions来设定

add_definitions(-std=c++11)

可以指定工程采用的语言，选项分别表示：C++, C, java， 如不指定默认支持所有语言 

6.设定变量

ADD_DEFINITIONS( -DGPU -DCUDNN )

如darknet中代码编译需要define变量GPU，CUDNN，OPENCV等，则用该语句进行定义

7.添加源代码

set(SRC  ${PROJECT_SOURCE_DIR}/test.cpp)

通过设定SRC变量，将源代码路径都给SRC，如果有多个，可以直接在后面继续添加：

set(SRC 
    ${PROJECT_SOURCE_DIR}/src/detector.cpp
    ${PROJECT_SOURCE_DIR}/src/demo.cpp
    ${PROJECT_SOURCE_DIR}/test.cpp
)

 

8.编译动态库并链接库文件

link_directories(${PROJECT_SOURCE_DIR})
add_library(plate_recognition SHARED ${SRC})
target_link_libraries(plate_recognition ${OpenCV_LIBS})
target_link_libraries(plate_recognition -llianghao  -lpthread -lm -lstdc++)

•  LINK_DIRECTORIES(...)库文件存放的目录，在程序连接库文件的时候要再这些目录下寻找对应的库文件
• add_library为生成库文件，SHARED为生成动态库，STATIC为生成静态库，plate_recognition为生成的文件名，如上生成的动态库为libplate_recognition.so，最后${SRC}为源文件路径。
• target_link_libraries为链接需要的库，plate_recognition为需要进行链接的文件名，后面接需要链接的库，如第三行链接了opencv。如果需要链接其他的动态库，-l后接去除lib前缀和.so后缀的名称，以链接liblianghao.so为例，-llianghao。
•  表示库association 依赖core库文件

9.生成可执行文件

link_directories(${PROJECT_SOURCE_DIR})
add_executable(Test ${SRC})
target_link_libraries(Test ${OpenCV_LIBS})
target_link_libraries(Test -llianghao  -lpthread -lm -lstdc++)

• ADD_EXECUTABLE()     #指定要生成的执行文件的名称server,其他用法utilty/CMakeLists.txt

• SET_TARGET_PROPERTIES

     设置编译的库文件存放的目录，还可用于其他属性的设置。如不指定，

     生成的执行文件在当前编译目录下的各子目录下的build目录下，好拗口！简单一点：

     如指定在： ./src/lib 下

     不指定在： ./src/build/utility/build 目录下

     生成的中间文件在./src/build/utilty/build 目录下，不受该命令额影响

10.打印相关消息

MESSAGE（STATUS, "Content") 

 11.设置编译类型

SET(CMAKE_BUILE_TYPE DEBUG)  

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

 12.设置编译器的类型

SET(CMAKE_C_FLAGS_DEBUG "-g -Wall") 设置编译器的类型

          CMAKE_C_FLAGS_DEBUG            ----  C 编译器

          CMAKE_CXX_FLAGS_DEBUG        ----  C++ 编译器

13. 添加要编译的子目录

 ADD_SUBDIRECTORY(utility) 

参考文献

CMakeList的基本写法_深夜虫鸣的博客-CSDN博客_cmakelist怎么写

cmake使用总结(转）---工程主目录CMakeList文件编写_平常心006的博客-CSDN博客

ROS: 创建并运行一个c++的demo_xyzxyz576的博客-CSDN博客