CMake常用命令整理

轉自：https://zhuanlan.zhihu.com/p/315768216

CMake 是什么我就不用再多說什么了，相信大家都有接觸才會看一篇文章。對于不太熟悉的開發人員可以把這篇文章當個查找手冊。

1.CMake語法

1.1 指定cmake的最小版本

cmake_minimum_required(version 版本號)

例如：

cmake_minimum_required(version 2.8)

1.2 定義工程名稱

#定義工程名稱 
project(項目名稱)

例如：

project(MyTest)

1.3 顯示定義變量

set(var [value])

例如：

# 第一種用法，生成代碼文件列表
#先直接設置SRC_LIST的值
set(SRC_LIST add.h add.cpp)
#然后再在SRC_LIST中追加main.cpp 
set(SRC_LIST ${SRC_LIST} main.cpp)# 第二中用法，設置庫生成目錄或者可執行文件生成目錄
set( LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/lib/linux) 
set( EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)

1.4 設置編譯類型

# 編譯靜態庫
add_library(庫名稱 STATIC 代碼文件名稱) # 編譯動態庫
add_library(庫名稱 SHARED 代碼文件名稱) # 編譯可執行程序
add_executable(可執行程序名 代碼文件名稱)

例如：

# 編譯靜態庫
add_library(add STATIC add.h add.cpp)
add_library(add STATIC ${ADD_SRC} ${ADD_HDR})# 編譯動態庫
add_library(add  SHARED add.h add.cpp) 
add_library(add SHARED  ${ADD_SRC} ${ADD_HDR})# 編譯可執行程序
add_executable(main add.h add.cpp mai.cpp)
add_executable(main ${MAIN_SRC} ${MAIN_HDR})

1.5 指定靜態庫或者動態庫編譯輸出目錄

例如將當前編譯的靜態庫或者動態庫輸出到當前項目文件夾lib子目錄下

set(LIBRARY_OUTPUT_PATH  ${PROJECT_SOURCE_DIR}/lib)

1.6 指定可執行程序編譯輸出目錄

例如將當前可執行程序輸出到當前項目文件夾的bin子目錄下

#設定可執行二進制文件的目錄
set( EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)

1.7 設置鏈接庫搜索目錄

例如將鏈接庫搜索目錄設置為當前項目文件夾下lib/linux文件夾

link_directories( ${PROJECT_SOURCE_DIR}/lib/linux)

1.8 設置包含目錄

例如將包含目錄設置為當前項目文件夾下include文件夾

include_directories(${PROJECT_SOURCE_DIR}/include)

1.9 設置宏定義

#預定義宏
add_definitions(-D宏名稱)

例如：

add_definitions(-DWINDOWS)
add_definitions(-DLINUX)

1.10 鏈接靜態庫

link_libraries(靜態庫1靜態庫2靜態庫3...
)

注意，link_libraries中的靜態庫為全路徑，常與1.7 link_directories 搭配使用，例如：

lib1.a lib2.a在目錄${PROJECT_SOURCE_DIR}/lib/linux下，則先設置鏈接目錄，再鏈接相應的庫

#設置鏈接目錄
link_directories( ${PROJECT_SOURCE_DIR}/lib/linux)
link_libraries(lib1.alib2.a
)

1.11 鏈接動態庫

target_link_libraries(所需生成的文件名稱 所需鏈接的動態庫名稱)

例如

target_link_libraries(main dl)

1.12 link_libraries 和 target_link_libraries 區別

在cmake語法中，link_libraries和target_link_libraries是很重要的兩個鏈接庫的方式，雖然寫法上很相似，但是功能上有很大區別：

(1) link_libraries用在add_executable之前，target_link_libraries用在add_executable之后
(2) link_libraries用來鏈接靜態庫，target_link_libraries用來鏈接導入庫，即按照header file + .lib + .dll方式隱式調用動態庫的.lib庫

1.13 file語法

1.13.1 將文件夾所有的類型的文件添加到文件列表

例如將當前文件夾下所有.cpp文件的文件名加入到MAIN_SRC中，將當前文件夾下所有.h加入到MAIN_HDR中。

