【正文】 為當(dāng)前及其下級目錄打開測試功能。也可參見add_test命令。注意，ctest需要在構(gòu)建跟目錄下找到一個測試文件。因此，這個命令應(yīng)該在源文件目錄的根目錄下。CMD21: endforeach結(jié)束foreach語句塊中的一系列命令。 endforeach(expression)　　參見FOREACH命令。CMD22: endfunction結(jié)束一個function語句塊中的一系列命令。 endfunction(expression)　　參見function命令。CMD23: endif結(jié)束一個if語句塊中的一系列命令。 endif(expression)　　參見if命令。CMD24: endmacro結(jié)束一個macro語句塊中的一系列命令。 endmacro(expression)　　參見macro命令。CMD25: endwhile結(jié)束一個while語句塊中的一系列命令。 endwhile(expression)　　參見while命令。CMD26: execute_process執(zhí)行一個或更多個子進(jìn)程。 execute_process(COMMAND cmd1 [args1...]] [COMMAND cmd2 [args2...] [...]] [WORKING_DIRECTORY directory] [TIMEOUT seconds] [RESULT_VARIABLE variable] [OUTPUT_VARIABLE variable] [ERROR_VARIABLE variable] [INPUT_FILE file] [OUTPUT_FILE file] [ERROR_FILE file] [OUTPUT_QUIET] [ERROR_QUIET] [OUTPUT_STRIP_TRAILING_WHITESPACE] [ERROR_STRIP_TRAILING_WHITESPACE])　　運(yùn)行一條或多條命令，使得前一條命令的標(biāo)準(zhǔn)輸出以管道的方式成為下一條命令的標(biāo)準(zhǔn)輸入。所有進(jìn)程公用一個單獨(dú)的標(biāo)準(zhǔn)錯誤管道。如果指定了WORKING_DIRECTORY選項(xiàng)，后面的路徑選項(xiàng)將會設(shè)置為子進(jìn)程的當(dāng)前工作路徑。如果指定了TIMEOUT選項(xiàng)，如果子進(jìn)程沒有在指定的秒數(shù)（允許分?jǐn)?shù)）里完成，子進(jìn)程會自動終止。如果指定了RESULT_VARIABLE選項(xiàng)，該變量將保存為正在運(yùn)行的進(jìn)程的結(jié)果；它可以是最后一個子進(jìn)程的整數(shù)返回代碼，也可以是一個描述錯誤狀態(tài)的字符串。如果指定了OUTPUT_VARIABLE或者ERROR_VARIABLE，后面的變量將會被分別設(shè)置為標(biāo)準(zhǔn)輸出和標(biāo)準(zhǔn)錯誤管道的值。如果兩個管道都是用了相同的變量，它們的輸出將會按產(chǎn)生的順序被合并。如果指定了INPUT_FILE，OUTPUT_FILE 或 ERROR_FILE選項(xiàng)，其后的文件將會分別被附加到第一個進(jìn)程的標(biāo)準(zhǔn)輸入、最后一個進(jìn)程的標(biāo)準(zhǔn)輸出，或者所有進(jìn)程的標(biāo)準(zhǔn)錯誤管道上。如果指定了OUTPUT_QUIET后者ERROR_QUIET選項(xiàng)，那么標(biāo)準(zhǔn)輸出或標(biāo)準(zhǔn)錯誤的結(jié)果將會被靜靜的忽略掉。如果為同一個管道指定了多于一個的OUTPUT_*或ERROR_* 選項(xiàng)，優(yōu)先級是沒有指定的。如果沒有指定OUTPUT_*或者ERROR_*選項(xiàng)，輸出將會與CMake進(jìn)程自身對應(yīng)的管道共享?！　xecute_process命令是exec_program命令的一個較新的功能更加強(qiáng)大的版本。但是為了兼容性的原因，舊的exec_program命令還會繼續(xù)保留。CMD27:export從構(gòu)建樹中導(dǎo)出目標(biāo)供外部使用。 export(TARGETS [target1 [target2 [...]]] [NAMESPACE namespace] [APPEND] FILE filename)　　創(chuàng)建一個名為filename的文件，它可以被外部工程包含進(jìn)去，從而外部工程可以從當(dāng)前工程的構(gòu)建樹中導(dǎo)入目標(biāo)。這對于交叉編譯那些可以運(yùn)行在宿主平臺的的utility可執(zhí)行文件，然后將它們導(dǎo)入到另外一個編譯成目標(biāo)平臺代碼的工程中的情形，特別有用。如果指定了NAMESPACE選項(xiàng)，namespace字符串將會被擴(kuò)展到輸出文件中的所有目標(biāo)的名字中。如果指定了APPEND選項(xiàng)，生成的代碼將會續(xù)接在文件之后，而不是覆蓋它。如果一個庫目標(biāo)被包含在export中，但是連接成它的目標(biāo)沒有被包含，行為沒有指定?！　∮稍撁顒?chuàng)建的文件是與指定的構(gòu)建樹一致的，并且絕對不應(yīng)該被安裝。要從一個安裝樹上導(dǎo)出目標(biāo)，參見install(EXPORT)命令。 export(PACKAGE name)　　在CMake的用戶包注冊表中，為name包(package)存儲當(dāng)前的構(gòu)建目錄。這將有助于依賴于它的工程從當(dāng)前工程的構(gòu)建樹中查找并使用包而不需要用戶的介入。注意，該命令在包注冊表中創(chuàng)建的條目，僅僅在與跟構(gòu)建樹一起運(yùn)行的包配置文件(name)一起使用時才會起作用。CMD28: file 文件操作命令 file(WRITE filename message to write... ) file(APPEND filename message to write... ) file(READ filename variable [LIMIT numBytes] [OFFSET offset] [HEX]) file(STRINGS filename variable [LIMIT_COUNT num] [LIMIT_INPUT numBytes] [LIMIT_OUTPUT numBytes] [LENGTH_MINIMUM numBytes] [LENGTH_MAXIMUM numBytes] [NEWLINE_CONSUME] [REGEX regex] [NO_HEX_CONVERSION]) file(GLOB variable [RELATIVE path] [globbing expressions]...) file(GLOB_RECURSE variable [RELATIVE path] [FOLLOW_SYMLINKS] [globbing expressions]...) file(RENAME oldname newname) file(REMOVE [file1 ...]) file(REMOVE_RECURSE [file1 ...]) file(MAKE_DIRECTORY [directory1 directory2 ...]) file(RELATIVE_PATH variable directory file) file(TO_CMAKE_PATH path result) file(TO_NATIVE_PATH path result) file(DOWNLOAD url file [TIMEOUT timeout] [STATUS status] [LOG log] [EXPECTED_MD5 sum] [SHOW_PROGRESS])　　WRITE選項(xiàng)將會寫一條消息到名為filename的文件中。如果文件已經(jīng)存在，該命令會覆蓋已有的文件；如果文件不存在，它將創(chuàng)建該文件?！　PPEND選項(xiàng)和WRITE選項(xiàng)一樣，將會寫一條消息到名為filename的文件中，只是該消息會附加到文件末尾?！　EAD選項(xiàng)將會讀一個文件中的內(nèi)容并將其存儲在變量里。讀文件的位置從offset開始，最多讀numBytes個字節(jié)。如果指定了HEX參數(shù)，二進(jìn)制代碼將會轉(zhuǎn)換為十六進(jìn)制表達(dá)方式，并存儲在變量里?！　TRINGS將會從一個文件中將一個ASCII字符串的list解析出來，然后存儲在variable變量中。文件中的二進(jìn)制數(shù)據(jù)會被忽略。回車換行符會被忽略。它也可以用在Intel的Hex和Motorola的S記錄文件；讀取它們時，它們會被自動轉(zhuǎn)換為二進(jìn)制格式?？梢允褂肗O_HEX_CONVERSION選項(xiàng)禁止這項(xiàng)功能。LIMIT_COUNT選項(xiàng)設(shè)定了返回的字符串的最大數(shù)量。LIMIT_INPUT設(shè)置了從輸入文件中讀取的最大字節(jié)數(shù)。LIMIT_OUTPUT設(shè)置了在輸出變量中存儲的最大字節(jié)數(shù)。LENGTH_MINIMUM設(shè)置了要返回的字符串的最小長度；小于該長度的字符串會被忽略。LENGTH_MAXIMUM設(shè)置了返回字符串的最大長度；更長的字符串會被分割成不長于最大長度的字符串。NEWLINE_CONSUME選項(xiàng)允許新行被包含到字符串中，而不是終止它們。REGEX選項(xiàng)指定了一個待返回的字符串必須滿足的正則表達(dá)式。典型的使用方式是： file(STRINGS myfile)該命令在變量myfile中存儲了一個list，該list中每個項(xiàng)是輸入文件中的一行文本?！　LOB選項(xiàng)將會為所有匹配查詢表達(dá)式的文件生成一個文件list，并將該list存儲進(jìn)變量variable里。文件名查詢表達(dá)式與正則表達(dá)式類似，只不過更加簡單。如果為一個表達(dá)式指定了RELATIVE標(biāo)志，返回的結(jié)果將會是相對于給定路徑的相對路徑。文件名查詢表達(dá)式的例子有： *.cxx 匹配所有擴(kuò)展名為cxx的文件。 *.vt? 匹配所有擴(kuò)展名是vta,...,vtz的文件。 f[35].txt , , ?！　LOB_RECURSE選項(xiàng)將會生成一個類似于通常的GLOB選項(xiàng)的list，只是它會尋訪所有那些匹配目錄的子路徑并同時匹配查詢表達(dá)式的文件。作為符號鏈接的子路徑只有在給定FOLLOW_SYMLINKS選項(xiàng)或者cmake策略CMP0009被設(shè)置為NEW時，才會被尋訪到。參見cmake helppolicy CMP0009 查詢跟多有用的信息。使用遞歸查詢的例子有： /dir/*.py 匹配所有在/dir及其子目錄下的python文件。　　MAKE_DIRECTORY選項(xiàng)將會創(chuàng)建指定的目錄，如果它們的父目錄不存在時，同樣也會創(chuàng)建。（類似于mkdir命令——譯注）　　RENAME選項(xiàng)對同一個文件系統(tǒng)下的一個文件或目錄重命名。（類似于mv命令——譯注）　　REMOVE選項(xiàng)將會刪除指定的文件，包括在子路徑下的文件。（類似于rm命令——譯注）　　REMOVE_RECURSE選項(xiàng)會刪除給定的文件以及目錄，包括非空目錄。（類似于rm r 命令——譯注）　　RELATIVE_PATH選項(xiàng)會確定從direcroty參數(shù)到指定文件的相對路徑?！　O_CMAKE_PATH選項(xiàng)會把path轉(zhuǎn)換為一個以unix的 / 開頭的cmake風(fēng)格的路徑。輸入可以是一個單一的路徑，也可以是一個系統(tǒng)路徑，比如$ENV{PATH}。注意，在調(diào)用TO_CMAKE_PATH的ENV周圍的雙引號只能有一個參數(shù)(Note the double quotes around the ENV call TO_CMAKE_PATH only takes one argument. 原文如此。quotes和后面的takes讓人后糾結(jié)，這句話翻譯可能有誤。歡迎指正——譯注)?！　O_NATIVE_PATH選項(xiàng)與TO_CMAKE_PATH選項(xiàng)很相似，但是它會把cmake風(fēng)格的路徑轉(zhuǎn)換為本地路徑風(fēng)格：windows下用\，而unix下用/?！　OWNLOAD 將給定的URL下載到指定的文件中。如果指定了LOG var選項(xiàng)，下載日志將會被輸出到var中。如果指定了STATUS var選項(xiàng)，下載操作的狀態(tài)會被輸出到var中。該狀態(tài)返回值是一個長度為2的list。list的第一個元素是操作的數(shù)字返回值，第二個返回值是錯誤的字符串值。錯誤信息如果是數(shù)字0，操作中沒有發(fā)生錯誤。如果指定了TIMEOUT time選項(xiàng)，在time秒之后，操作會超時退出；time應(yīng)該是整數(shù)。如果指定了EXPECTED_MD5 sum選項(xiàng)，下載操作會認(rèn)證下載的文件的實(shí)際MD5和是否與期望值匹配。如果不匹配，操作將返回一個錯誤。如果指定了SHOW_PROGRESS選項(xiàng)，進(jìn)度信息會以狀態(tài)信息的形式被打印出來，直到操作完成?！　ile命令還提供了COPY和INSTALL兩種格式： file(COPY|INSTALL files... DESTINATION dir [FILE_PERMISSIONS permissions...] [DIRECTORY_PERMISSIONS permissions...] [NO_SOURCE_PERMISSIONS] [USE_SOURCE_PERMISSIONS] [FILES_MATCHING] [[PATTERN pattern | REGEX regex] [EXCLUDE] [PERMISSIONS permissions...]] [...])　　COPY版本把文件、目錄以及符號連接拷貝到一個目標(biāo)文件夾。相對輸入路徑的評估是基于當(dāng)前的源代碼目錄進(jìn)行的，相對目標(biāo)路徑的評估是基于當(dāng)前的構(gòu)建目錄進(jìn)行的。復(fù)制過程將保留輸入文件的時間戳；并且如果目標(biāo)路徑處存在同名同時間戳的文件，復(fù)制命令會把它優(yōu)化掉。賦值過程將保留輸入文件的訪問權(quán)限，除非顯式指定權(quán)限或指定NO_SOURCE_PERMISSIONS選項(xiàng)（默認(rèn)是USE_SOURCE_PERMISSIONS）。參見install(DIRECTORY)命令中關(guān)于權(quán)限（permissions），PATTERN，REGEX和EXCLUDE選項(xiàng)的文檔。　　INSTALL版本與COPY版本只有十分微小的差別：它會打印狀態(tài)信息，并且默認(rèn)使用NO_SOURCE_PERMISSIONS選