![[轉(zhuǎn)載]閱讀 <wbr>CMakeLists](http://image62.360doc.com/DownloadImg/2013/07/0615/33643929_3.gif "[轉(zhuǎn)載]閱讀 <wbr>CMakeLists")
樓主最近幾天被Orz和PageGeometry弄得有點(diǎn)頭大，需要通過源碼 + CMakeLists
來建立工程和sln，但是到底CMakeLists.txt 里寫的是些什么東西呢。
【語法】
注釋 #
:
#我是注釋
命令語法 COMMAND：
COMMAND(參數(shù)1
參數(shù)2 ...)
字符串列
A;B;C
//分號分割或空格分隔的值
變量
set(Foo a b
c)
// 設(shè)置變量 Foo
command(${Foo})
//等價(jià)于 command(a b c)
command("${Foo}") // 等價(jià)于 command("a b c")
command("/${Foo}") // 轉(zhuǎn)義，和 a b c無關(guān)聯(lián)
流控制結(jié)構(gòu)
IF()...ELSE() /ELSEIF()...ENDIF()
WHILE()...ENDWHILE()
FOREACH()...ENDFOREACH()
【常用命令】
（按A~Z排列）
ADD_EXECUTABLE
add_exectuable : 工程生成一個可執(zhí)行文件。
add_executable(hello ${SRC_LIST})
//生成一個名為hello.exe的可執(zhí)行文件
ADD_LIBRARY
add_library : 生成一個庫文件。
add_library(libhello
${LIB_SRC})
//生成libhello.lib文件
add_library(libhello SHARED ${LIB_SRC})
//生成動態(tài)庫文件
ADD_CUSTOM_TARGET
自定義目標(biāo)，生成一個自定義文件類型
add_subdirectory ：增加子文件夾，2個參數(shù)的話就是
源→目標(biāo) 文件夾生成對應(yīng)
add_subdirectory(src) ：建立src子文件夾
add_subdirectory(src
bin) ：在cmake目標(biāo)文件夾中與源文件夾對應(yīng)
src→bin文件夾
ADD_DEPENDENCIES( target1 t2 t3
)
目標(biāo)target1依賴于t2 t3
ADD_DEFINITIONS( "-Wall
-ansi")
本意是供設(shè)置 -D... /D... 等編譯預(yù)處理需要的宏定義參數(shù)，對比 REMOVE_DEFINITIONS()
AUX_SOURCE_DIRECTORY ( “sourcedir”
variable)
收集目錄中的文件名并賦值給變量
EXEC_PROGRAM ( bin [work_dir] ARGS
<..> [OUTPUT_VARIABLE var]
[RETURN_VALUE var] )
執(zhí)行外部程序
FILE ( WRITE|READ|APPEND|GLOB|
GLOB_RECURSE|REMOVE|MAKE_DIRECTORY ...)
文件操作
FIND_FILE
FIND_PATH
FIND_LIBRARY
FIND_PACKAGE
上述4個注意 CMAKE_LIBRARY_PATH
FIND_PROGRAM
INCLUDE_DIRECTORIES ( "dir1" "dir2" ...
)
include_directories :
包含指定目錄下的指定文件夾
include_directories(${PROJECT_SOURCE_DIR}/libhello)
//包含當(dāng)前目錄下的libhello文件夾
INSTALL ( FILES “f1” “f2”DESTINATION .
)
DESTINATION （目標(biāo)文件夾）相對于
${CMAKE_INSTALL_PREFIX}
LINK_DIRECTORIES ("dir1"
"dir2")
庫文件路徑。注意：由于歷史原因，相對路徑會原樣傳遞給鏈接器。盡量使用FIND_LIBRARY而避免使用這個。
LINK_LIBRARIES ( lib1 lib2
...)
設(shè)置所有目標(biāo)需要鏈接的庫
LIST ( APPEND|INSERT|LENGTH|GET|
REMOVE_ITEM|REMOVE_AT|SORT ...)
列表操作
MESSAGE (...)
輸出信息，方便檢查調(diào)試
message(${PROJECT_SOURCE_DIR})
project
建立一個工程
project
不是強(qiáng)制性的，但最好始終都加上。這一行會引入兩個變量
HELLO_BINARY_DIR 和 HELLO_SOURCE_DIR
同時，cmake自動定義了兩個等價(jià)的變量
PROJECT_BINARY_DIR
和 PROJECT_SOURCE_DIR
如果是out-of-source方式構(gòu)建（源代碼和生成的中間產(chǎn)物分離），所以要時刻區(qū)分這兩個變量對應(yīng)的目錄
SET
set (SRC_LIST
hello.cpp) //源文件列表 hello.cpp
set (APP_SRC
main.c)
//語義基本同上，具體不太了解
set (EXECUTABLE_OUTPUT_PATH
${PROJECT_BINARY_DIR}/bin)
//指定生成hello.exe到目標(biāo)文件夾
SET_TARGET_PROPERTIES ( ... )：
設(shè)置目標(biāo)的屬性 OUTPUT_NAME, VERSION, ....
set_target_properties(libhello PROPERTIES OUTPUT_NAME
"hello") //使libhello.lib輸出文件名為hello.exe
SEPARATE_ARGUMENTS ( VAR
)
轉(zhuǎn)換空格分隔的字符串到列表
STRING ( TOUPPER|TOLOWER|LENGTH|
SUBSTRING|REPLACE|REGEX ...)
字符串操作
TARGET_LINK_LIBRARIES ( target-name lib1
lib2 ...)
target_link_libraries
: 將指定庫文件鏈接到某個執(zhí)行文件
target_link_libraries(hello
libhello)
//將libhello.lib文件鏈接到hello.exe
【常見變量】
----工程路徑------
CMAKE_SOURCE_DIR
PROJECT_SOURCE_DIR
<projectname>_SOURCE_DIR
這三個變量指代的內(nèi)容是一致的，是工程頂層目錄
CMAKE_BINARY_DIR
PROJECT_BINARY_DIR
<projectname>_BINARY_DIR
這三個變量指代的內(nèi)容是一致的，如果是in
source編譯，指得就是工程頂層目錄，如果
是out-of-source編譯，指的是工程編譯發(fā)生的目錄
CMAKE_CURRENT_SOURCE_DIR
指的是當(dāng)前處理的CMakeLists.txt所在的路徑。
CMAKE_CURRRENT_BINARY_DIR
如果是in-source編譯，它跟CMAKE_CURRENT_SOURCE_DIR一致，如果是out-ofsource
編譯，他指的是target編
譯目錄。
CMAKE_CURRENT_LIST_FILE
輸出調(diào)用這個變量的CMakeLists.txt的完整路徑
----CMAKE_BUILD_TYPE-----
控制 Debug 和 Release 模式的構(gòu)建
CMakeList.txt文件
SET(CMAKE_BUILD_TYPE Debug)?命令行參數(shù)
cmake DCMAKE_BUILD_TYPE=Relea
-----編譯器參數(shù)-----
CMAKE_C_FLAGS
CMAKE_CXX_FLAGS
也可以通過指令A(yù)DD_DEFINITIONS()添加
CMAKE_INCLUDE_PATH
配合
FIND_FILE() 以及 FIND_PATH() 使用。如果頭文件沒有存放在常規(guī)路徑/usr/include,
/usr/local/include等)，
則可以通過這些變量就行彌補(bǔ)。如果不使用 FIND_FILE 和
FIND_PATH的話，CMAKE_INCLUDE_PATH，沒有任何作
用。
CMAKE_LIBRARY_PATH
配合 FIND_LIBRARY() 使用。否則沒有任何作用
CMAKE_MODULE_PATH
cmake 為上百個軟件包提供了查找器(finder):FindXXXX.cmake
當(dāng)使用非cmake自帶的finder時，需要指定finder的路徑，這就是CMAKE_MODULE_PATH，配合
FIND_PACKAGE
()使用
CMAKE_INSTALL_PREFIX
控制make
install是文件會安裝到什么地方。默認(rèn)定義是/usr/local 或 %PROGRAMFILES%
BUILD_SHARED_LIBS
如果不進(jìn)行設(shè)置，使用ADD_LIBRARY且沒有指定庫類型，默認(rèn)編譯生成的庫是靜態(tài)庫。
UNIX 與
WIN32
UNIX，在所有的類UNIX平臺為TRUE，包括OS X和cygwin
WIN32，在所有的win32平臺為TRUE，包括cygwin
更多CMake信息參考
學(xué)習(xí)如何寫CMakeLists參考如下網(wǎng)址，寫的不錯
