常用的CMake语句包括:
**project()**:定义项目名称和指定项目支持的语言。
**set()**:设置变量值。
**add_executable(main main.c ...)**:添加可执行文件main,后面是其依赖的源文件。
**add_library()**:添加库文件。
**target_link_libraries()**:链接库文件。
**include_directories(dir dir ...)**:指定头文件搜索路径,路径之间用空格分隔。
**link_directories()**:指定库文件搜索路径。
**link_libraries()**:链接指定的库文件。
**find_library()**:查找库文件。
**aux_source_directory(dir var) **:第一个参数dir是指定目录,第二个参数var是用于存放源文件列表的变量。
add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL]):这个语句的作用是增加编译子目录,cmake命令执行后的输出文件将会存放在此binary_dir,EXCLUDE_FROM_ALL将会将这个目录从编译中排除,如工程的例子需要等待其他编译完成后再进行单独的编译。
set (EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)
EXECUTABLE_OUTPUT_PATH是个系统自带的预定义变量,目标二进制可执行文件的存放位,PROJECT_SOURCE_DIR:工程的根目录。
add_library (testFunc_shared SHARED ${SRC_LIST})
add_library (testFunc_static STATIC ${SRC_LIST})
set_target_properties (testFunc_shared PROPERTIES OUTPUT_NAME "testFunc")
set_target_properties (testFunc_static PROPERTIES OUTPUT_NAME "testFunc")
set (LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/lib)
add_library: 生成动态库或静态库(第1个参数指定库的名字;第2个参数决定是动态还是静态,如果没有就默认静态;第3个参数指定生成库的源文件)
set_target_properties: 设置最终生成的库的名称,还有其它功能,如设置库的版本号等
LIBRARY_OUTPUT_PATH: 库文件的默认输出路径,这里设置为工程目录下的lib目录
find_library(TESTFUNC_LIB testFunc HINTS ${PROJECT_SOURCE_DIR}/testFunc/lib)
target_link_libraries (main ${TESTFUNC_LIB})
find_library: 在指定目录下查找指定库,并把库的绝对路径存放到变量里,其第一个参数是变量名称,第二个参数是库名称,第三个参数是HINTS,第4个参数是路径,其它用法可以参考cmake文档
target_link_libraries: 把目标文件与库文件进行链接
add_compile_options(-std=c++11 -Wall):增加编译条项
有时希望在编译代码时只编译一些指定的源码,可以使用cmake的option命令,主要遇到的情况分为2种:
本来要生成多个bin或库文件,现在只想生成部分指定的bin或库文件
对于同一个bin文件,只想编译其中部分代码(使用宏来控制)
option(MYDEBUG "enable debug compilation" OFF)
if (MYDEBUG)
add_executable(main2 main2.c)
else()
message(STATUS "Currently is not in debug mode")
endif()
其第一个参数是这个option的名字,第二个参数是字符串,用来描述这个option是来干嘛的,第三个是option的值,ON或OFF,也可以不写,不写就是默认OFF。
一般会把源文件放到src目录下,把头文件放入到include文件下,生成的对象文件放入到build目录下,最终输出的可执行程序文件会放到bin目录下
参考链接: