簡介

CMake is an open-source, cross-platform family of tools designed to build, test and package software. CMake is used to control the software compilation process using simple platform and compiler independent configuration files, and generate native makefiles and workspaces that can be used in the compiler environment of your choice. The suite of CMake tools were created by Kitware in response to the need for a powerful, cross-platform build environment for open-source projects such as ITK and VTK.

CMake is part of Kitware’s collection of commercially supported open-source platforms for software development.

特點

1. 在每個原始碼目錄下都有一個 CMakeLists.txt.
2. CMake 語句不區分大小寫。一句一行，無行結束符號，註釋用#
3. CMake 實際也是一種程式語言。CMake 根據 CMakeLists.txt 自動生成 Makefile.。
4. CMake 比 Autotools 更簡單明瞭。
5. 開放原始碼。
6. 跨平臺，並可生成native編譯配置檔案，在Linux/Unix 平臺，生成 makefile，在蘋果平臺，可以生成xcode，在 Windows 平臺，可以生成 MSVC 的工程檔案。
7. 能夠管理大型專案。
8. 可擴充套件，可以為cmake編寫特定功能的模組，擴充cmake 功能。
9. 注：如果你的工程只有幾個檔案，直接編寫Makefile 是最好的選擇。

語法

1、變數使用${}方式取值，但是在 IF 語句中是直接使用變數名取值

MESSAGE(STATUS “This is bin dir” $(PROJECT_BINARY_DIR))
MESSAGE(STATUS “This is bin dir $(PROJECT_BINARY_DIR)”)
上面兩句等效。

2、指令（引數 1 引數 2 …）,引數之間用空格或分號隔開

SET( SRC_LIST main.cpp hello.cpp)
SET(SRC_LIST “main.cpp” “hello.cpp”)
SET(SRC_LIST “main.cpp”;“hello.cpp”)

3、內部構建和外部構建：在哪個目錄下執行 cmake 命令,則在哪個目錄構建

In-source：編譯過程檔案和原始碼檔案在同一目錄下面(在工程目錄下 cmake)
Out-of-sourc:將編譯目錄和原始碼目錄分割開(在非工程目錄下 cmake)。

4、常用變數及指令

（1）CMake變數

（2）CMake 指令([] 表示可選引數)

5、判斷語句

IF指令，基本語法為：
IF(expression)
#THEN section
COMMAND1(ARGS …)
COMMAND2(ARGS …)
…
ELSE(expression)
#ELSE section
COMMAND1(ARGS …)
COMMAND2(ARGS …)
…
ENDIF(expression)
另外一個指令是ELSEIF，總體把握一個原則，凡是出現IF的地方一定要有對應的ENDIF。出現ELSEIF的地方，ENDIF是可選的。
表示式的使用方法如下：
IF(var)，如果變數不是：空，0，N，NO，OFF，FALSE，NOTFOUND或
< var>_NOTFOUND時，表示式為真。
IF(NOT var)，與上述條件相反。
IF(var1 AND var2)，當兩個變數都為真時為真。
IF(var1 OR var2)，當兩個變數其中一個為真時為真。
IF(COMMAND cmd)，當給定的cmd確實時命令並可以呼叫時為真。
IF(EXISTS dir)或者IF(EXISTS file)，當目錄名或者檔名存在時為真。
IF(file1 IS_VEWER_THAN file2)，當file1比file2新，或者file1/file2其中有一個不存在時為真，檔名請使用完整路徑。
IF(IS_DIRECTORY dirname)，當dirname是目錄時，為真。
IF(variable MATCHES regex)
IF(string MATCHES regex)
當給定的變數或者字串能夠匹配正則表示式regex時為真。比如：
IF(“hello” MATCHES “ell”)
MESSAGE(“true”)
ENDIF(“hello” MATCHES “ell”)

IF(variable LESS number)
IF(string LESS number)
IF(variable GREATER number)
IF(string GREATER number)
IF(variable EQUAL number)
IF(string EQUAL number)
數字比較表示式
IF(variable STRLESS number)
IF(string STRLESS number)
IF(variable STRGREATER number)
IF(string STRGREATER number)
IF(variable STREQUAL number)
IF(string STREQUAL number)
按照字母序的排列進行比較
IF(DEFINED variable)，如果變數被定義，為真
一個小例子，用來判斷平臺差異：
IF(WIN32)
MESSAGE(STATUS “This is windows”)
#做一些Windows相關的操作
ELSE(WIN32)
MESSAGE(STATUS “This is windows”)
#做一些非Windows相關的操作
ENDIF(WIN32)
上述程式碼用來控制在不同的平臺進行不同的控制，但是，閱讀起來卻並不是那麼舒服
ENDIF(WIN32)之類的語句很容易引起歧義。
這就用到了我們在“常用變數”一節提到的CMAKE_ALLOW_LOOSE_LOOP_CONSTRUCTS開關。
可以SET(CMAKE_ALLOW_LOOSE_LOOP_CONSTRUCTS ON)
這時候就可以寫成：
IF(WIN32)
WLSE()
ENDIF()

如果配合ELSEIF使用，可能的寫法是這樣：
IF(WIN32)
#do something related to WIN32
ELSEIF(UNIX)
#do something related to UNIX
ELSEIF(APPLE)
#do something related to APPLE
ELSEIF(WIN32)

6、迴圈語句

(1)WHILE
WHILE指令的語法是：
WHILE(condition)
COMMAND1(ARGS …)
COMMAND2(ARGS …)
…
ENDWHILE(condition)
其真假判斷條件可以參考IF指令。
(2)FOREACH
FOREACH指令的使用方法有三種形式：
<1>列表
FOREACH(loop_var_ arg1 arg2 …)
COMMAND1(ARGS …)
COMMAND2(ARGS …)
…
ENDFOREACH(loop_var)
像我們前面使用的AUX_SOURCE_DIRECTORY的例子
AUX_SOURCE_DIRECTORY( SRC_LIST)
FOREACH(F ${SRC_LIST}) MESSAGE(${F})
ENDFOREACH(F)
<2>範圍
FOREACH(loop_var RANGE total)
ENDFOREACH(loop_var)
從0到total以1為步進

舉例如下：
FOREACH(VAR RANGE 10)
MESSAGE($ {VAR})
ENDFOREACH(VAR)
最終得到的輸出是：
0
1
2
3
4
5
6
7
8
9
10
<3>範圍和步進
FOREACH(loop_var RANGE start stop [step])
ENDFOREACH(loop_var)
從start開始到stop結束，以step為步進。
舉例如下：
FOREACH(A RANGE 5 15 3)
MESSAGE(${A})
ENDFOREACH(A)
最終得到的結果是：
5
8
11
14
這個指令需要注意的是，知道遇到ENDFOREACH指令，整個語句塊才會得到真正的執行。

7、模組的使用與編寫

其實使用純粹依靠cmake本身提供的基本指令來管理工程是一件非常複雜的事情，所以，cmake設計成了可擴充套件的架構，可以通過編寫一些通用的模組來擴充套件cmake。
接下來首先介紹cmake提供的FindCURL模組的使用。然後，基於我們前面的libhello共享庫，編寫一個FindHello.cmake模組。