CMAKE 常用命令整理

1. 添加包含目录： INCLUDE_DIRECTORIES

语法：

include_directories([AFTER|BEFORE] [SYSTEM] dir1 [dir2 …])

相当于vs中的附加包含目录，例如：

include_directories(../../../thirdparty/comm/include)

2.添加链接库文件目录：LINK_DIRECTORIES

语法：

link_directories(directory1 directory2 …)

相当于vs中的附加库目录，例如：

link_directories(../../../third/lib)

3. 查找库所在目录FIND_LIBRARY

语法

A short-hand signature is:

find_library ( name1 [path1 path2 …])

The general signature is:

find_library (
<VAR>
name | NAMES name1 [name2 ...] [NAMES_PER_DIR]
[HINTS path1 [path2 ... ENV var]]
[PATHS path1 [path2 ... ENV var]]
[PATH_SUFFIXES suffix1 [suffix2 ...]]
[DOC "cache documentation string"]
[NO_DEFAULT_PATH]
[NO_CMAKE_ENVIRONMENT_PATH]
[NO_CMAKE_PATH]
[NO_SYSTEM_ENVIRONMENT_PATH]
[NO_CMAKE_SYSTEM_PATH]
[CMAKE_FIND_ROOT_PATH_BOTH |
ONLY_CMAKE_FIND_ROOT_PATH |
NO_CMAKE_FIND_ROOT_PATH]
)

如下：

FIND_LIBRARY(RUNTIME_LIB rt /usr/lib  /usr/local/lib NO_DEFAULT_PATH)

cmake会在目录中查找，如果所有目录中都没有，值RUNTIME_LIB就会被赋为NO_DEFAULT_PATH

4.添加需要的包含文件路径：target_include_directories

target_include_directories( [SYSTEM] [BEFORE]

5. 添加需要链接的库文件路径LINK_LIBRARIES

语法：

link_libraries(library1

6. 设置要链接的库文件的名称TARGET_LINK_LIBRARIES

语法：

target_link_libraries( [item1 [item2 […]]]

[[debug|optimized|general] ] …)

以下写法都可以：

target_link_libraries(myProject comm)       # 连接libhello.so库，默认优先链接动态库
target_link_libraries(myProject libcomm.a)  # 显示指定链接静态库
target_link_libraries(myProject libcomm.so) # 显示指定链接动态库

或：

target_link_libraries(myProject libcomm.so)　　#这些库名写法都可以。
target_link_libraries(myProject comm)
target_link_libraries(myProject -lcomm)

7. xxx_directories 和 target_xxx_directories 区别：

这类命令如：

include_directories/target_include_directories

link_directories/ target_link_libraries

主要区别在于：

xxx_directories 将作用于整个工程，target_xxx_directories 将作用于target 的项目

target目标文件必须已经存在（由命令add_executable()或add_library()所创建)，并且不能被IMPORTED修饰

若使用BEFORE，则它修饰的内容会被添加到属性前面。

关键字INTERFACE，PUBLIC和PRIVATE指定它后面参数的作用域。PRIVATE和PUBLIC项会填充targe目标文件的INCLUDE_DIRECTORIES属性。

PUBLIC和INTERFACE项会填充target目标文件的INTERFACE_INCLUDE_DIRECTORIES属性。随后的参数指定包含目录。

8. 为工程生成库文件：

语法：

add_library(

9. 为工程生成目标文件:

语法：

add_executable( [WIN32] [MACOSX_BUNDLE]

[EXCLUDE_FROM_ALL]

source1 [source2 …])

例如：

add_executable(demo main.cpp)