cmake 添加頭文件目錄，鏈接動態、靜態庫

原文：cmake 添加頭文件目錄，鏈接動態、靜態庫

Table of Contents

1. 添加頭文件目錄INCLUDE_DIRECTORIES

2. 添加需要鏈接的庫文件目錄LINK_DIRECTORIES

3. 查找庫所在目錄FIND_LIBRARY

4. 添加需要鏈接的庫文件路徑LINK_LIBRARIES

5. 設置要鏈接的庫文件的名稱TARGET_LINK_LIBRARIES 

6. 為工程生成目標文件

6. 最后貼一個完整的例子

---

羅列一下cmake常用的命令。

CMake支持大寫、小寫、混合大小寫的命令。

 

1. 添加頭文件目錄INCLUDE_DIRECTORIES

語法：

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

它相當於g++選項中的-I參數的作用，也相當於環境變量中增加路徑到CPLUS_INCLUDE_PATH變量的作用。

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

2. 添加需要鏈接的庫文件目錄LINK_DIRECTORIES

語法：

link_directories(directory1 directory2 ...)

它相當於g++命令的-L選項的作用，也相當於環境變量中增加LD_LIBRARY_PATH的路徑的作用。

link_directories("/home/server/third/lib")

3. 查找庫所在目錄FIND_LIBRARY

語法：

1.  
   A short-hand signature is:
2.  
    
3.  
   find_library (<VAR> name1 [path1 path2 ...])
4.  
   The general signature is:
5.  
    
6.  
   find_library (
7.  
   <VAR>
8.  
   name | NAMES name1 [name2 ...] [NAMES_PER_DIR]
9.  
   [ HINTS path1 [path2 ... ENV var]]
10.  
    [ PATHS path1 [path2 ... ENV var]]
11.  
    [ PATH_SUFFIXES suffix1 [suffix2 ...]]
12.  
    [ DOC "cache documentation string"]
13.  
    [ NO_DEFAULT_PATH]
14.  
    [ NO_CMAKE_ENVIRONMENT_PATH]
15.  
    [ NO_CMAKE_PATH]
16.  
    [ NO_SYSTEM_ENVIRONMENT_PATH]
17.  
    [ NO_CMAKE_SYSTEM_PATH]
18.  
    [ CMAKE_FIND_ROOT_PATH_BOTH |
19.  
    ONLY_CMAKE_FIND_ROOT_PATH |
20.  
    NO_CMAKE_FIND_ROOT_PATH]
21.  
    )

例子如下：

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

cmake會在目錄中查找，如果所有目錄中都沒有，值RUNTIME_LIB就會被賦為NO_DEFAULT_PATH

4. 添加需要鏈接的庫文件路徑LINK_LIBRARIES

語法：

link_libraries(library1 <debug | optimized> library2 ...)

1.  
   # 直接是全路徑
2.  
   link_libraries(“/home/server/third/ lib/libcommon.a”)
3.  
   # 下面的例子，只有庫名，cmake會自動去所包含的目錄搜索
4.  
   link_libraries(iconv)
5.  
    
6.  
   # 傳入變量
7.  
   link_libraries(${RUNTIME_LIB})
8.  
   # 也可以鏈接多個
9.  
   link_libraries( "/opt/MATLAB/R2012a/bin/glnxa64/libeng.so"　"/opt/MATLAB/R2012a/bin/glnxa64/libmx.so")

可以鏈接一個，也可以多個，中間使用空格分隔.

5. 設置要鏈接的庫文件的名稱TARGET_LINK_LIBRARIES 

語法：

1.  
   target_link_libraries(<target> [item1 [item2 [ ...]]]
2.  
   [[debug|optimized|general] <item>] ...)
3.  
   # 以下寫法都可以：
4.  
   target_link_libraries(myProject comm) # 連接libhello.so庫，默認優先鏈接動態庫
5.  
   target_link_libraries(myProject libcomm.a) # 顯示指定鏈接靜態庫
6.  
   target_link_libraries(myProject libcomm.so) # 顯示指定鏈接動態庫
7.  
    
8.  
   # 再如：
9.  
   target_link_libraries(myProject libcomm.so)　　 #這些庫名寫法都可以。
10.  
    target_link_libraries(myProject comm)
11.  
    target_link_libraries(myProject -lcomm)

6. 為工程生成目標文件

語法：

add_executable(<name> [WIN32] [MACOSX_BUNDLE] [EXCLUDE_FROM_ALL] source1 [source2 ...])

簡單的例子如下：

1.  
   add_executable( demo
2.  
   main.cpp
3.  
   )

6. 最后貼一個完整的例子

1.  
   cmake_minimum_required (VERSION 2.6)
2.  
    
3.  
   INCLUDE_DIRECTORIES(../../thirdparty/comm)
4.  
    
5.  
   FIND_LIBRARY(COMM_LIB comm ../../thirdparty/comm/ lib NO_DEFAULT_PATH)
6.  
   FIND_LIBRARY(RUNTIME_LIB rt /usr/ lib /usr/local/lib NO_DEFAULT_PATH)
7.  
    
8.  
   link_libraries(${COMM_LIB} ${RUNTIME_LIB})
9.  
    
10.  
    ADD_DEFINITIONS(
11.  
    -O3 -g -W -Wall
12.  
    -Wunused-variable -Wunused-parameter -Wunused-function -Wunused
13.  
    -Wno-deprecated -Woverloaded-virtual -Wwrite-strings
14.  
    -D__WUR= -D_REENTRANT -D_FILE_OFFSET_BITS= 64 -DTIXML_USE_STL
15.  
    )
16.  
     
17.  
     
18.  
    add_library(lib_demo
19.  
    cmd.cpp
20.  
    global.cpp
21.  
    md5.cpp
22.  
    )
23.  
     
24.  
    link_libraries(lib_demo)
25.  
    add_executable(demo
26.  
    main.cpp
27.  
    )
28.  
     
29.  
    # link library in static mode
30.  
    target_link_libraries(demo libuuid.a)

另外，使用cmake生成makefile之后，make edit_cache可以編輯編譯選項。
https://cmake.org/cmake/help/v3.0/index.html