【文章內容簡介】 文件向搜索路徑中添加二進制樹目錄 include_directories( ${CMAKE_CURRENT_BINARY_DIR} ) 添加main庫 add_library(MathFunctions ${CMAKE_CURRENT_BINARY_DIR}/) install (TARGETS MathFunctions DESTINATION bin) install (FILES DESTINATION include)構建一個安裝器（步驟6）　　下一步假設我們想要向其他人分發(fā)我們的工程，這樣他們就可以使用它。我們想同時提供在許多不同平臺上的源代碼和二進制文檔發(fā)行版。這與之前我們在“安裝與測試（步驟3）”做過的安裝有一點不同，那里我們僅僅安裝我們從源碼中構建出來的二進制文件。在本例子中，我們會構建支持二進制安裝以及類似于cygwin，debian，RPM等具有包管理特性的安裝包。為了完成這個目標，我們會使用CPack來創(chuàng)建Packaging with CPack一章中描述的特定平臺的安裝器。?1234567 構建一個CPack驅動的安裝包 include (InstallRequiredSystemLibraries) set (CPACK_RESOURCE_FILE_LICENSE ${CMAKE_CURRENT_SOURCE_DIR}/) set (CPACK_PACKAGE_VERSION_MAJOR ${Tutorial_VERSION_MAJOR}) set (CPACK_PACKAGE_VERSION_MINOR ${Tutorial_VERSION_MINOR}) include (CPack)　　需要做的全部事情就這些。我們以包含InstallRequiredSystemLibraries開始。這個模塊將會包含許多在當前平臺上，當前工程需要的運行時庫。第一步我們將一些CPack變量設置為保存本工程的許可證和版本信息的位置。版本信息使用了我們在本指南中先前設置的變量。最后，我們要包含CPack模塊，它會使用這些變量以及你所處的系統(tǒng)的一些別的屬性，然后來設置一個安裝器。下一步是以通常的方式構建該工程然后隨后運行CPack。如果要構建一個二進制發(fā)行包，你應該運行：?1cpack C 　　為了創(chuàng)建一個源代碼發(fā)行版，你應該鍵入：?1cpack C 增加對Dashboard的支持（步驟7）　　增加對向一個dashboard提交我們的測試結果的功能的支持非常簡單。我們在本指南的先前步驟中已經定義了我們工程中的許多測試樣例。我們僅僅需要運行這些測試樣例然后將它們提交到dashboard即可。為了包含對dashboards的支持，我們需要在頂層CMakeLists文件中包含CTest模塊。?12 支持dashboard腳本 include (CTest)　　，在其中來指定該dashboard的工程名。?1set (CTEST_PROJECT_NAME Tutorial)　　CTest 將會在運行期間讀取這個文件。為了創(chuàng)建一個簡單的dashboard，你可以在你的工程下運行CMake，然后切換到二進制樹，然后運行ctest DExperimental. 你的dashboard將會被更新到Kitware的公共dashboard.公司的一個項目使用CMake作為跨平臺構建工具；業(yè)務有需求，當然要好好研讀一下官方的技術手冊。目前的計劃是先把官方手冊翻譯一下，了解清楚CMake中的各種命令、屬性和變量的用法。同時在工作中也會閱讀CMake的真實源碼，后續(xù)會基于此陸續(xù)寫一些工程中使用CMake的心得。CMake的版本也在不停更新，有些新的命令和變量會隨著版本更新添加進來，這是后事了，暫且不管；現在鎖定CMake 。 作為園子里的新丁，文章在術語和表達等等方面會有欠缺的地方，還請大俠們慷慨指點。另外，羅馬不是一天建成的，長長的手冊翻譯完也不知道要經歷多少日升月落；不過還是希望自己能夠堅持下去:)。 主索引 命令名稱 用法 描述 命令選項 生成器 命令 屬性 全局域屬性 目錄屬性 目標屬性 測試屬性 源代碼屬性 Cache Entries屬性 兼容性命令 CMake 標準模塊 CMake策略 變量 改變行為的變量 描述系統(tǒng)的變量 語言變量 控制構建的變量 提供信息的變量 版權 其他參考資料命令名稱 cmake 跨平臺Makefile生成工具。用法　　cmake [選項] 源碼路徑　　cmake [選項] 現有構建路徑描述　　cmake可執(zhí)行程序是CMake的命令行界面。它可以用腳本對工程進行配置。工程配置設置可以在命令行中使用D選項指定。使用i選項，cmake將通過提示交互式地完成該設置?！　Make是一個跨平臺的構建系統(tǒng)生成工具。，指定工程的構建過程；源碼樹的每個路徑下都有這個文件。CMake產生一個適用于具體平臺的構建系統(tǒng)，用戶使用這個系統(tǒng)構建自己的工程。選項C initialcache: 預加載一個腳本填充緩存文件?！　‘攃make在一個空的構建樹上第一次運行時，然后向其中寫入可定制的項目設置數據。C選項可以用來指定一個文件，在第一次解析這個工程的cmake清單文件時，從這個文件加載緩存的條目(cache entries)信息。被加載的緩存條目比項目默認的值有更高的優(yōu)先權。參數中給定的那個文件應該是一個CMake腳本，其中包含有使用CACHE選項的SET命令；而不是一個緩存格式的文件。D var:type=value: 創(chuàng)建一個CMake的緩存條目?！　‘攃make第一次運行于一個空的構建數時，并且使用可定制的工程設置來填充這個文件。這個選項可以用來指定優(yōu)先級高于工程的默認值的工程設置值。這個參數可以被重復多次，用來填充所需要數量的緩存條目(cache entries)。U globbing_expr: 從CMake的緩存文件中刪除一條匹配的條目?！　　Ｎ募ヅ浔磉_式(globbing expression)支持通配符*和?的使用。該選項可以重復多次以刪除期望數量的緩存條目。使用它時要小心。G generatorname:指定一個makefile生成工具。　　在具體的平臺上，CMake可以支持多個原生的構建系統(tǒng)。makefile生成工具的職責是生成特定的構建系統(tǒng)?？赡艿纳晒ぞ叩拿Q將在生成工具一節(jié)給出。Wnodev: 抑制開發(fā)者警告?！　?。Wdev: 使能開發(fā)者警告信息輸出功能?！　?。E: CMake命令行模式?！　榱苏嬲龅脚c平臺無關，CMake提供了一系列可以用于所有系統(tǒng)上的的命令。以E參數運行CMake會幫助你獲得這些命令的用法。可以使用的命令有：chdir, copy, copy_if_different copy_directory, pare_files, echo, echo_append, environment, make_directory, md5sum, remove_directory, remove, tar, time, touch, touch_nocreate, write_regv, delete_regv, spec, create_symlink。i: 以向導模式運行CMake?！　∠驅Ｊ绞窃跊]有GUI時，交互式地運行cmake的模式。cmake會彈出一系列的提示，要求用戶回答關于工程配置的一行問題。這些答復會被用來設置cmake的緩存值。L[A][H]: 列出緩存的變量中的非高級的變量。　　L選項會列出緩存變量會運行CMake，并列出所有CMake的內有被標記為INTERNAL或者ADVANCED的緩存變量。這會顯示當前的CMake配置信息，然后你可以用D選項改變這些選項。修改一些變量可能會引起更多的變量被創(chuàng)建出來。如果指定了A選項，那么命令也會顯示高級變量。如果指定了H選項，那么命令會顯示每個變量的幫助信息。=========================================================================書接上回:)==================================================== build dir: 構建由CMake生成的工程的二進制樹。（這個選項的含義我不是很清楚—譯注）該選項用以下的選項概括了內置構建工具的命令行界面 dir = 待創(chuàng)建的工程二進制路徑。 target tgt = 構建tgt，而不是默認目標。 config cfg = 對于多重配置工具，選擇配置cfg。 cleanfirst = 首先構建目標的clean偽目標，然后再構建。 （如果僅僅要clean掉，使用target 39。clean39。選項。） = 向內置工具（native tools）傳遞剩余的選項。運行不帶選項的cmake build來獲取快速幫助信息。 N: 查看模式。僅僅加載緩存信息，并不實際運行配置和生成步驟。 P file: 處理腳本模式。將給定的cmake文件按照CMake語言編寫的腳本進行處理。不執(zhí)行配置和生成步驟，不修改緩存信息。如果要使用D選項定義變量，D選項必須在P選項之前。 graphviz=[file]: 生成依賴的graphviz圖。生成一個graphviz軟件的輸入文件，其中包括了項目中所有庫和可執(zhí)行文件之間的依賴關系。 systeminformation [file]: 輸出與該系統(tǒng)相關的信息。 輸出范圍比較廣的、與當前使用的系統(tǒng)有關的信息。如果在一個CMake工程的二進制構建樹的頂端運行該命令，它還會打印一些附加信息，例如緩存，日志文件等等。 debugtrypile: 不刪除“嘗試編譯”路徑。不刪除那些為try_pile調用生成的路徑。這在調試失敗的try_pile文件時比較有用。不過，因為上一次“嘗試編譯”生成的舊的垃圾輸出文件也許會導致一次不正確通過/不通過，且該結果與上次測試的結果不同，所以該選項可能會改變“嘗試編譯”的結果。對于某一次“嘗試編譯”，該選項最好只用一次；并且僅僅在調試時使用。 debugoutput: 將cmake設置為調試模式。在cmake運行時，打印額外的信息；比如使用message(send_error)調用得到的棧跟蹤信息。 trace: 將cmake設置為跟蹤模式。用message(send_error )調用，打印所有調用生成的跟蹤信息，以及這些調用發(fā)生的位置。（這句話含義不是很確定—譯注。） helpmand cmd [file]: 打印單個命令cmd的幫助信息，然后退出。顯示給定的命令的完整的文檔。如果指定了[file]參數，該文檔會寫入該文件，其輸出格式由該文件的后綴名確定。支持的文件類型有：man page，HTML，DocBook以及純文本。 helpmandlist [file]: 列出所有可用命令的清單，然后退出。該選項列出的信息含有所有命令的名字；其中，每個命令的幫助信息可以使用helpmand選項后跟一個命令名字得到。如果指定了[file]參數，幫助信息會寫到file中，輸出格式依賴于文件名后綴。支持的文件格式包括：man page，HTML，DocBook以及純文本。 helpmands [file]: 打印所有命令的幫助文件，然后退出。顯示所有當前版本的命令的完整文檔。如果指定了[file]參數，幫助信息會寫到file中，輸出格式依賴于文件名后綴。支持的文件格式包括：man page，HTML，DocBook以及純文本。 helppatmands [file]: 打印兼容性命令（過時的命令—譯注）的幫助信息。 顯示所有關于兼容性命令的完整文檔。如果指定了[file]參數，幫助信息會寫到file中，輸出格式依賴于文件名后綴。支持的文件格式包括：man page，HTML，DocBook以及純文本。 helpmodule module [file]: 打印某單一模塊的幫助信息，然后退出。打印關于給定模塊的完整信息。如果指定了[file]參數，幫助信息會寫到file中，且輸出格式依賴于文件名后綴。支持的文件格式包括：man page，HTML，DocBook以及純文本。 helpmodulelist [file]: 列出所有可用模塊名，然后退出。列出的清單包括所有模塊的名字；其中，每個模塊的幫助信息可以使用helpmodule選項，后跟模塊名的方式得到。如果指定了[file]參數，幫助信息會寫到file中，且輸出格式依賴于文件名后綴。支持的文件格式包括：man page，HTML，DocBook以及純文本。 helpmodules [file]: 打印所有模塊的幫助信息，然后退出。 顯示關于所有模塊的完整文檔。如果指定了[file]參數，幫助信息會寫到file中，且輸出格式依賴于文件名后綴。支持的文件格式包括：man page，HTML，DocBook以及純文本。 helpcustommodules [file]: 打印所有自定義模塊名，然后退出。顯示所有自定義模塊的完整文檔。如果指定了[file]參數，幫助信息會寫到file中，且輸出格式依賴于文件名后綴。支持的文件格式包括：man page，HTML，DocBook以及純文本。 helppolicy cmp [file]: 打印單個策略的幫助信息，然后退出。顯示給定的策略的完整文檔。如果指定了[file]參數，幫助信息會寫到file中，且輸出格式依賴于文件名后綴。支持的文件格式包括：man page，HTML，DocBook以及純文本。