file(GLOB MAIN_SRC ${CMAKE_CURRENT_SOURCE_DIR}/*.cpp)
file(GLOB MAIN_HDR ${CMAKE_CURRENT_SOURCE_DIR}/*.h)

例如將當前文件夾子目錄src文件夾下所有.cpp文件的文件名加入到MAIN_SRC中，將當前文件夾子目錄src文件夾下所有.h加入到MAIN_HDR中。

file(GLOB MAIN_SRC ${CMAKE_CURRENT_SOURCE_DIR}/src/*.cpp)
file(GLOB MAIN_HDR ${CMAKE_CURRENT_SOURCE_DIR}/src/*.h)

1.13.2 遞歸搜索該文件夾，將文件夾下（包含子目錄）符合類型的文件添加到文件列表

例如將當前文件夾下（包括子目錄下）所有.cpp文件的文件名加入到MAIN_SRC中，所有.h加入到MAIN_HDR中

file(GLOB_RECURSE MAIN_SRC ${CMAKE_CURRENT_SOURCE_DIR}/*.cpp)
file(GLOB_RECURSE MAIN_HDR ${CMAKE_CURRENT_SOURCE_DIR}/*.h)

1.14 List操作

常見的List操作包括：

list(LENGTH <list> <output variable>) 
list(GET <list> <element index> [<element index> ...]<output variable>)
list(APPEND <list> [<element> ...])
list(FIND <list> <value> <output variable>)
list(INSERT <list> <element_index> <element> [<element> ...])
list(REMOVE_ITEM <list> <value> [<value> ...])
list(REMOVE_AT <list> <index> [<index> ...])
list(REMOVE_DUPLICATES <list>)
list(REVERSE <list>)
list(SORT <list>)

1.14.1 List移除指定項

例如從MAIN_SRC移除指定項

list(REMOVE_ITEM MAIN_SRC ${CMAKE_CURRENT_SOURCE_DIR}/add.cpp)

1.14.2 將兩個List鏈接起來

# 搜索當前目錄
file(GLOB  MAIN_SRC ${CMAKE_CURRENT_SOURCE_DIR}/*.cpp)
file(GLOB  MAIN_HDR ${CMAKE_CURRENT_SOURCE_DIR}/*.h)# 遞歸搜索當前目錄下src子目錄
file(GLOB_RECURSE MAIN_SRC_ELSE  ${CMAKE_CURRENT_SOURCE_DIR}/src/*.cpp)
file(GLOB_RECURSE MAIN_HDR_ELSE  ${CMAKE_CURRENT_SOURCE_DIR}/src/*.h)# 將MAIN_SRC_ELSE中的值添加到MAIN_SRC 
# 將MAIN_HDR_ELSE中的值添加到MAIN_HDR 
list(APPEND MAIN_SRC ${MAIN_SRC_ELSE})
list(APPEND MAIN_HDR ${MAIN_HDR_ELSE})

1.15 添加子文件夾

例如

add_subdirectory(src)

該語句會在執行完當前文件夾CMakeLists.txt之后執行src子目錄下的CMakeLists.txt

1.16 message輸出消息機制

輸出正常：

message(STATUS "Enter cmake ${CMAKE_CURRENT_LIST_DIR}")

輸出警告

message(WARNING "Enter cmake ${CMAKE_CURRENT_LIST_DIR}")

輸出錯誤：

message(FATAL_ERROR "Enter cmake ${CMAKE_CURRENT_LIST_DIR}")

1.17 安裝

install 指令用于定義安裝規則，安裝的內容包括二進制可執行文件、動態庫、靜態庫以及文件、目錄、腳本等。

1.17.1 目標文件安裝

例如：

install(TARGETS utilRUNTIME DESTINATION binLIBRARY DESTINATION libARCHIVE DESTINATION lib)

ARCHIVE指靜態庫，LIBRARY指動態庫，RUNTIME指可執行目標二進制，上述示例的意思是：

如果目標util是可執行二進制目標，則安裝到$CMAK{E}_{I}NSTAL{L}_{P}REFIX/bin目錄如果目標util是靜態庫，則安裝到安裝到${CMAKE_INSTALL_PREFIX}/lib目錄 如果目標util是動態庫，則安裝到安裝到${CMAKE_INSTALL_PREFIX}/lib目錄

1.17.2 文件夾安裝

install(DIRECTORY include/ DESTINATION include/util)

這個語句的意思是將include/目錄安裝到include/util目錄

1.18 設置編譯選項

設置編譯選項可以通過add_compile_options命令，也可以通過set命令修改CMAKE_CXX_FLAGS或CMAKE_C_FLAGS。 方式1

set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11 -march=native -O3 -frtti -fpermissive -fexceptions -pthread")

方式2

add_compile_options(-march=native -O3 -fexceptions -pthread -fPIC)

這兩種方式的區別在于：

add_compile_options命令添加的編譯選項是針對所有編譯器的(包括c和c++編譯器)，而set命令設置CMAKE_C_FLAGS或CMAKE_CXX_FLAGS變量則是分別只針對c和c++編譯器的。

1.19 預定義變量

1.19.1 基本變量

• PROJECT_SOURCE_DIR-----------------------------------------我們使用cmake命令后緊跟的目錄，一般是工程的根目錄；
• PROJECT_BINARY_DIR ------------------------------------------執行cmake命令的目錄,通常是${PROJECT_SOURCE_DIR}/build；
• CMAKE_INCLUDE_PATH-----------------------------------------系統環境變量,非cmake變量；
• CMAKE_LIBRARY_PATH------------------------------------------系統環境變量,非cmake變量；
• CMAKE_CURRENT_SOURCE_DIR---------------------------當前處理的CMakeLists.txt所在的路徑；
• CMAKE_CURRENT_BINARY_DIR-----------------------------target編譯目錄（使用ADD_SURDIRECTORY(src bin)可以更改此變量的值 ，SET(EXECUTABLE_OUTPUT_PATH <新路徑>)并不會對此變量有影響,只是改變了最終目標文件的存儲路徑）；
• CMAKE_CURRENT_LIST_FILE--------------------------------輸出調用這個變量的CMakeLists.txt的完整路徑；
• CMAKE_CURRENT_LIST_LINE--------------------------------輸出這個變量所在的行；
• CMAKE_MODULE_PATH-----------------------------------------定義自己的cmake模塊所在的路徑（這個變量用于定義自己的cmake模塊所在的路徑，如果你的工程比較復雜，有可能自己編寫一些cmake模塊，比如SET(CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/cmake),然后可以用INCLUDE命令來調用自己的模塊）；
• EXECUTABLE_OUTPUT_PATH------------------------------重新定義目標二進制可執行文件的存放位置；
• LIBRARY_OUTPUT_PATH--------------------------------------重新定義目標鏈接庫文件的存放位置；
• PROJECT_NAME-------------------------------------------------返回通過PROJECT指令定義的項目名稱；
• CMAKE_ALLOW_LOOSE_LOOP_CONSTRUCTS—用來控制IF ELSE語句的書寫方式；

1.19.2 操作系統變量

• CMAKE_MAJOR_VERSION-----------------------------cmake主版本號,如3.4.1中的3；
• CMAKE_MINOR_VERSION-----------------------------cmake次版本號,如3.4.1中的4；
• CMAKE_PATCH_VERSION-----------------------------cmake補丁等級,如3.4.1中的1；
• CMAKE_SYSTEM----------------------------------------操作系統名稱，包括版本名，如Linux-2.6.22；
• CAMKE_SYSTEM_NAME-------------------------------操作系統名稱，不包括版本名，如Linux；
• CMAKE_SYSTEM_VERSION--------------------------操作系統版本號,如2.6.22；
• CMAKE_SYSTEM_PROCESSOR--------------------電腦處理器名稱，如i686；
• UNIX--------------------------------------------------------在所有的類UNIX平臺為TRUE,包括OS X和cygwin，Linux/Unix操作系統；
• WIN32-----------------------------------------------------在所有的win32平臺為TRUE,包括cygwin，Windows操作系統；
• APPLE----------------------------------------------------蘋果操作系統；

例如操作系統判斷方式一：

if(WIN32)message(STATUS “This operating system is Windows.”)
elseif(UNIX)message(STATUS “This operating system is Linux.”)
elseif(APPLE)message(STATUS “This operating system is APPLE.”)
endif(WIN32)

操作系統判斷方式二：

if (CMAKE_SYSTEM_NAME MATCHES "Linux")message(STATUS "current platform: Linux ")
elseif (CMAKE_SYSTEM_NAME MATCHES "Windows")message(STATUS "current platform: Windows")
elseif (CMAKE_SYSTEM_NAME MATCHES "FreeBSD")message(STATUS "current platform: FreeBSD")
else ()message(STATUS "other platform: ${CMAKE_SYSTEM_NAME}")
endif (CMAKE_SYSTEM_NAME MATCHES "Linux")

1.19.3 開關選項

• BUILD_SHARED_LIBS---------------------------------------------控制默認的庫編譯方式。如果未進行設置,使用ADD_LIBRARY時又沒有指定庫類型,默認編譯生成的庫都是靜態庫；
• CMAKE_C_FLAGS-------------------------------------------------設置C編譯選項，也可以通過指令ADD_DEFINITIONS()添加；
• CMAKE_CXX_FLAGS----------------------------------------------設置C++編譯選項，也可以通過指令ADD_DEFINITIONS()添加；
• CMAKE_C_COMPILER--------------------------------------------指定C編譯器；
• CMAKE_CXX_COMPILER----------------------------------------指定C++編譯器；
• CMAKE_BUILD_TYPE:：build 類型(Debug, Release, …)-CMAKE_BUILD_TYPE=Debug

1.19.4 環境變量

設置環境變量：

set(env{name} value)

調用環境變量：

$env{name}

例如

message(STATUS "$env{name}")

1.19.5 CMAKE_INCLUDE_CURRENT_DIR

自動添加CMAKE_CURRENT_BINARY_DIR和CMAKE_CURRENT_SOURCE_DIR到當前處理 的CMakeLists.txt。 相當于在每個CMakeLists.txt加入：

include_directories(${CMAKE_CURRENT_BINARY_DIR} ${CMAKE_CURRENT_SOURCE_DIR})

1.20 條件判斷

1.20.1 邏輯判斷和比較

• if (expression)：expression 不為空時為真，false的值包括（0,N,NO,OFF,FALSE,NOTFOUND）；
• if (not exp)：與上面相反；
• if (var1 AND var2)：如果兩個變量都為真時為真；
• if (var1 OR var2)：如果兩個變量有一個為真時為真；
• if (COMMAND cmd)：如果 cmd 確實是命令并可調用為真；
• if (EXISTS dir) if (EXISTS file)：如果目錄或文件存在為真；
• if (file1 IS_NEWER_THAN file2)：當 file1 比 file2 新，或 file1/file2 中有一個不存在時為真，文件名需使用全路徑；
• if (IS_DIRECTORY dir)：當 dir 是目錄時為真；
• if (DEFINED var)：如果變量被定義為真；
• if (var MATCHES regex)：給定的變量或者字符串能夠匹配正則表達式 regex 時為真，此處 var 可以用 var 名，也可以用 ${var}；
• if (string MATCHES regex)：給定的字符串能夠匹配正則表達式regex時為真。

1.20.2 數字比較

• if (variable LESS number)：如果variable小于number時為真；
• if (string LESS number)：如果string小于number時為真；
• if (variable GREATER number)：如果variable大于number時為真；
• if (string GREATER number)：如果string大于number時為真；
• if (variable EQUAL number)：如果variable等于number時為真；
• if (string EQUAL number)：如果string等于number時為真。

1.20.3 字母表順序比較

• if (variable STRLESS string)
• if (string STRLESS string)
• if (variable STRGREATER string)
• if (string STRGREATER string)
• if (variable STREQUAL string)
• if (string STREQUAL string)

1.21 循環

1.21.1 foreach

start 表示起始數，stop 表示終止數，step 表示步長

foreach(loop_var RANGE start stop [step])...
endforeach(loop_var)

1.21.2 while

while(condition)...
endwhile()

1.22 自動檢測編譯器是否支持C++11

include(CheckCXXCompilerFlag)
CHECK_CXX_COMPILER_FLAG("-std=c++11" COMPILER_SUPPORTS_CXX11)
CHECK_CXX_COMPILER_FLAG("-std=c++0x" COMPILER_SUPPORTS_CXX0X)
if(COMPILER_SUPPORTS_CXX11)set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11")
elseif(COMPILER_SUPPORTS_CXX0X)set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++0x")
else()message(STATUS "The compiler ${CMAKE_CXX_COMPILER} has no C++11 support. Please use a different C++ compiler.")
endif()

1.23 CMake生成VS解決方案將項目放置在設定文件夾下

例如，我們在工程中引用了許多的第三方開源庫，這些庫的源碼與自己所寫的代碼需要進行區分和隔離，通常情況下會單獨開一個third篩選器存儲這些第三方庫的項目，怎么做？

第一步：

在第三方庫的CMakeLists.txt中cmake_minimum_required(VERSION 2.6)中加上set_property(GLOBAL PROPERTY USE_FOLDERS On)

第二步：在生成編譯目標的語法之后，如：

add_executable(demo demo.cpp) # 生成可執行文件
add_library(common STATIC util.cpp) # 生成靜態庫
add_library(common SHARED util.cpp) # 生成動態庫或共享庫

加入一句

set_target_properties(${第三方庫項目名稱} PROPERTIES FOLDER “目標文件夾名稱”)

2 錯誤解決方案

2.1 Cannot specify link libraries for target “/…/…/lib/linux/libMyDll.a” which

這個問題要將生成執行文件、靜態庫、動態庫的聲明

add_executable(demo demo.cpp) # 生成可執行文件
add_library(common STATIC util.cpp) # 生成靜態庫
add_library(common SHARED util.cpp) # 生成動態庫或共享庫

放在

target_link_libraries()

之前。

2.2 警告：檢測到時鐘錯誤。您的創建可能是不完整的。

在項目根目錄下執行命令：

touch *

更新所有文件時間。