介绍一个比较实用的例子,即包含生成静态库又包含引入外部头文件和链接库的cmake demo。
先按照工程规范建立工程目录,并编写代码,以下面的工程目录为例进行解释这个例子,工程的目录结构为:
1. 编写CMakeLists.txt
由于一个工程目录中包含多个项目,其中在此项目中包含util项目和main项目,其中util项目是用以生成main程序需要的静态库,main是用以生成可执行文件。
在工程项目中的父目录向有一个CMakeLists.txt是用以声明定义工程需要的Cmake设置还定义了子目录src,用以递归的调用src中的MakeLists.txt。
1) 工程目录的CMakeLists.txt内容定义如下:
PROJECT(HELLO) 定义工程的名称
ADD_SUBDIRECTORY(src) 用以递归的调用src中的MakeLists.txt
2)src里面的CMakeLists.txt内容定义如下:
ADD_SUBDIRECTORY(main) 用以递归的调用main中的MakeLists.txt
ADD_SUBDIRECTORY(util) 用以递归的调用util中的MakeLists.txt
3)util目录里面的CMakeLists.txt是用以定义生成util静态库的规则,其中内容如下:
SET(LIBRARY_OUTPUT_PATH ${HELLO_SOURCE_DIR}/lib) 定义了库生成的路径,LIBRARY_OUTPUT_PATH是一个内部变量,存放库生成路径
SET(CMAKE_C_COMPILER g++) 定义编译器
SET(SRC_LIST hello.c) 定义库文件需要的源文件
INCLUDE_DIRECTORIES(${HELLO_SOURCE_DIR}/include) 定义非标准库头文件要搜索的路径
ADD_LIBRARY(util STATIC ${SRC_LIST})
4)在main目录中的CMakeLists.txt是用来定义可执行程序编译和链接时所需要的一些命令或环境。内容如下:
SET(EXECUTABLE_OUTPUT_PATH ${HELLO_SOURCE_DIR}/bin) 定义执行文件输出路径
SET(SRC_LIST main.cpp) 定义库文件需要的源文件
INCLUDE_DIRECTORIES(${HELLO_SOURCE_DIR}/include) 定义非标准库头文件要搜索的路径
LINK_DIRECTORIES(${HELLO_SOURCE_DIR}/lib) 定义依赖静态库要搜索的路径
ADD_EXECUTABLE(hello ${SRC_LIST}) 生成执行文件
TARGET_LINK_LIBRARIES(hello util) TARGET_LINK_LIBRARIES用以定义链接时需要的库文件。
2.在工程目录下创建build目录,并采用out-of-source方式编译项目。执行命令cmake ..,执行结果如下:
3)然后进行make
4)安装
重新编辑工程目录下的CMakeLists.txt。在CMakeLists.txt中添加如下命令:
INSTALL(FILES COPYRIGHT README DESTINATION share/doc/cmake_demo)
INSTALL(PROGRAMS run.sh DESTINATION bin)
INSTALL(PROGRAMS bin/hello DESTINATION bin)
INSTALL(DIRECTORY doc/ DESTINATION share/doc/cmake_demo)
这些命令表示在执行make install命令时,安装程序会拷贝相应的文件、目录或程序到指定的前缀开始的目录中
cmake执行命令如下:cmake -DCMAKE_INSTALL_PREFIX=~/data/cmake_demo ..
这时将工程目录安装到~/data/cmake_demo目录下。执行结果如下: