cmake - 编译

cmake在编译期间会使用到的命令总结：

1、指定编译器并同时设置编译选项

set(CMAKE_CXX_COMPILER      "clang++" )         # 显示指定使用的C++编译器

set(CMAKE_CXX_FLAGS   "-std=c++11")             # c++11

set(CMAKE_CXX_FLAGS   "-g")                     # 调试信息

set(CMAKE_CXX_FLAGS   "-Wall")                  # 开启所有警告

set(CMAKE_CXX_FLAGS_DEBUG   "-O0" )             # 调试包不优化

set(CMAKE_CXX_FLAGS_RELEASE "-O2 -DNDEBUG " )   # release包优化

CMAKE_CXX_FLAGS设置的编译选项只会对g++有效，其他编译器不生效

当然我们也可以通过add_compile_options()设置，但是通过add_compile_options会对所有编译器生效，如：

add_compile_options(-std=c++11)

在编译C代码时就会产生告警信息

2、编译库文件

1、cmake可以通过add_library利用源文件生成动态和静态库文件，指令如下：

add_library(libxxx1 SHARED xxx.cpp xxxx.cpp) ##命令根据xxx.cpp和xxxx.cpp生成动态库文件libxxx1.so

add_library(libxxx2 STATIC xxx.cpp xxxx.cpp) ##命令根据xxx.cpp和xxxx.cpp生成静态库文件libxxx1.a

add_library(libxxx3 MODULE xxx.cpp xxxx.cpp) ##命令根据xxx.cpp和xxxx.cpp生成中间文件libxxx3，该文件不会被加载到其他地方使用

库文件生成后，我们需要对其属性进行设置，如重置库文件的名称，设置库文件的版本号等，这些需要通过set_target_properties命令实现：

1、将静态库hello_static更名为hello

  set_target_properties(hello_static PROPERTIES OUTPUT_NAME "hello")

2、cmake在构建一个新的target时，会尝试清理掉其它使用这个名字的库，所以在构建libxxx.a时，就会清理掉libxxx.so，所以为了避免这种情况，我们需要如下指令

  set_target_properties(xxx PROPERTIES CLEAN_DIRECT_OUTPUT 1)

  set_target_properties(xxx_static PROPERTIES CLEAN_DIRECT_OUTPUT 1)

3、有时候我们需要增加动态库的版本号

  set_target_properties(hello PROPERTIES VERSION 1.2 SOVERSION 1) ## VERSION指代动态库版本，SOVERSION指代API版本

2、当然我们也可以使用外部现成的库文件，指令如下

add_library(libxxx4 <SHARED|STATIC|MODULE|UNKNOWN> IMPORTED)

IMPORTED 表明此库在工程之外，是target_link_libraries的方便形式。外部库的详细信息通过set_target_properties

设置以IMPORTED_开头的属性来完成，其中最重要的就是 IMPORTED_LOCATION 属性，它指定外部库的位置。

add_library(libxxx4 STATIC IMPORTED)

set_target_properties(libxxx4 PROPERTIES IMPORTED_LOCATION /path/to/libboost_system.a) ##libxxx4其实就是libboost_system.a

target_link_libraries(wang libxxx4)

其实上述3条命令等价于

target_link_libraries(wang /path/to/libboost_system.a)

注意：add_library除了可以生产库文件之外，还可以生成目标文件，但不打包成lib命令如下：

add_library(objlib OBJECT <src>...)

这种库只编译源文件生成目标文件，但是不把这些目标文件打包进一个lib。当其他的库或者目标文件要使用这些目标文件的时候，会以这样的形式来添加，objlib是这个库的名字

add_library(... $<TARGET_OBJECTS:objlib> ...)

add_executable(... $<TARGET_OBJECTS:objlib> ...)

寻找外部依赖库find_package()

在一个大型项目中，免不了需要导入很多外部依赖库，比如一个项目需要使用到伯克利数据库项目，我们需要知道头文件的位置，库文件的位置以及库文件的名称，此时我们就需要find_package命令

find_package命令就是寻找该库的头文件位置、库文件位置以及库文件名称，并将其设置为变量提供给CMakelists使用。以上述伯克利数据库项目为例，

find_package(DBMS)

include_directories(${DBMS_INCLUDE_DIR})

target_link_libraries(main ${DBMS_LIBRARY})

find_package(DBMS)会去 ${CMAKE_MODULE_PATH}指定的所有路径下寻找名字为FindDBMS.cmake的文件，并执行相应的代码，通常FindDBMS.cmake会输出如下几个变量

通常FindCURL.cmake文件会提供以下几个变量：

<name>_FOUND => 表明是否查找到

<name>_INCLUDE_DIR 或 <name>_INCLUDES => 表示头文件位置

<name>_LIBRARY 或 <name>_LIBRARIES 或 <name>_LIBS => 表示库文件路径+名称

<name>_DEFINITIONS

编写FindDBMS.cmake

FindDBMS.cmake主要使用如下两个函数find_path/find_library，其中find_path输出头文件的位置信息，find_library输出库文件的位置信息

find_path原型如下：

查找路径HINTS/PATH/PATH_SUFFIXES下，是否有文件名为name1的文件，如果有则将HINTS/PATH/PATH_SUFFIXES的内容存储在中，否则中存储_NOTFOUND

 find_path(<VAR>

             name | NAMES name1 [name2 ...]

             [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_path(dbms_path

          NAMES db_xxx.h

          PATHS /home/dongfang/cmake_example/find_path

          DOC "this is a test for find_path"

)

查找路径PATH(/home/dongfang/cmake_example/find_path)下是否有db_xxx.h文件，如果有则将"/home/dongfang/cmake_example/find_path"存储在变量dbms_path中

find_library原型如下：