ctest_start

開始指定模型的測試

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

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

開始指定模型的測試。此命令應在二進制目錄初始化後呼叫。

參數如下：

<模型>

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

<來源>

設定來源目錄。如果未指定，則改為使用 CTEST_SOURCE_DIRECTORY 的值。

<二進制>

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

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 變數），則其內容會被視為命令列。該命令會被調用，並且目前的工作目錄會設定為來源目錄的父目錄，即使來源目錄已存在。這可以用於從版本控制儲存庫建立來源樹。