ubuntu16.04下Cmake学习一

根据网上的资料，我总结了一下，一个工程应该有根目录（bin）存放可执行文件，头文件目录（include）存放头文件，源码文件（src）存放你的算法，还需要一个库文件夹存放你编译的静态库或者动态库。然后得出下面这个例子：

工程文件目录创建

/home/bmi-zc/project:

|—CMakeLists.txt 顶层CMakeLists

|

|—bin

|

|—include

|　　　　test.h　　　　

|

|—lib

|

|—src

　　|　　CMakeLists.txt

　　|　　

　　|—main

　　|　　CMakeLists.txt

　　|　　main.c

　　|

　　|—test

　　　　CMakeLists.txt

　　　　test1.c

　　　　test2.c　　

程序清单

test.h

    #ifndef INCLUDE_TEST_H
    #define INCLUDE_TEST_H
    void t1();
    void t2();
    #endif /*INCLUDE_TEST_H*/

test1.c

    #include "/home/bmi-zc/project/include/test.h"
    #include <stdio.h>
    void t1()
    {
    printf("this is t1()\n");
    }

test2.c

    #include "/home/bmi-zc/project/include/test.h"
    #include <stdio.h>
    void t2()
    {
    printf("this is t2()\n");
    }

main.c:

    #include "/home/bmi-zc/project/include/test.h"
    int main()
    {
    t1();
    t2();
    return 0;
    }

多目录多文件CMakeLists.txt

1 . 顶层CMakeLists.txt

/home/bmi-zc/project/CMakeLists.txt：

    cmake_minimum_required(VERSION 3.5)
    PROJECT(TEST)
    ADD_SUBDIRECTORY(src)

CMakeLists.txt内容：指定项目名称，添加工程源码子目录（子目录里面还有目录，只需要把源码根目录添加进去就行，例如上图，只需要添加src目录ADD_SUBDIRECTORY(src)即可）。

用到的指令：PROJECT，ADD_SUBDIRECTORY。

• 指定CMake的最低版本
  
  cmake_minimum_required(VERSION 3.5)
  
  不添加这一句并不影响整个cmake的过程，但是cmake会建议你加上这一句。
• project命令
  
  project（项目名称）
  
  例子：PROJECT（TEST）
  
  系统预定义变量PROJECT_SOURCE_DIR和PROJECT_BINARY_DIR。
  
  PROJECT_SOURCE就是项目的根目录，例如；头文件include目录路径可以表示为：
  
  ${PROJECT_SOURCE_DIR}/include ，其中PROJECT是可以换为项目名称TEST的。建议使用PROJECT_SOURCE_DIR。
  
  若使用“项目名称“_SOURCE_DIR，一旦项目名称更改，所有对应的名称也要更改。
• ADD_SUBDIRECTORY命令
  
  ADD_SUBDIRECTORY(source_dir [binary_dir] [EXCLUDE_FROM_ALL])
  
  例子：ADD_SUBDIRECTORY（src bin）
  
  这个指令用于向当前工程添加存放源文件目录下的子目录（源码存放在src目录，需要自己提前创建src，并把源码放进去），并可以指定中间二进制和目标二进制存放的位置（bin目录，系统自己会创建）。
  
  EXCLUDE_FROM_ALL 参数的含义是将这个目录从编译过程中排除。比如，工程的 example,可能就需要工程构建完成后，再进入 example 目录单独进行构建。

2. 源码目录下顶层CMakeLists.txt

/home/bmi-zc/project/src/

    ADD_SUBDIRECTORY(main)
    ADD_SUBDIRECTORY(test)

CMakeLists.txt内容：添加源码子目录

所用到指令：ADD_SUBDIRECTORY

3. 源码子目录(算法目录)CMakeLists.txt

/home/bmi-zc/project/src/test/

    SET(CMAKE_C_COMPTLER GCC)
    SET(SRC_LIST test1.c test2.c)
    INCLUDE_DIRECTORIES(${PROJECT_SOURCE_DIR}/include)
    SET(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/lib)
    ADD_LIBRARY(libtest STATIC ${SRC_LIST})

CMakeLists.txt内容：设置编辑器，添加头文件路径，设置lib输出目录，生成静态链接库

• SET命令
  
  SET（CMAKE_INSTALL_PREFIX /usr/local）
  
  指令含义（类似宏定义）：路径/usr/local用CMAKE_INSTALL_PREFIX来代替
  
  SET(VAR[VALUE][CACHE TYPE DOCSTRING[FORCE]])指令，将所有文件组合成一股列表清单，例如：SET(SRC_LIST main.c test.c p.c)。
  
  SET(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/lib)把静态链接库的结果生成到/home/bmi-zc/peoject/lib中
• INCLUDE_DIRECTORIES
  
  例子：INCLUDE_DIRECTORIES( ../include)
  
  INCLUDE_DIRECTORIES类似gcc中的编译参数“-I”，指定编译过程中编译器搜索头文件的路径。当项目需要的头文件不在系统默认的搜索路径时，需要指定该路径。在我们的项目中，test1，test2所需的头文件都存放在${TEST_SOURCE_DIR}/include下。
• ADD_LIBRARY
  
  ADD_LIBRARY(libname [SHARED | STATIC | MODULE] [EXCLUDE_FROM_ALL] SRC_LIST)
  
  生成静态链接库或动态库
  
  例子：ADD_LIBRARY(libtest STATIC ${SRC_LIST})

/home/bmi-zc/project/src/main

    SET(SRC_LIST main.c)
    INCLUDE_DIRECTORIES(${TEST_SOURCE_DIR}/include)
    SET(EXECUTABLE_OUTPUT_PATH ${TEST_SOURCE_DIR}/bin)
    ADD_EXECUTABLE(main ${SRC_LIST})
    link_directories(${TEST_SOURCE_DIR}/lib)
    TARGET_LINK_LIBRARIES(main libtest)

CMakeLists.txt内容：整理代码清单，头文件目录，可执行文件输出路径，静态库链接路径，链接静态库。

• ADD_EXECUTABLE
  
  生成可执行文件，ADD_EXECUTABLE(main ${SRC_LIST})，执行文件名字叫main。SRC_LIST为编译清单。
• link_directories
  
  添加静态链接库路径,${TEST_SOURCE_DIR}/lib为路径等同于/home/bmi-zc/project/lib。
• TARGET_LINK_LIBRARIES
  
  将静态库添加到可执行文件中，
  
  TARGET_LINK_LIBRARIES(main libtest)，main为可执行文件，libtest为静态库的名字，注意要和之前创建的静态库名字一样。

编译

• 回到工程根目录，/home/bmi-zc/project
  
  cmake .

make
  
  

• 进入bin文件夹，执行main可执行文件
  
  cd bin

./main
  
  

分享推送

• 常用命令详情请参考对应CMake版本
• 比较好的3篇关于Cmake的博文：
  
  1 . 关于cmake的使用总结，发布于2013年11月。
  
  https://www.mawenbao.com/note/cmake.html
  
  2 . 关于cmake入门实战，发布于2013年12月。
  
  http://hahack.com/codes/cmake/
  
  3 . 关于cmake的命令和一下命令例子，发布于2014年11月
  
  http://blog.csdn.net/wzzfeitian/article/details/40963457/