【正文】 在子路徑下的目標，比如一些示范性的例子工程就是這樣。如果binary_dir是相對路徑，它將會被解釋為相對于當前輸出路徑，但是它也可以是一個絕對路徑。為構建添加一個子路徑。其中最重要的屬性是IMPORTED_LOCATION（以及它的具體配置版本，IMPORTED_LOCATION_CONFIG），它指定了主庫文件在磁盤上的位置。這個目標名字的作用域在它被創(chuàng)建的路徑及以下有效?！　∪绻付薊XCLUDE_FROM_ALL屬性，對應的一些屬性會在目標被創(chuàng)建時被設置。如果沒有類型被顯式指定，這個選項將會根據變量BUILD_SHARED_LIBS的當前值是否為真決定是STATIC還是SHARED。指定STATIC，SHARED，或者MODULE參數用來指定要創(chuàng)建的庫的類型。使用指定的源文件向工程中添加一個庫?！　￡P于導入的可執(zhí)行文件的細節(jié)可以通過設置以IMPORTED_開頭的屬性來指定。該格式不會生成構建這個目標的規(guī)則?！　∪绻付薊XCLUDE_FROM_ALL選項，對應的屬性將會設置在被創(chuàng)建的目標上。如果要改變這個位置，查看RUNTIME_OUTPUT_DIRECTORY目標屬性的相關文檔。 add_executable(name [WIN32] [MACOSX_BUNDLE] [EXCLUDE_FROM_ALL] source1 source2 ... sourceN)　　引入一個名為name的可執(zhí)行目標，該目標會由調用該命令時在源文件列表中指定的源文件來構建。為這些命令的輸出引入依賴性可以保證某個目標在其他的目標之前被構建。CMD4:add_dependencies這個命令可以用來引入任何flag，但是它的原意是用來引入預處理器的定義。指定的源文件將會被添加到IDE的工程文件中，方便在沒有構建規(guī)則的情況下能夠編輯。注意，CMake語言處理器會在add_custom_target命令在看到這些參數之前對它們進行一層轉義。如果設定了WORKING_DIRECTORY參數，該命令會在它指定的路徑下執(zhí)行。默認情況下，沒有目標會依賴于自定義目標。添加一個目標，它沒有輸出；這樣它就總是會被構建。如果依賴的對象是同一目錄（）下另外一個自定義命令的輸出，CMake會自動將其它自定義命令帶到這個命令中來。　　如果COMMAND選項指定了一個可執(zhí)行目標（由ADD_EXECUTABLE命令創(chuàng)建的目標），在構建時，它會自動被可執(zhí)行文件的位置所替換。給定的語言參數（文中的lang1—譯注）指定了應該使用哪種編程語言的依賴掃描器。推薦使用VERBATIM參數，因為它能夠保證正確的行為。在此之前，必須有一次以相同的輸出文件作為參數的對該命令的調用。對于其他的生成器，PRE_BUILD會被當做PRE_LINK來對待。這條命令會成為目標的一部分，并且只有目標被構建時才會執(zhí)行。對于各種類型的makefile而言，這條命令創(chuàng)建了一個格式如下的新目標： OUTPUT: MAIN_DEPENDENCY DEPENDS　　　　COMMAND　　如果指定了多于一條的命令，它們會按順序執(zhí)行。 [COMMENT ment] [VERBATIM] [APPEND])　　這種命令格式定義了一條生成指定的文件（文件組）的生成命令。 [WORKING_DIRECTORY dir] [IMPLICIT_DEPENDS lang1 depend1 ...] [DEPENDS [depends...]] [MAIN_DEPENDENCY depend] [COMMAND mand2 [ARGS] [args2...] ...] COMMAND mand1 [ARGS] [args1...] add_custom_mand(OUTPUT output1 [output2 ...]add_custom_mand這些命令在手冊中是字典序排列的；為了便于查找，翻譯也按照字典序來組織。CMake手冊的客套話總算說完了，開始進入正題。在運行源碼外構建時，一個連接到頂層源碼路徑的資源文件會被創(chuàng)建。makefile還提供了install目標。在頂層目錄下為Eclipse生成工程文件。通過默認的make目標，正確的make程序可以構建這個工程。 Eclipse CDT4 MinGW Makefiles: 生成Eclipse CDT 工程文件。除此之外還會在構建樹上生成一套層次性的makefile。makefile還提供了install目標。 CodeBlocks NMake Makefiles: 生成CodeBlocks工程文件。除此之外還會在構建樹上生成一套層次性的makefile。 Wat WMake: 生成Wat WMake makefiles。工程文件。 Visual Studio 7 .NET 2003: 生成Visual Studio .NET 2003工程文件。工程文件。 Visual Studio 10: 生成Visual Studio 10在構建樹上生成分層的UNIX makefile。生成的makefile用use /bin/sh作為它的shell。生成器　　在CMake ，CMake支持下列生成器：如果指定了[file]參數，幫助信息會寫到這個文件中。如果指定了[file]參數，幫助信息會寫到這個文件中。如果制定了[file]參數，幫助信息會寫到這個文件中。如果指定了[file]參數，版權信息會寫到這個文件中。如果指定了[file]參數，幫助信息會寫到file中，且輸出格式依賴于文件名后綴。支持的文件格式包括：man page，HTML，DocBook以及純文本。 helpvariable var [file]: 打印單個變量的幫助信息，然后退出。顯示所有屬性的完整文檔。如果指定了[file]參數，幫助信息會寫到file中，且輸出格式依賴于文件名后綴。支持的文件格式包括：man page，HTML，DocBook以及純文本。 helppolicies [file]: 打印所有策略的幫助信息，然后退出。顯示給定的策略的完整文檔。如果指定了[file]參數，幫助信息會寫到file中，且輸出格式依賴于文件名后綴。支持的文件格式包括：man page，HTML，DocBook以及純文本。 helpmodulelist [file]: 列出所有可用模塊名，然后退出。打印關于給定模塊的完整信息。如果指定了[file]參數，幫助信息會寫到file中，輸出格式依賴于文件名后綴。 helpmands [file]: 打印所有命令的幫助文件，然后退出。該選項列出的信息含有所有命令的名字；其中，每個命令的幫助信息可以使用helpmand選項后跟一個命令名字得到。如果指定了[file]參數，該文檔會寫入該文件，其輸出格式由該文件的后綴名確定。（這句話含義不是很確定—譯注。在cmake運行時，打印額外的信息；比如使用message(send_error)調用得到的棧跟蹤信息。不過，因為上一次“嘗試編譯”生成的舊的垃圾輸出文件也許會導致一次不正確通過/不通過，且該結果與上次測試的結果不同，所以該選項可能會改變“嘗試編譯”的結果。如果要使用D選項定義變量，D選項必須在P選項之前。運行不帶選項的cmake build來獲取快速幫助信息。 （如果僅僅要clean掉，使用target 39。 = 待創(chuàng)建的工程二進制路徑。如果指定了H選項，那么命令會顯示每個變量的幫助信息。　　L選項會列出緩存變量會運行CMake，并列出所有CMake的內有被標記為INTERNAL或者ADVANCED的緩存變量。　　向導模式是在沒有GUI時，交互式地運行cmake的模式?！　榱苏嬲龅脚c平臺無關，CMake提供了一系列可以用于所有系統(tǒng)上的的命令。　　。　　在具體的平臺上，CMake可以支持多個原生的構建系統(tǒng)。該選項可以重復多次以刪除期望數量的緩存條目。這個參數可以被重復多次，用來填充所需要數量的緩存條目(cache entries)。參數中給定的那個文件應該是一個CMake腳本，其中包含有使用CACHE選項的SET命令；而不是一個緩存格式的文件。C initialcache: 預加載一個腳本填充緩存文件。　　CMake是一個跨平臺的構建系統(tǒng)生成工具。用法　　cmake [選項] 源碼路徑　　cmake [選項] 現有構建路徑描述　　cmake可執(zhí)行程序是CMake的命令行界面。 提供信息的變量 改變行為的變量 兼容性命令 目標屬性 命令 用法另外，羅馬不是一天建成的，長長的手冊翻譯完也不知道要經歷多少日升月落；不過還是希望自己能夠堅持下去:)。同時在工作中也會閱讀CMake的真實源碼，后續(xù)會基于此陸續(xù)寫一些工程中使用CMake的心得。目前的計劃是先把官方手冊翻譯一下，了解清楚CMake中的各種命令、屬性和變量的用法。 作為園子里的新丁，文章在術語和表達等等方面會有欠缺的地方，還請大俠們慷慨指點。 命令名稱 生成器 目錄屬性 Cache Entries屬性 變量 控制構建的變量cmake 跨平臺Makefile生成工具。使用i選項，cmake將通過提示交互式地完成該設置。選項被加載的緩存條目比項目默認的值有更高的優(yōu)先權。這個選項可以用來指定優(yōu)先級高于工程的默認值的工程設置值。文件名匹配表達式(globbing expression)支持通配符*和?的使用。指定一個makefile生成工具。Wnodev: 抑制開發(fā)者警告。E: CMake命令行模式。i: 以向導模式運行CMake。L[A][H]: 列出緩存的變量中的非高級的變量。如果指定了A選項，那么命令也會顯示高級變量。（這個選項的含義我不是很清楚—譯注）該選項用以下的選項概括了內置構建工具的命令行界面 dir cleanfirst = 首先構建目標的clean偽目標，然后再構建。） = 向內置工具（native tools）傳遞剩余的選項。僅僅加載緩存信息，并不實際運行配置和生成步驟。不執(zhí)行配置和生成步驟，不修改緩存信息。生成一個graphviz軟件的輸入文件，其中包括了項目中所有庫和可執(zhí)行文件之間的依賴關系。如果在一個CMake工程的二進制構建樹的頂端運行該命令，它還會打印一些附加信息，例如緩存，日志文件等等。這在調試失敗的try_pile文件時比較有用。 debugoutput: 將cmake設置為調試模式。用message(send_error )調用，打印所有調用生成的跟蹤信息，以及這些調用發(fā)生的位置。顯示給定的命令的完整的文檔。 helpmandlist [file]: 列出所有可用命令的清單，然后退出。支持的文件格式包括：man page，HTML，DocBook以及純文本。顯示所有關于兼容性命令的完整文檔。 helpmodule module [file]: 打印某單一模塊的幫助信息，然后退出。支持的文件格式包括：man page，HTML，DocBook以及純文本。如果指定了[file]參數，幫助信息會寫到file中，且輸出格式依賴于文件名后綴。顯示所有自定義模塊的完整文檔。 helppolicy cmp [file]: 打印單個策略的幫助信息，然后退出。支持的文件格式包括：man page，HTML，DocBook以及純文本。如果指定了[file]參數，幫助信息會寫到file中，且輸出格式依賴于文件名后綴。該命令列出的清單包括所有屬性的名字；其中，每個屬性的幫助信息都可以通過helpproperty選項后跟一個屬性名的方式獲得。 helpproperties [file]: 打印所有屬性的幫助信息，然后退出。支持的文件格式包括：man page，HTML，DocBook以及純文本。如果指定了[file]參數，幫助信息會寫到file中，且輸出格式依賴于文件名后綴。顯示所有變量的完整幫助文檔。 copyright [file]: 打印CMake的版權信息，然后退出。用法信息描述了基本的命令行界面及其選項。該選項是為非UNIX平臺提供的；但是如果man手冊頁沒有安裝，它也能提供便利。CMake的作者使用該選來幫助生成web頁面。cmake使用該選生成UNIX的man手冊頁。如果指定了[file]參數，版本信息會寫到這個文件中。 MSYS Makefiles: 生成MSYS makefile。 MinGW Makefiles: 生成供mingw32make使用的make file。 NMake Makefiles: 生成NMake makefile。 Unix Makefiles: 生成標準的UNIX makefile。 Visual Studio 10 Win64: 生成Visual Studio 10 Win64工程文件。工程文件。 Visual Studio 9 2008: 生成Visual Studio 9 2008在頂層目錄以及每層子目錄下為CodeBlocks生成工程文件，()調用。通過默認的make目標，正確的make程序可以構建這個工程。在頂層目錄以及每層子目錄下為CodeBlocks生成工程文件，()調用。除此之外還會在構建樹上生成一套層次性的makefile。 Eclipse CDT4 NMake Makefiles: 生成Eclipse CDT 工程