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