cmake 使用教程

cmake官方教程

1 项目相关

1. 指定项目名称？ project(项目)
2. 一个cmake 是否可以有多个项目:- 一个项目可以有多个可执行文件。添加方法：add_executable(Tutorial tutorial.cxx)
3. 如何创建库 add_library(MathFunctions mysqrt.cxx)
4. include(文件) 包含其他的cmake文件

2 文件相关

1. 如何增加源文件
2. 如何添加头文件 ：include_directories("${PROJECT_BINARY_DIR}")
3. 如何添加静态库和共享库 target_link_libraries (Tutorial MathFunctions)
4. 递归添加目录：add_subdirectory (MathFunctions)

3 配置相关

1. 定义配置文件
   make target 自动生成配置文件
   自动生成配置文件。

configure_file (
  "${PROJECT_SOURCE_DIR}/TutorialConfig.h.in"
  "${PROJECT_BINARY_DIR}/TutorialConfig.h"
  )

2 定义编译开关

option (USE_MYMATH 
        "Use tutorial provided math implementation" ON)

4 文件安装

install (TARGETS MathFunctions DESTINATION bin)
install (FILES MathFunctions.h DESTINATION include)

5 cmake 使用

camke cmakelist.txt存放目录 example:cmake .
make test 执行使用CMake官方test框架

6常用内置变量

PROJECT_SOURCE_DIR
PROJECT_BINARY_DIR

7 cmake其高级功能

1. 平台检查自省函数。CMake文件执行目录中由现成的CMake函数，用来支持自省。CMake自省函数
2. CTest， CMake官方带的测试框架
3. add_custom_command： 动态生成源文件（OUTPUT ）、或者执行编译前后命令（TARGET）

 add_custom_command(OUTPUT output1 [output2 ...]
                     COMMAND command1 [ARGS] [args1...]
                     [COMMAND command2 [ARGS] [args2...] ...]
                     [MAIN_DEPENDENCY depend]
                     [DEPENDS [depends...]]
                     [IMPLICIT_DEPENDS <lang1> depend1 ...]
                     [WORKING_DIRECTORY dir]
                     [COMMENT comment] [VERBATIM] [APPEND]) 
add_custom_command(TARGET target
                    PRE_BUILD | PRE_LINK | POST_BUILD
                    COMMAND command1 [ARGS] [args1...]
                    [COMMAND command2 [ARGS] [args2...] ...]
                    [WORKING_DIRECTORY dir]
                    [COMMENT comment] [VERBATIM])

1. add_custom_target 添加自定义目标

add_custom_target(Name [ALL] [command1 [args1...]]
                    [COMMAND command2 [args2...] ...]
                    [DEPENDS depend depend depend ... ]
                    [WORKING_DIRECTORY dir]
                    [COMMENT comment] [VERBATIM]
                    [SOURCES src1 [src2...]])

1. CMake中自定义函数

 macro (do_test arg result)
  add_test (TutorialComp${arg} Tutorial ${arg})
  set_tests_properties (TutorialComp${arg}
    PROPERTIES PASS_REGULAR_EXPRESSION ${result}
    )
endmacro (do_test)