【正文】 [COMMENT ment] [VERBATIM] [APPEND])　　這種命令格式定義了一條生成指定的文件（文件組）的生成命令。在相同路徑下創(chuàng)建的目標(biāo)（）——任何自定義命令的輸出都作為它的源文件——被設(shè)置了一條規(guī)則：在構(gòu)建的時(shí)候，使用指定的命令來(lái)生成這些文件。如果一個(gè)輸出文件名是相對(duì)路徑，它將被解釋成相對(duì)于構(gòu)建樹(shù)路徑的相對(duì)路徑，并且與當(dāng)前源碼路徑是對(duì)應(yīng)的。注意，MAIN_DEPENDENCY完全是可選的，它用來(lái)向visual studio建議在何處停止自定義命令。對(duì)于各種類(lèi)型的makefile而言，這條命令創(chuàng)建了一個(gè)格式如下的新目標(biāo)： OUTPUT: MAIN_DEPENDENCY DEPENDS　　　　COMMAND　　如果指定了多于一條的命令，它們會(huì)按順序執(zhí)行。ARGS參數(shù)是可選的，它的存在是為了保持向后兼容，以后會(huì)被忽略掉?！　〉诙N格式為一個(gè)目標(biāo)——比如一個(gè)庫(kù)文件或者可執(zhí)行文件——添加一條自定義命令。這種格式可以用于目標(biāo)構(gòu)建前或構(gòu)建后的一些操作。這條命令會(huì)成為目標(biāo)的一部分，并且只有目標(biāo)被構(gòu)建時(shí)才會(huì)執(zhí)行。如果目標(biāo)已經(jīng)構(gòu)建了，該目標(biāo)將不會(huì)執(zhí)行。 add_custom_mand(TARGET target PRE_BUILD | PRE_LINK | POST_BUILD COMMAND mand1 [ARGS] [args1...] [COMMAND mand2 [ARGS] [args2...] ...] [WORKING_DIRECTORY dir] [COMMENT ment] [VERBATIM])　　這條命令定義了一個(gè)與指定目標(biāo)的構(gòu)建過(guò)程相關(guān)的新命令。新命令在何時(shí)執(zhí)行，由下述的選項(xiàng)決定： PRE_BUILD 在所有其它的依賴(lài)之前執(zhí)行； PRE_LINK 在所有其它的依賴(lài)之后執(zhí)行； POST_BUILD 在目標(biāo)被構(gòu)建之后執(zhí)行；　　注意，只有Visual Studio 7或更高的版本才支持PRE_BUILD。對(duì)于其他的生成器，PRE_BUILD會(huì)被當(dāng)做PRE_LINK來(lái)對(duì)待?！　∪绻付薟ORKING_DIRECTORY選項(xiàng)，這條命令會(huì)在給定的路徑下執(zhí)行。如果設(shè)置了COMMENT選項(xiàng)，后跟的參數(shù)會(huì)在構(gòu)建時(shí)、以構(gòu)建信息的形式、在命令執(zhí)行之前顯示出來(lái)。如果指定了APPEND選項(xiàng)，COMMAND以及DEPENDS選項(xiàng)的值會(huì)附加到第一個(gè)輸出文件的自定義命令上。在此之前，必須有一次以相同的輸出文件作為參數(shù)的對(duì)該命令的調(diào)用。在當(dāng)前版本下，如果指定了APPEND選項(xiàng)，COMMENT, WORKING_DIRECTORY和MAIN_DEPENDENCY選項(xiàng)會(huì)被忽略掉，不過(guò)未來(lái)有可能會(huì)用到?！　∪绻付薞ERBATIM選項(xiàng)，所有該命令的參數(shù)將會(huì)合適地被轉(zhuǎn)義，以便構(gòu)建工具能夠以原汁原味的參數(shù)去調(diào)用那些構(gòu)建命令。注意，在add_custom_mand能看到這些參數(shù)之前，CMake語(yǔ)言處理器會(huì)對(duì)這些參數(shù)做一層轉(zhuǎn)義處理。推薦使用VERBATIM參數(shù)，因?yàn)樗軌虮ＷC正確的行為。當(dāng)VERBATIM未指定時(shí)，CMake的行為依賴(lài)于平臺(tái)，因?yàn)镃Make沒(méi)有針對(duì)某一種工具的特殊字符采取保護(hù)措施?！　∪绻远x命令的輸出并不是實(shí)際的磁盤(pán)文件，應(yīng)該使用SET_SOURCE_FILES_PROPERTIES命令將該輸出的屬性標(biāo)記為SYMBOLIC?！　MPLICIT_DEPENDS選項(xiàng)請(qǐng)求掃描一個(gè)輸入文件的隱含依賴(lài)關(guān)系。給定的語(yǔ)言參數(shù)（文中的lang1—譯注）指定了應(yīng)該使用哪種編程語(yǔ)言的依賴(lài)掃描器。目前為止，僅支持C和CXX語(yǔ)言?huà)呙杵?。掃描中發(fā)現(xiàn)的依賴(lài)文件將會(huì)在編譯時(shí)添加到自定義命令中。注意，IMPLICIT_DEPENDS選項(xiàng)目前僅僅直至Makefile生成器，其它的生成器會(huì)忽略之。　　如果COMMAND選項(xiàng)指定了一個(gè)可執(zhí)行目標(biāo)（由ADD_EXECUTABLE命令創(chuàng)建的目標(biāo)），在構(gòu)建時(shí)，它會(huì)自動(dòng)被可執(zhí)行文件的位置所替換。而且，一個(gè)目標(biāo)級(jí)的依賴(lài)性將會(huì)被添加進(jìn)去，這樣這個(gè)可執(zhí)行目標(biāo)將會(huì)在所有依賴(lài)于該自定義命令的結(jié)果的目標(biāo)之前被構(gòu)建。不過(guò)，任何時(shí)候重編譯這個(gè)可執(zhí)行文件，這種特性并不會(huì)引入一個(gè)會(huì)引起自定義命令重新運(yùn)行的文件級(jí)依賴(lài)。　　DEPENDS選項(xiàng)指定了該命令依賴(lài)的文件。如果依賴(lài)的對(duì)象是同一目錄（）下另外一個(gè)自定義命令的輸出，CMake會(huì)自動(dòng)將其它自定義命令帶到這個(gè)命令中來(lái)。如果DEPENDS指定了任何類(lèi)型的目標(biāo)（由ADD_*命令創(chuàng)建），一個(gè)目標(biāo)級(jí)的依賴(lài)性將會(huì)被創(chuàng)建，以保證該目標(biāo)在任何其它目標(biāo)使用這個(gè)自定義命令的輸出之前，該目標(biāo)已經(jīng)被創(chuàng)建了。而且，如果該目標(biāo)是可執(zhí)行文件或庫(kù)文件，一個(gè)文件級(jí)依賴(lài)將會(huì)被創(chuàng)建，用來(lái)引發(fā)自定義命令在目標(biāo)被重編譯時(shí)的重新運(yùn)行。=======================================================在Unix Makefile中，這條命令相當(dāng)于增加了一個(gè)依賴(lài)關(guān)系和一條顯式生成命令。CMD2: add_custom_target添加一個(gè)目標(biāo)，它沒(méi)有輸出；這樣它就總是會(huì)被構(gòu)建。 add_custom_target(Name [ALL] [mand1 [args1...]] [COMMAND mand2 [args2...] ...] [DEPENDS depend depend depend ... ] [WORKING_DIRECTORY dir] [COMMENT ment] [VERBATIM] [SOURCES src1 [src2...]])　　用Name選項(xiàng)給定的名字添加一個(gè)目標(biāo)，這個(gè)目標(biāo)會(huì)引發(fā)給定的那些命令。這個(gè)目標(biāo)沒(méi)有輸出文件，并且總是被認(rèn)為是過(guò)時(shí)的，即使那些命令試圖去創(chuàng)建一個(gè)與該目標(biāo)同名的文件。使用ADD_CUSTOM_COMMAND命令可以生成一個(gè)帶有依賴(lài)性的文件。默認(rèn)情況下，沒(méi)有目標(biāo)會(huì)依賴(lài)于自定義目標(biāo)。使用ADD_DEPENDENCIES命令可以添加依賴(lài)于該目標(biāo)或者被該目標(biāo)依賴(lài)的目標(biāo)。如果指定了ALL選項(xiàng)，這表明這個(gè)目標(biāo)應(yīng)該被添加到默認(rèn)的構(gòu)建目標(biāo)中，這樣它每次都會(huì)被構(gòu)建（命令的名字不能是ALL）。命令和選項(xiàng)是可選的；如果它們沒(méi)有被指定，將會(huì)產(chǎn)生一個(gè)空目標(biāo)。如果設(shè)定了WORKING_DIRECTORY參數(shù)，該命令會(huì)在它指定的路徑下執(zhí)行。如果指定了COMMENT選項(xiàng)，后跟的參數(shù)將會(huì)在構(gòu)件的時(shí)候，在命令執(zhí)行之前，被顯示出來(lái)。DEPENDS選項(xiàng)后面列出來(lái)的依賴(lài)目標(biāo)可以引用add_custom_mand命令在相同路徑下（）生成的輸出和文件?！　∪绻付薞ERBATIM選項(xiàng)，所有傳遞到該命令的選項(xiàng)將會(huì)被合適地轉(zhuǎn)義；這樣，該命令調(diào)用的構(gòu)建工具會(huì)接收到未經(jīng)改變的參數(shù)。注意，CMake語(yǔ)言處理器會(huì)在add_custom_target命令在看到這些參數(shù)之前對(duì)它們進(jìn)行一層轉(zhuǎn)義。推薦使用該參數(shù)，因?yàn)樗ＷC了正確的行為。當(dāng)未指定該參數(shù)時(shí)，轉(zhuǎn)義的行為依賴(lài)于平臺(tái)，因?yàn)镃Make沒(méi)有針對(duì)于特定工具中特殊字符的保護(hù)措施。　　SOURCES選項(xiàng)指定了會(huì)被包含到自定義目標(biāo)中的附加的源文件。指定的源文件將會(huì)被添加到IDE的工程文件中，方便在沒(méi)有構(gòu)建規(guī)則的情況下能夠編輯。CMD3:add_definitions 為源文件的編譯添加由D引入的define flag。 add_definitions(DFOO DBAR ...)　　在編譯器的命令行上，為當(dāng)前路徑以及下層路徑的源文件加入一些define flag。這個(gè)命令可以用來(lái)引入任何flag，但是它的原意是用來(lái)引入預(yù)處理器的定義。那些以D或/D開(kāi)頭的、看起來(lái)像預(yù)處理器定義的flag，會(huì)被自動(dòng)加到當(dāng)前路徑的COMPILE_DEFINITIONS屬性中。為了后向兼容，非簡(jiǎn)單值（nontrival，指的是什么？——譯注）的定義會(huì)被留在flags組（flags set）里，而不會(huì)被轉(zhuǎn)換。關(guān)于在特定的域以及配置中增加預(yù)處理器的定義，參考路徑、目標(biāo)以及源文件的COMPILE_DEFINITIONS屬性來(lái)獲取更多的細(xì)節(jié)。CMD4:add_dependencies 為頂層目標(biāo)引入一個(gè)依賴(lài)關(guān)系。 add_dependencies(targetname dependtarget1 dependtarget2 ...)　　讓一個(gè)頂層目標(biāo)依賴(lài)于其他的頂層目標(biāo)。一個(gè)頂層目標(biāo)是由命令A(yù)DD_EXECUTABLE，ADD_LIBRARY，或者ADD_CUSTOM_TARGET產(chǎn)生的目標(biāo)。為這些命令的輸出引入依賴(lài)性可以保證某個(gè)目標(biāo)在其他的目標(biāo)之前被構(gòu)建。查看ADD_CUSTOM_TARGET和ADD_CUSTOM_COMMAND命令的DEPENDS選項(xiàng)，可以了解如何根據(jù)自定義規(guī)則引入文件級(jí)的依賴(lài)性。查看SET_SOURCE_FILES_PROPERTIES命令的OBJECT_DEPENDS選項(xiàng)，可以了解如何為目標(biāo)文件引入文件級(jí)的依賴(lài)性。CMD5:add_executable: 使用給定的源文件，為工程引入一個(gè)可執(zhí)行文件。 add_executable(name [WIN32] [MACOSX_BUNDLE] [EXCLUDE_FROM_ALL] source1 source2 ... sourceN)　　引入一個(gè)名為name的可執(zhí)行目標(biāo)，該目標(biāo)會(huì)由調(diào)用該命令時(shí)在源文件列表中指定的源文件來(lái)構(gòu)建。name對(duì)應(yīng)于邏輯目標(biāo)名字，并且在工程范圍內(nèi)必須是全局唯一的。被構(gòu)建的可執(zhí)行目標(biāo)的實(shí)際文件名將根據(jù)具體的本地平臺(tái)創(chuàng)建出來(lái)（比如name.exe或者僅僅是name）。　　默認(rèn)情況下，可執(zhí)行文件將會(huì)在構(gòu)建樹(shù)的路徑下被創(chuàng)建，對(duì)應(yīng)于該命令被調(diào)用的源文件樹(shù)的路徑。如果要改變這個(gè)位置，查看RUNTIME_OUTPUT_DIRECTORY目標(biāo)屬性的相關(guān)文檔。如果要改變最終文件名的name部分，查看OUTPUT_NAME目標(biāo)屬性的相關(guān)文檔?！　∪绻付薓ACOSX_BUNDLE選項(xiàng)，對(duì)應(yīng)的屬性會(huì)附加在創(chuàng)建的目標(biāo)上。查看MACOSX_BUNDLE目標(biāo)屬性的文檔可以找到更多的細(xì)節(jié)。　　如果指定了EXCLUDE_FROM_ALL選項(xiàng)，對(duì)應(yīng)的屬性將會(huì)設(shè)置在被創(chuàng)建的目標(biāo)上。查看EXCLUDE_FROM_ALL目標(biāo)屬性的文檔可以找到更多的細(xì)節(jié)?！　∈褂孟率龈袷剑琣dd_executable命令也可以用來(lái)創(chuàng)建導(dǎo)入的（IMPORTED）可執(zhí)行目標(biāo)：　　add_executable(name IMPORTED)　　一個(gè)導(dǎo)入的可執(zhí)行目標(biāo)引用了一個(gè)位于工程之外的可執(zhí)行文件。該格式不會(huì)生成構(gòu)建這個(gè)目標(biāo)的規(guī)則。該目標(biāo)名字的作用域在它被創(chuàng)建的路徑以及底層路徑有效。它可以像在該工程內(nèi)的其他任意目標(biāo)一樣被引用。導(dǎo)入可執(zhí)行文件為類(lèi)似于add_custom_mand之類(lèi)的命令引用它提供了便利?！　￡P(guān)于導(dǎo)入的可執(zhí)行文件的細(xì)節(jié)可以通過(guò)設(shè)置以IMPORTED_開(kāi)頭的屬性來(lái)指定。這類(lèi)屬性中最重要的是IMPORTED_LOCATION（以及它對(duì)應(yīng)于具體配置的版本IMPORTED_LOCATION_CONFIG）；該屬性指定了執(zhí)行文件主文件在磁盤(pán)上的位置。查看IMPORTED_*屬性的文檔來(lái)獲得更多信息。CMD6:add_library使用指定的源文件向工程中添加一個(gè)庫(kù)。 add_library(name [STATIC | SHARED | MODULE] [EXCLUDE_FROM_ALL] source1 source2 ... sourceN)　　添加一個(gè)名為name的庫(kù)文件，該庫(kù)文件將會(huì)根據(jù)調(diào)用的命令里列出的源文件來(lái)創(chuàng)建。name對(duì)應(yīng)于邏輯目標(biāo)名稱(chēng)，而且在一個(gè)工程的全局域內(nèi)必須是唯一的。待構(gòu)建的庫(kù)文件的實(shí)際文件名根據(jù)對(duì)應(yīng)平臺(tái)的命名約定來(lái)構(gòu)造（比如libname.a或者name.lib）。指定STATIC，SHARED，或者M(jìn)ODULE參數(shù)用來(lái)指定要?jiǎng)?chuàng)建的庫(kù)的類(lèi)型。STATIC庫(kù)是目標(biāo)文件的歸檔文件，在鏈接其它目標(biāo)的時(shí)候使用。SHARED庫(kù)會(huì)被動(dòng)態(tài)鏈接，在運(yùn)行時(shí)被加載。MODULE庫(kù)是不會(huì)被鏈接到其它目標(biāo)中的插件，但是可能會(huì)在運(yùn)行時(shí)使用dlopen系列的函數(shù)動(dòng)態(tài)鏈接。如果沒(méi)有類(lèi)型被顯式指定，這個(gè)選項(xiàng)將會(huì)根據(jù)變量BUILD_SHARED_LIBS的當(dāng)前值是否為真決定是STATIC還是SHARED?！　∧J(rèn)狀態(tài)下，庫(kù)文件將會(huì)在于源文件目錄樹(shù)的構(gòu)建目錄樹(shù)的位置被創(chuàng)建，該命令也會(huì)在這里被調(diào)用。查閱ARCHIVE_OUTPUT_DIRECTORY，LIBRARY_OUTPUT_DIRECTORY，和RUNTIME_OUTPUT_DIRECTORY這三個(gè)目標(biāo)屬性的文檔來(lái)改變這一位置。查閱OUTPUT_NAME目標(biāo)屬性的文檔來(lái)改變最終文件名的name部分?！　∪绻付薊XCLUDE_FROM_ALL屬性，對(duì)應(yīng)的一些屬性會(huì)在目標(biāo)被創(chuàng)建時(shí)被設(shè)置。查閱EXCLUDE_FROM_ALL的文檔來(lái)獲取該屬性的細(xì)節(jié)。　　使用下述格式，add_library命令也可以用來(lái)創(chuàng)建導(dǎo)入的庫(kù)目標(biāo)： 　　add_library(name SHARED|STATIC|MODULE|UNKNOWN IMPORTED)　　導(dǎo)入的庫(kù)目標(biāo)是引用了在工程外的一個(gè)庫(kù)文件的目標(biāo)。沒(méi)有生成構(gòu)建這個(gè)庫(kù)的規(guī)則。這個(gè)目標(biāo)名字的作用域在它被創(chuàng)建的路徑及以下有效。他可以向任何在該工程內(nèi)構(gòu)建的目標(biāo)一樣被引用。導(dǎo)入庫(kù)為類(lèi)似于target_link_libraries命令中引用它提供了便利。關(guān)于導(dǎo)入庫(kù)細(xì)節(jié)可以通過(guò)指定那些以IMPORTED_的屬性設(shè)置來(lái)指定。其中最重要的屬性是IMPORTED_LOCATION（以及它的具體配置版本，IMPORTED_LOCATION_CONFIG），它指定了主庫(kù)文件在磁盤(pán)上的位置。查閱IMPORTED_*屬性的文檔獲取更多的信息。CMD7:add_subdirectory 為構(gòu)建添加一個(gè)子路徑。 add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL])　　這條命令的作用是為構(gòu)建添加一個(gè)子路徑。如果source_dir是一個(gè)相對(duì)路徑，那么source_dir選項(xiàng)會(huì)被解釋為相對(duì)于當(dāng)前的目錄，但是它也可以是一個(gè)絕對(duì)路徑。binary_dir選項(xiàng)指定了輸出文件的路徑。如果binary_dir是相對(duì)路徑，它將會(huì)被解釋為相對(duì)于當(dāng)前輸出路徑，但是它也可以是一個(gè)絕對(duì)路徑。如果沒(méi)