CMake (三)cmake 在工程中的用法
1.外部编译的一个实例:
对于 cmake,内部编译在CMake(一)已经演示过了,它生成了一些无法自动删除的中间文件,所以, 引出了我们对外部编译的探讨,外部编译的过程如下:
1,首先,请清除t1目录中除main.c CmakeLists.txt之外的所有中间文件,最关键 的是 CMakeCache.txt。
2,在t1目录中建立build 目录,当然你也可以在任何地方建立build目录,不一定必 须在工程目录中。
3,进入build目录,运行cmake ..(注意,..代表父目录,因为父目录存在我们需要的 CMakeLists.txt,如果你在其他地方建立了build目录,需要运行cmake <工程的全 路径>),查看一下 build 目录,就会发现了生成了编译需要的 Makefile 以及其他的中间 文件.
4,运行 make 构建工程,就会在当前目录(build 目录)中获得目标文件 hello。
上述过程就是所谓的 out-of-source 外部编译,一个最大的好处是,对于原有的工程没 有任何影响,所有动作全部发生在编译目录。通过这一点,也足以说服我们全部采用外部编 译方式构建工程。
贴图(tree图如下)
スクリーンショット 2018-10-16 17.04.07.png
目录结构是: CMakeLIsts.txt 放在工程的顶层目录下,而建立build, 然后cmake 生成的中间文件会自动放到build 目录下,Cmake的中间文件不能通过make clean 自动删除,这种方式手动删除的时候比较便利。
2.建立src 目录,把所有的source 文件都挪到src 下面去, bin 里面的文件则是自动生成的。
CMakeLists.txt 文件如下:
cmake_minimum_required(VERSION 3.0)
PROJECT (HELLO)
SET (SRC_LIST ${HELLO_SOURCE_DIR}/src/hello.cpp)
MESSAGE(STATUS "This is BINARY dir" ${HELLO_BINARY_DIR})
MESSAGE(STATUS "This is SOURCE dir" ${HELLO_SOURCE_DIR}/src)
INCLUDE_DIRECTORIES("${PROJECT_BINARY_DIR}")
#ADD_SUBDIRECTORY(src bin)
ADD_EXECUTABLE(hello ${SRC_LIST})
编译:
cd build
cmake ..
make
这里要注意的是ADD_SUBDIRECTORY,如果把source 移入到Src,然后编译的时候会出错,说无法再src下面找到CMakeLIsts.txt文件,这里的处理是用SET()方法指定了source 的路径才过的,而ADD_SUBDIRECTORY暂时没有用。
**1)以下是一些说明,还需要慢慢体会用法的精妙之处。
ADD_SUBDIRECTORY 指令ADD_SUBDIRECTORY(source_dir [binary_dir] [EXCLUDE_FROM_ALL])
这个指令用于向当前工程添加存放源文件的子目录,并可以指定中间二进制和目标二进制存 放的位置。EXCLUDE_FROM_ALL 参数的含义是将这个目录从编译过程中排除,比如,工程 的 example,可能就需要工程构建完成后,再进入 example 目录单独进行构建(当然,你 也可以通过定义依赖来解决此类问题)。
**2) 关于要从src 中找CMakeLists.txt 我一直觉得比较反人类,看了一些成熟项目的make 结构,src 下面也没有放这个文件。但为什么参考资料里面没有提要做SET的设定,或许是cmake 的版本不同?
- 演示一个生成静态库的例子:
CMakeLists.txt 文件:
cmake_minimum_required(VERSION 3.0)
PROJECT (HELLO)
SET (SRC_LIST ${HELLO_SOURCE_DIR}/src/hello.cpp)
SET (EXECUTABLE_OUTPUT_PATH ${HELLO_BINARY_DIR}/BIN)
SET (LIBRARY_OUTPUT_PATH ${HELLO_BINARY_DIR}/lib)
MESSAGE(STATUS "This is BINARY dir" ${HELLO_BINARY_DIR})
MESSAGE(STATUS "This is SOURCE dir" ${HELLO_SOURCE_DIR}/src)
INCLUDE_DIRECTORIES("${PROJECT_BINARY_DIR}")
#ADD_SUBDIRECTORY(bin)
#ADD_EXECUTABLE(hello ${SRC_LIST})
ADD_LIBRARY(hello ${SRC_LIST})
INSTALL(TARGETS hello DESTINATION {LIBRARY_OUTPUT_PATH})
加了最后两行
形成的工程文件如下,静态库.a在lib中生成。
スクリーンショット 2018-10-16 18.33.00.png
同理可以生成动态库,省略,
source code:
https://github.com/xieheng0915/eosapps/tree/master/t2
追记:
cmake 的整合,以及其他功能还是在以后使用中再看,以下是一些参考的link:
https://stackoverflow.com/questions/41319476/cmake-add-subdirectory-not-invoking-the-child-cmakelists-txt