本帖子適用於初學者，StepByStep的入門CMake，CMake也是一門程式語言，只不過是針對編譯和連結這種程式構建的過程的語言，學習基本語法就可以初步入門，後面需要什麼複雜的功能，進階掌握需要自己去查詢官方文件，後續會給出查閱的一些方式

CMake預定義變數

基本變數

• 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語句的書寫方式

環境變數

• 使用$ENV{NAME}可以呼叫系統的環境變數，比如：
  MESSAGE（STATUS “HOME dir：”$ENV{HOME}）
• 設定環境變數的方式，SET(ENV{name} value)
• CMAKE_INCLUDE_CURRENT_DIR
  
  • 自動新增CMAKE_CURRENT_BINARY_DIR和CMAKE_CURRENT_SOURCE_DIR到當前處理
    的CMakeLists.txt。
    相當於在每個CMakeLists.txt加入：
    INCLUDE_DIRECTORIES(<
    /span>CMAKECURRENTBINARYDIR<span>{CMAKE_CURRENT_BINARY_DIR} {CMAKE_CURRENT_SOURCE_DIR})
• CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE
  
  • 將工程提供的標頭檔案目錄始終至於系統標頭檔案目錄的前面，當你定義的標頭檔案確實跟系統發
    生衝突時可以提供一些幫助。
• CMAKE_INCLUDE_PATH、CMAKE_LIBRARY_PATH
  
  • 務必注意，這兩個是環境變數而不是cmake變數。
  • 使用方法是要在bash中用export或者在csh中使用set命令設定或者CMAKE_INCLUDE_PATH=/home/include cmake ..等方式。

也就是，如果標頭檔案沒有存放在常規路徑(/usr/include, /usr/local/include等)，
則可以通過這些變數就行彌補。
比如hello.h存放在/usr/include/hello目錄，所以直接查詢肯定是找不到的。
前面我們直接使用了絕對路徑INCLUDE_DIRECTORIES(/usr/include/hello)告訴工
程這個標頭檔案目錄。為了將程式更智慧一點，
我們可以使用CMAKE_INCLUDE_PATH來進行，使用bash的方法
如下：
export CMAKE_INCLUDE_PATH=/usr/include/hello
然後在標頭檔案中將INCLUDE_DIRECTORIES(/usr/include/hello)替換為：
FIND_PATH(myHeader hello.h)
IF(myHeader)
INCLUDE_DIRECTORIES(${myHeader})
ENDIF(myHeader)

上述的一些指令我們在後面會介紹。
這裡簡單說明一下，FIND_PATH用來在指定路徑中搜索檔名，比如：
FIND_PATH(myHeader NAMES hello.h PATHS /usr/include
/usr/include/hello)
這裡我們沒有指定路徑，但是，cmake仍然可以幫我們找到hello.h存放的路徑，就是因
為我們設定了環境變數CMAKE_INCLUDE_PATH。
如果你不使用FIND_PATH，CMAKE_INCLUDE_PATH變數的設定是沒有作用的，你不能指
望它會直接為編譯器命令新增引數-I。
以此為例，CMAKE_LIBRARY_PATH可以用在FIND_LIBRARY中。
同樣，因為這些變數直接為FIND_指令所使用，所以所有使用FIND_指令的cmake模組都
會受益。

系統資訊

• CMAKE_MAJOR_VERSION cmake主版本號,如3.2.2中的3
• CMAKE_MINOR_VERSION cmake次版本號,如3.2.2中的2
• CMAKE_PATCH_VERSION cmake補丁等級,如3.2.2中的2
• 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
• WIN32 在所有的win32平臺為TRUE,包括cygwin

開關選項

• 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

變數的使用

• 在CMakeLists.txt中指定，使用set
• cmake命令中使用，如cmake -DBUILD_SHARED_LIBS=OFF