ctest_start

開始給定模型的測試

ctest_start(<model> [<source> [<binary>]] [GROUP <group>] [QUIET])

ctest_start([<model> [<source> [<binary>]]] [GROUP <group>] APPEND [QUIET])

開始給定模型的測試。此命令應在二進制目錄初始化後調用。

參數如下

<model>

設定儀表板模型。必須是 Experimental、Continuous 或 Nightly 其中之一。除非指定了 APPEND，否則此參數為必填項。

<source>

設定原始碼目錄。如果未指定，則會改用 CTEST_SOURCE_DIRECTORY 的值。

<binary>

設定二進制目錄。如果未指定，則會改用 CTEST_BINARY_DIRECTORY 的值。

GROUP <group>

如果使用 GROUP，提交將發送到 CDash 伺服器上的指定群組。如果未指定 GROUP，則預設使用模型名稱。

版本 3.16 中變更：這取代了已棄用的選項 TRACK。儘管名稱已變更，但其行為保持不變。

APPEND

如果使用 APPEND，將使用現有的 TAG，而不是根據目前的時間戳記建立新的 TAG。 如果您使用 APPEND，則可以省略 <model> 和 GROUP <group> 參數，因為它們將從產生的 TAG 檔案中讀取。 例如

ctest_start(Experimental GROUP GroupExperimental)

稍後，在另一個 ctest -S 腳本中

ctest_start(APPEND)

當第二個腳本執行 ctest_start(APPEND) 時，它將從第一個 ctest_start() 命令產生的 TAG 檔案中讀取 Experimental 模型和 GroupExperimental 群組。 請注意，如果您調用 ctest_start(APPEND) 並指定與第一個 ctest_start() 命令中不同的模型或群組，則會發出警告，並將使用新的模型和群組。

QUIET

在版本 3.3 中新增。

如果使用 QUIET，CTest 將抑制任何非錯誤訊息，否則這些訊息會列印到控制台。

ctest_start() 的參數可以以任何順序發出，但 <model>、<source> 和 <binary> 必須彼此按照該順序出現。 以下所有範例皆有效且等效

ctest_start(Experimental path/to/source path/to/binary GROUP SomeGroup QUIET APPEND)

ctest_start(GROUP SomeGroup Experimental QUIET path/to/source APPEND path/to/binary)

ctest_start(APPEND QUIET Experimental path/to/source GROUP SomeGroup path/to/binary)

但是，為了便於閱讀，建議您按照此頁面頂部列出的順序排列參數。

如果設定了 CTEST_CHECKOUT_COMMAND 變數（或 CTEST_CVS_CHECKOUT 變數），則其內容將被視為命令列。即使原始碼目錄已存在，也會在目前工作目錄設定為原始碼目錄的父目錄的情況下調用該命令。這可用於從版本控制儲存庫建立原始碼樹狀結構。