CMake 基礎

簡單的語法
•註釋
# 我是註釋•命令語法
COMMAND(參數1 參數2 ...)
•字符串列表
A;B;C # 分號分割或空格分隔的值
•變量(字符串或字符串列表)
set(Foo a b c)
 設置變量 Foo
 
command(${Foo})
 等價於 command(a b c)
command("${Foo}")
 等價於 command("a b c")
command("/${Foo}")
 轉義，和 a b c無關聯
 
•流控制結構
IF()...ELSE()/ELSEIF()...ENDIF()
WHILE()...ENDWHILE()
FOREACH()...ENDFOREACH()

•正則表達式
部分經常使用命令
INCLUDE_DIRECTORIES( "dir1" "dir2" ... )
 頭文件路徑，至關於編譯器參數 -Idir1 -Idir2
 
LINK_DIRECTORIES("dir1" "dir2")
 庫文件路徑。注意：
因爲歷史緣由，相對路徑會原樣傳遞給連接器。
儘可能使用FIND_LIBRARY而避免使用這個。
 
AUX_SOURCE_DIRECTORY( 「sourcedir」 variable)
 收集目錄中的文件名並賦值給變量
 
ADD_EXECUTABLE
 可執行程序目標
 
ADD_LIBRARY
 庫目標
 
ADD_CUSTOM_TARGET
 自定義目標
 
ADD_DEPENDENCIES( target1 t2 t3 )
 目標target1依賴於t2 t3
 
ADD_DEFINITIONS( "-Wall -ansi")
 本意是供設置 -D... /D... 等編譯預處理須要的宏定義參數，對比 REMOVE_DEFINITIONS()
 
TARGET_LINK_LIBRARIES( target-name lib1 lib2 ...)
 設置單個目標須要連接的庫
 
LINK_LIBRARIES( lib1 lib2 ...)
 設置全部目標須要連接的庫
 
SET_TARGET_PROPERTIES( ... )
 設置目標的屬性 OUTPUT_NAME, VERSION, ....
 
MESSAGE(...)
  
INSTALL( FILES 「f1」 「f2」DESTINATION . )
 DESTINATION 相對於 ${CMAKE_INSTALL_PREFIX}
 
SET( VAR value [CACHE TYPE DOCSTRING [FORCE]])
  
LIST( APPEND|INSERT|LENGTH|GET| REMOVE_ITEM|REMOVE_AT|SORT ...)
 列表操做
 
STRING( TOUPPER|TOLOWER|LENGTH| SUBSTRING|REPLACE|REGEX ...)
 字符串操做
 
SEPARATE_ARGUMENTS( VAR )
 轉換空格分隔的字符串到列表
 
FILE( WRITE|READ|APPEND|GLOB| GLOB_RECURSE|REMOVE|MAKE_DIRECTORY ...)
 文件操做
 
FIND_FILE
 注意 CMAKE_INCLUDE_PATH
 
FIND_PATH
 注意 CMAKE_INCLUDE_PATH
 
FIND_LIBRARY
 注意 CMAKE_LIBRARY_PATH
 
FIND_PROGRAM
  
FIND_PACKAGE
 注意 CMAKE_MODULE_PATH
 
EXEC_PROGRAM( bin [work_dir] ARGS <..> [OUTPUT_VARIABLE var] [RETURN_VALUE var] )
 執行外部程序
 
OPTION( OPTION_VAR 「description」 [initial value] )
  
變量
工程路徑
•CMAKE_SOURCE_DIR
•PROJECT_SOURCE_DIR
•<projectname>_SOURCE_DIR
這三個變量指代的內容是一致的，是工程頂層目錄

•CMAKE_BINARY_DIR
•PROJECT_BINARY_DIR
•<projectname>_BINARY_DIR
這三個變量指代的內容是一致的，若是是in source編譯，指得就是工程頂層目錄，若是 是out-of-source編譯，指的是工程編譯發生的目錄

•CMAKE_CURRENT_SOURCE_DIR
指的是當前處理的CMakeLists.txt所在的路徑。

•CMAKE_CURRRENT_BINARY_DIR
若是是in-source編譯，它跟CMAKE_CURRENT_SOURCE_DIR一致，若是是out-ofsource 編譯，他指的是target編譯目錄。

•CMAKE_CURRENT_LIST_FILE
輸出調用這個變量的CMakeLists.txt的完整路徑

CMAKE_BUILD_TYPE
控制 Debug 和 Release 模式的構建

•CMakeList.txt文件
SET(CMAKE_BUILD_TYPE Debug)
•命令行參數
cmake DCMAKE_BUILD_TYPE=Release編譯器參數
•CMAKE_C_FLAGS
•CMAKE_CXX_FLAGS
也能夠經過指令ADD_DEFINITIONS()添加

CMAKE_INCLUDE_PATH
配合 FIND_FILE() 以及 FIND_PATH() 使用。若是頭文件沒有存放在常規路徑(/usr/include, /usr/local/include等)，
則能夠經過這些變量就行彌補。若是不使用 FIND_FILE 和 FIND_PATH的話，CMAKE_INCLUDE_PATH，沒有任何做用。

•CMAKE_LIBRARY_PATH
配合 FIND_LIBRARY() 使用。不然沒有任何做用

•CMAKE_MODULE_PATH
cmake 爲上百個軟件包提供了查找器(finder):FindXXXX.cmake

當使用非cmake自帶的finder時，須要指定finder的路徑，這就是CMAKE_MODULE_PATH，配合 FIND_PACKAGE()使用
CMAKE_INSTALL_PREFIX
控制make install是文件會安裝到什麼地方。默認定義是/usr/local 或 %PROGRAMFILES%

BUILD_SHARED_LIBS
若是不進行設置，使用ADD_LIBRARY且沒有指定庫類型，默認編譯生成的庫是靜態庫。

UNIX 與 WIN32 •UNIX，在全部的類UNIX平臺爲TRUE，包括OS X和cygwin •WIN32，在全部的win32平臺爲TRUE，包括cygwin