这是可以使用我们的多个免费在线工作站之一在 OnWorks 免费托管服务提供商中运行的命令 ctest，例如 Ubuntu Online、Fedora Online、Windows 在线模拟器或 MAC OS 在线模拟器
程序：
您的姓名
ctest - CTest 命令行参考
概要
测试 [ ]
商品描述
“ctest”可执行文件是 CMake 测试驱动程序。 CMake 生成的构建树
为使用 ENABLE_TESTING 和 ADD_TEST 命令的项目创建有测试
支持。 该程序将运行测试并报告结果。
配置
-C , --构建配置
选择要测试的配置。
一些 CMake 生成的构建树可以在同一个构建树中具有多个构建配置
树。 此选项可用于指定应测试哪一个。 例子
配置是“调试”和“发布”。
-V,--详细
启用测试的详细输出。
测试输出通常被抑制，只显示摘要信息。 这个
选项将显示所有测试输出。
-VV,--冗长
启用更详细的测试输出。
测试输出通常被抑制，只显示摘要信息。 这个
选项将显示更多的测试输出。
-调试
显示 CTest 更详细的内部结构。
此功能将产生大量的输出，这些输出主要用于
调试仪表板问题。
--输出失败
如果测试失败，则输出测试程序输出的任何内容。 这个选项
也可以通过设置环境变量来启用 CTEST_OUTPUT_ON_FAILURE.
-F 启用故障转移。
此选项允许 ctest 恢复之前的测试集执行
中断了。 如果没有中断发生，-F 选项将不起作用。
-j , - 平行线
使用给定数量的作业并行运行测试。
此选项告诉 ctest 使用给定数量的作业并行运行测试。
这个选项也可以通过设置环境变量来设置
CTEST_PARALLEL_LEVEL.
--测试负载
在并行运行测试时（例如 -j), 尽量不要在测试时开始
可能会导致 CPU 负载超过给定的阈值。
在规划婴儿食品行业的工艺要求时，安全性和可靠性是工艺设计中最重要的方面。 测试 作为 立即开始 客户 这设置了 测试负载 的选项 测试
测试 步骤.
-Q,--安静
让 ctest 安静。
此选项将抑制所有输出。 输出日志文件仍将是
如果指定了 --output-log 则生成。 诸如 --verbose 之类的选项，
如果指定了 --quiet，则忽略 --extra-verbose 和 --debug。
-O , --输出日志
输出到日志文件
此选项告诉 ctest 将其所有输出写入日志文件。
-N,--仅显示
禁用测试的实际执行。
此选项告诉 ctest 列出将运行但未实际运行的测试
他们。 与 -R 和 -E 选项结合使用很有用。
-L , --标签正则表达式
使用匹配正则表达式的标签运行测试。
此选项告诉 ctest 仅运行标签与给定正则匹配的测试
表达。
-R , --tests-正则表达式
运行匹配正则表达式的测试。
此选项告诉 ctest 仅运行名称与给定正则匹配的测试
表达。
-E , --排除-正则表达式
排除匹配正则表达式的测试。
此选项告诉 ctest 不要运行名称与给定正则匹配的测试
表达。
-LE , --标签排除
排除标签匹配正则表达式的测试。
此选项告诉 ctest 不要运行标签与给定正则匹配的测试
表达。
-D , - 仪表盘
执行仪表板测试
此选项告诉 ctest 作为 CDash 客户端并执行仪表板测试。 全部
测试是，其中模式可以是实验性、夜间和连续，
和测试可以是启动、更新、配置、构建、测试、覆盖和提交。
-D ： =
为脚本模式定义一个变量
在命令行上传递变量值。 与 -S 结合使用以通过
仪表板脚本的变量值。 将 -D 参数解析为变量值是
仅在 -D 后面的值与任何已知仪表板不匹配时才尝试
类型。
-M , --测试模型
设置仪表板的模型
这个选项告诉 ctest 作为一个 CDash 客户端，TestModel 可以在其中
实验性、夜间和连续。 结合 -M 和 -T 类似于 -D
-T , --测试动作
设置要执行的仪表板操作
这个选项告诉 ctest 充当 CDash 客户端并执行一些操作，例如
启动、构建、测试等。 结合 -M 和 -T 类似于 -D
- 追踪
指定要将仪表板提交到的轨道
将仪表板提交到指定轨道而不是默认轨道。 默认情况下，
仪表板提交到 Nightly、Experimental 或 Continuous 轨道，但由
指定此选项，轨迹可以是任意的。
-S , - 脚本
为配置执行仪表板
这个选项告诉 ctest 加载一个配置脚本，它设置了一些
参数，例如二进制和源目录。 然后 ctest 会做什么
创建和运行仪表板所需。 此选项基本上设置了一个仪表板
然后使用适当的选项运行 ctest -D。
-SP , --script-新进程
为配置执行仪表板
此选项执行与 -S 相同的操作，但它将在单独的
过程。 这主要在脚本可能修改
环境并且您不希望修改后的环境影响其他 -S
脚本。
-A , --添加注释
添加带有提交的注释文件
此选项告诉 ctest 在提交仪表板时包含一个注释文件。
-I [开始，结束，步幅，测试#，测试#|测试 文件]， --测试信息
按编号运行特定数量的测试。
此选项使 ctest 运行从编号开始的测试，以编号结束
结束，并以 Stride 递增。 Stride 之后的任何附加数字都是
考虑个人测试号码。 开始、结束或步幅可以为空。 可选
可以给出包含与命令行相同语法的文件。
-U， - 联盟
取 -I 和 -R 的并集
当 -R 和 -I 都被默认指定时，将运行测试的交集。 经过
指定 -U 将运行测试联合。
--重新运行失败
只运行之前失败的测试
这个选项告诉 ctest 只执行在之前失败的测试
跑。 指定此选项后，ctest 将忽略所有其他旨在
修改要运行的测试列表（-L、-R、-E、-LE、-I 等）。 在这种情况下
CTest 运行并且没有测试失败，随后使用 --rerun-failed 调用 ctest
选项将运行最近失败的一组测试（如果有）。
--重复直到失败
要求运行每个测试 多次没有失败才能通过。
这在查找测试用例中的偶发故障时很有用。
--最大宽度
设置要输出的测试名称的最大宽度
设置每个测试名称的最大宽度以显示在输出中。 这允许
用户扩大输出以避免剪切测试名称，这可能非常
恼人的。
--交互式调试模式 [0|1]
将交互模式设置为 0 或 1。
此选项使 ctest 以交互模式或
非交互模式。 在 Windows 上，这意味着在非交互模式下，所有
系统调试弹出窗口被阻止。 在仪表板模式（实验、夜间、
连续），默认为非交互式。 当只是运行测试而不是
仪表板默认是允许弹出窗口和交互式调试。
--无标签摘要
禁用标签的计时摘要信息。
此选项告诉 ctest 不要为关联的每个标签打印摘要信息
随着测试的运行。 如果测试上没有标签，则不会打印任何额外内容。
--构建和测试
配置、构建和运行测试。
此选项告诉 ctest 配置（即运行 cmake）、构建和/或执行
测试。 配置和测试步骤是可选的。 此命令的参数
行是源目录和二进制目录。 默认情况下，这将在
除非指定了 --build-nocmake，否则指定源/Bin 目录。 这
--build-generator 选项 必须 提供使用--build-and-test。 如果
--test-command 指定然后将在构建完成后运行。
影响此模式的其他选项是 --build-target --build-nocmake，
--build-run-dir, --build-two-config, --build-exe-dir,
--build-project,--build-noclean,--build-options
--构建目标
指定要构建的特定目标。
此选项与 --build-and-test 选项一起使用，如果省略所有目标是
内置的。
--build-nocmake
运行构建而不先运行 cmake。
跳过 cmake 步骤。
--构建运行目录
指定运行程序的目录。
程序编译后所在的目录。
--构建两个配置
运行 CMake 两次
--build-exe-目录
指定可执行文件的目录。
--构建生成器
指定要使用的生成器。
--构建生成器平台
指定特定于生成器的平台。
--build-generator-工具集
指定特定于生成器的工具集。
--构建项目
指定要构建的项目的名称。
--build-make 程序
用给定的程序覆盖 CTest 选择的 make 程序。
--build-noclean
跳过 make clean 步骤。
--构建配置样本
用于确定配置的示例可执行文件
用于确定应使用的配置的示例可执行文件。
例如调试/发布/等
--构建选项
向构建步骤添加额外选项。
此选项必须是除 --test-command 之外的最后一个选项
--测试命令
使用 --build-and-test 选项运行的测试。
--测试输出大小通过
将通过测试的输出限制为字节。
--test-output-size-失败
将失败测试的输出限制为字节。
--测试超时
以秒为单位的时间限制，仅供内部使用。
--明天标签
每晚或实验性从第二天标签开始。
如果构建不会在一天内完成，这将很有用。
--ctest-配置
提交仪表板时用于初始化 CTest 状态的配置文件。
此选项告诉 CTest 使用不同的初始化文件而不是
CTestConfiguration.tcl。 这样可以使用多个初始化文件
提交到多个仪表板的示例。
--覆盖
覆盖 CTest 配置选项。
默认情况下，ctest 使用配置文件中的配置选项。 这个选项
将覆盖配置选项。
--额外提交 [; ]
向仪表板提交额外文件。
此选项将向仪表板提交额外文件。
--force-new-ctest-进程
将子 CTest 实例作为新进程运行
默认情况下，CTest 将在同一进程中运行子 CTest 实例。 如果这
不需要行为，此参数将强制执行子 CTest 的新流程
流程。
--schedule-随机
使用随机顺序安排测试
此选项将以随机顺序运行测试。 它通常用于检测
测试套件中的隐式依赖项。
--提交索引
旧 Dart2 仪表板服务器功能的旧选项。 不使用。
- 暂停
为所有测试设置全局超时。
此选项将在所有还没有的测试上设置全局超时
超时设置在他们身上。
--停止时间
设置所有测试停止运行的时间。
设置所有测试应超时的实际时间。 示例：7:00:00 -0400。
接受 curl 日期解析器理解的任何时间格式。 当地时间是
如果未指定时区，则假定。
--http1.0
使用 HTTP 1.0 提交。
此选项将强制 CTest 使用 HTTP 1.0 向仪表板提交文件，
而不是 HTTP 1.1。
--无压缩输出
提交时不要压缩测试输出。
此标志将关闭测试输出的自动压缩。 用这个来维护
与不支持压缩测试的旧版 CDash 兼容
输出。
--打印标签
打印所有可用的测试标签。
此选项不会运行任何测试，它只会打印所有标签的列表
与测试集相关联。
--帮助，-帮助，-用法，-h，-H，/？
打印使用信息并退出。
用法描述了基本的命令行界面及其选项。
--版本，-版本，/V [ ]
显示程序名称/版本横幅并退出。
如果指定了文件，则将版本写入其中。 帮助被打印到一个
命名如果给出的话。
--帮助完整 [ ]
打印所有帮助手册并退出。
所有手册均以人类可读的文本格式印刷。 帮助被打印到一个
命名如果给出的话。
--帮助手册 [ ]
打印一份帮助手册并退出。
指定的手册以人类可读的文本格式打印。 帮助是
打印到一个命名如果给出的话。
--帮助手册列表 [ ]
列出可用的帮助手册并退出。
该列表包含可通过使用
--帮助手册 选项后跟手册名称。 帮助被打印到一个命名的
如果给出的话。
--help-命令 [ ]
打印一个命令的帮助并退出。
这个 cmake 命令(7) 手动输入 以人类可读的文本打印
格式。 帮助被打印到一个命名的如果给出的话。
--help-命令列表 [ ]
列出带有可用帮助的命令并退出。
该列表包含所有可以通过使用
--help-命令 选项后跟命令名称。 帮助被打印到一个命名的
如果给出的话。
--help-命令 [ ]
打印 cmake-commands 手册并退出。
这个 cmake 命令(7) 手册以人类可读的文本格式打印。 帮助
打印到一个命名如果给出的话。
--帮助模块 [ ]
打印一个模块的帮助并退出。
这个 cmake 模块(7) 手动输入 以人类可读的文本打印
格式。 帮助被打印到一个命名的如果给出的话。
--帮助模块列表 [ ]
列出可用帮助的模块并退出。
该列表包含可通过使用
--帮助模块 选项后跟模块名称。 帮助被打印到一个命名的
如果给出的话。
--帮助模块 [ ]
打印 cmake-modules 手册并退出。
这个 cmake 模块(7) 手册以人类可读的文本格式打印。 帮助
打印到一个命名如果给出的话。
--帮助政策 [ ]
打印一项政策的帮助并退出。
这个 cmake-政策(7) 手动输入 以人类可读的文本打印
格式。 帮助被打印到一个命名的如果给出的话。
--帮助策略列表 [ ]
列出可用帮助的策略并退出。
该列表包含可通过使用
--帮助政策 选项后跟策略名称。 帮助被打印到一个命名的
如果给出的话。
--帮助政策 [ ]
打印 cmake-policies 手册并退出。
这个 cmake-政策(7) 手册以人类可读的文本格式打印。 帮助
打印到一个命名如果给出的话。
--帮助-属性 [ ]
打印一个属性的帮助并退出。
这个 cmake-属性(7) 手动输入 以人类可读的方式打印
文本格式。 帮助被打印到一个命名的如果给出的话。
--help-属性列表 [ ]
列出可用帮助的属性并退出。
该列表包含可通过使用
--帮助-属性 选项后跟属性名称。 帮助被打印到一个命名的
如果给出的话。
--帮助-属性 [ ]
打印 cmake-properties 手册并退出。
这个 cmake-属性(7) 手册以人类可读的文本格式打印。 这
帮助被打印到一个命名如果给出的话。
--帮助变量 [ ]
打印一个变量的帮助并退出。
这个 cmake-变量(7) 手动输入 以人类可读的文本打印
格式。 帮助被打印到一个命名的如果给出的话。
--help-变量列表 [ ]
列出可用帮助的变量并退出。
该列表包含可通过使用
--帮助变量 选项后跟变量名。 帮助被打印到一个命名的
如果给出的话。
--help-变量 [ ]
打印 cmake-variables 手册并退出。
这个 cmake-变量(7) 手册以人类可读的文本格式打印。 帮助
打印到一个命名如果给出的话。
用户面板 客户
CTest 可以作为客户端运行 达世币 软件质量仪表板应用程序。 作为一个
仪表板客户端，CTest 执行一系列步骤来配置、构建和测试
软件，然后将结果提交给 达世币 服务器。
立即开始 客户 步骤
CTest 定义了一个有序的测试步骤列表，其中一些或全部可以作为
仪表盘客户端：
开始 开始一个新的仪表板提交，由记录的结果组成
以下步骤。 见 测试 开始 步骤 以下部分。
更新 从其版本控制存储库更新源树。 记录新旧
版本和更新的源文件列表。 见 测试 更新 步骤 部分
联络一位教师
配置
通过在构建树中运行命令来配置软件。 记录
配置输出日志。 见 测试 配置 步骤 以下部分。
构建 通过在构建树中运行命令来构建软件。 记录构建输出
记录并检测警告和错误。 见 测试 构建 步骤 以下部分。
测试 通过加载一个测试软件 CTest测试文件.cmake 从构建树和
执行定义的测试。 记录每个测试的输出和结果。 见
测试 测试 步骤 以下部分。
保障范围
通过运行覆盖率分析工具计算源代码的覆盖率和
记录其输出。 见 测试 保障范围 步骤 以下部分。
内存检查
通过内存检查工具运行软件测试套件。 记录测试输出，
结果和工具报告的问题。 见 测试 内存检查 步骤 部分
联络一位教师
提交 将其他测试步骤记录的结果提交到软件质量仪表板
服务器。 见 测试 提交 步骤 以下部分。
立即开始 客户 模式
CTest 定义了三种操作模式作为仪表板客户端：
每夜
此模式旨在每天调用一次，通常是在晚上。 它使
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 开始, 更新, 配置, 构建, 测试, 保障范围和 提交 默认步骤。
选定的步骤运行，即使 更新 step 报告源树没有更改。
持续
此模式旨在全天重复调用。 它使
开始, 更新, 配置, 构建, 测试, 保障范围和 提交 默认步骤，但
之后退出 更新 step 如果它报告源树没有更改。
实验
此模式旨在由开发人员调用以测试本地更改。 它
启用 开始, 配置, 构建, 测试, 保障范围和 提交 默认步骤。
立即开始 客户 通过 测试 命令行
CTest 可以对已经生成的构建树执行测试。 跑过 测试 命令与
当前工作目录设置为构建树并使用以下签名之一：
ctest -D [ ]
测试-M [ -T ]...
这个 必须是上述之一 立即开始 客户 模式，以及每个 必须是其中之一
以上 立即开始 客户 步骤.
CTest 读取 立即开始 客户 配置 来自构建树中文件的设置
被称为 CTestConfiguration.ini文件 or 飞镖配置.tcl （这些名字是历史性的）。
文件格式为：
# 以“#”开头的行是注释。
# 其他非空行是键值对。
：
协调 是设置名称和 是设定值。
在 CMake 生成的构建树中，此配置文件由 测试
模块（如果包含在项目中）。 该模块使用变量为每个变量获取一个值
设置如下文所述。
立即开始 客户 通过 测试 脚本
CTest 可以执行由一个驱动的测试 cmake语言(7) 创建和维护脚本
源和构建树以及执行测试步骤。 跑过 测试 命令
将当前工作目录设置在任何构建树之外，并使用其中之一
签名：
测试 -S
ctest -SP
这个 文件必须调用 CTest 命令命令来显式运行测试步骤
记录如下。 命令获取 立即开始 客户 配置 从他们的设置
参数或来自脚本中设置的变量。
用户面板 客户 配置
这个 立即开始 客户 步骤 可以通过命名设置进行配置，如文档中所述
以下部分。
测试 开始 步骤
开始一个新的仪表板提交，由以下记录的结果组成
步骤。
在一个 测试 脚本， ctest_start() 命令运行这一步。 命令的参数可以
指定一些步骤设置。 该命令首先运行由指定的命令行
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 CTEST_CHECKOUT_COMMAND 变量，如果设置，初始化源目录。
配置设置包括：
构建目录
项目构建树的完整路径。
· 测试 脚本 变量： CTEST_BINARY_DIRECTORY
· 测试 模块变量： PROJECT_BINARY_DIR
源目录
项目源代码树的完整路径。
· 测试 脚本 变量： CTEST_SOURCE_DIRECTORY
· 测试 模块变量： 项目源目录
测试 更新 步骤
在一个 测试 脚本， ctest_update() 命令运行这一步。 命令的参数
可以指定一些步骤设置。
用于指定版本控制工具的配置设置包括：
BZR命令
BZR 如果源树由 Bazaar 管理，则使用命令行工具。
· 测试 脚本 变量： CTEST_BZR_命令
· 测试 模块变量：无
BZR更新选项
命令行选项 BZR命令 更新源时。
· 测试 脚本 变量： CTEST_BZR_UPDATE_OPTIONS
· 测试 模块变量：无
CVS命令
CVS 如果源树由 CVS 管理，要使用的命令行工具。
· 测试 脚本 变量： CTEST_CVS_命令
· 测试 模块变量： CVS命令
CVS更新选项
命令行选项 CVS命令 更新源时。
· 测试 脚本 变量： CTEST_CVS_UPDATE_OPTIONS
· 测试 模块变量： CVS_UPDATE_OPTIONS
GIT命令
混帐 如果源树由 Git 管理，则要使用的命令行工具。
· 测试 脚本 变量： CTEST_GIT_命令
· 测试 模块变量： git命令
GIT更新自定义
指定要在源代码中运行的自定义命令行（以分号分隔的列表）
树（Git 工作树）来更新它而不是运行 GIT命令.
· 测试 脚本 变量： CTEST_GIT_UPDATE_CUSTOM
· 测试 模块变量： CTEST_GIT_UPDATE_CUSTOM
GIT 更新选项
命令行选项 GIT命令 更新源时。
· 测试 脚本 变量： CTEST_GIT_UPDATE_OPTIONS
· 测试 模块变量： GIT_UPDATE_OPTIONS
指挥部
hg 如果源树由 Mercurial 管理，则要使用的命令行工具。
· 测试 脚本 变量： CTEST_HG_命令
· 测试 模块变量：无
HG 更新选项
命令行选项 指挥部 更新源时。
· 测试 脚本 变量： CTEST_HG_UPDATE_OPTIONS
· 测试 模块变量：无
P4客户端
的价值 -c 选项 P4命令.
· 测试 脚本 变量： CTEST_P4_CLIENT
· 测试 模块变量： CTEST_P4_CLIENT
P4命令
p4 如果源树由 Perforce 管理，则使用命令行工具。
· 测试 脚本 变量： CTEST_P4_命令
· 测试 模块变量： P4命令
P4选项
命令行选项 P4命令 对于所有调用。
· 测试 脚本 变量： CTEST_P4_选项
· 测试 模块变量： CTEST_P4_选项
P4更新自定义
指定要在源代码中运行的自定义命令行（以分号分隔的列表）
树（Perforce 树）来更新它而不是运行 P4命令.
· 测试 脚本 变量：无
· 测试 模块变量： CTEST_P4_UPDATE_CUSTOM
P4更新选项
命令行选项 P4命令 更新源时。
· 测试 脚本 变量： CTEST_P4_UPDATE_OPTIONS
· 测试 模块变量： CTEST_P4_UPDATE_OPTIONS
SVN命令
svn 如果源树由 Subversion 管理，则要使用的命令行工具。
· 测试 脚本 变量： CTEST_SVN_命令
· 测试 模块变量： SVN命令
SVN选项
命令行选项 SVN命令 对于所有调用。
· 测试 脚本 变量： CTEST_SVN_OPTIONS
· 测试 模块变量： CTEST_SVN_OPTIONS
SVN更新选项
命令行选项 SVN命令 更新源时。
· 测试 脚本 变量： CTEST_SVN_UPDATE_OPTIONS
· 测试 模块变量： SVN_UPDATE_OPTIONS
更新命令
指定要使用的版本控制命令行工具而不检测 VCS
管理源树。
· 测试 脚本 变量： CTEST_UPDATE_COMMAND
· 测试 模块变量： 命令 ，尤其是 更新类型 is ， 别的
更新命令
更新选项
命令行选项 更新命令.
· 测试 脚本 变量： CTEST_UPDATE_OPTIONS
· 测试 模块变量： _UPDATE_OPTIONS ，尤其是 更新类型 is ， 别的
更新选项
更新类型
指定管理源树的版本控制系统，如果它不能
自动检测。 该值可能是 BZR, CVS, 混帐, hg, p4或 svn.
· 测试 脚本 变量：无，从源树中检测到
· 测试 模块变量： 更新类型 如果设置，否则 CTEST_UPDATE_TYPE
仅更新版本
指定您希望版本控制更新命令只发现
签出的当前版本，而不是更新到其他版本。
· 测试 脚本 变量： CTEST_UPDATE_VERSION_ONLY
其他配置设置包括：
每晚开始时间
在 每夜 仪表板模式，指定“每晚开始时间”。 与集中
版本控制系统（CVS 和 svn），则 更新 步骤检查版本
软件截至此时，以便多个客户选择一个通用版本
测试。 这在分布式版本控制系统中没有明确定义，因此
设置被忽略。
· 测试 脚本 变量： CTEST_NIGHTLY_START_TIME
· 测试 模块变量： NIGHTLY_START_TIME 如果设置，否则 CTEST_NIGHTLY_START_TIME
测试 配置 步骤
在一个 测试 脚本， ctest_configure() 命令运行这一步。 命令的参数
可以指定一些步骤设置。
配置设置包括：
配置命令
用于启动软件配置过程的命令行。 它将在
指定的位置 构建目录 设置。
· 测试 脚本 变量： CTEST_CONFIGURE_COMMAND
· 测试 模块变量： CMAKE_COMMAND 命令 其次是 项目源目录
测试 构建 步骤
在一个 测试 脚本， ctest_build() 命令运行这一步。 命令的参数可以
指定一些步骤设置。
配置设置包括：
默认CTestConfigurationType
当要启动的构建系统允许构建时选择
配置（例如 调试, 发布)，这指定默认配置为
没有时建造 -C 选项被赋予 测试 命令。 该值将是
代入的值 生成命令 替换文字字符串
${CTEST_CONFIGURATION_TYPE} 如果出现。
· 测试 脚本 变量： CTEST_CONFIGURATION_TYPE
· 测试 模块变量： DEFAULT_CTEST_CONFIGURATION_TYPE, 由
CMAKE_CONFIG_TYPE 环境变量
生成命令
用于启动软件构建过程的命令行。 它将在
指定地点 构建目录 设置。
· 测试 脚本 变量： CTEST_BUILD_COMMAND
· 测试 模块变量： 发出命令, 由 构建命令（） 命令
使用启动器
对于 CMake 使用 Makefile Generators 之一生成的构建树或
忍者 生成器，指定是否 CTEST_USE_LAUNCHERS 功能由
CTestUse启动器 模块（也包含在 测试 模块）。 启用后，
生成的构建系统包装了编译器、链接器或自定义的每次调用
带有通过环境与 CTest 通信的“启动器”的命令行
变量和文件来报告细粒度的构建警告和错误信息。
否则，CTest 必须“抓取”构建输出日志以进行诊断。
· 测试 脚本 变量： CTEST_USE_LAUNCHERS
· 测试 模块变量： CTEST_USE_LAUNCHERS
测试 测试 步骤
在一个 测试 脚本， ctest_测试() 命令运行这一步。 命令的参数可以
指定一些步骤设置。
配置设置包括：
测试负载
在并行运行测试时（例如 -j), 尽量不要在测试时开始
可能会导致 CPU 负载超过给定的阈值。
· 测试 脚本 变量： CTEST_测试_加载
· 测试 模块变量： CTEST_测试_加载
超时
如果未指定，则每个测试的默认超时 超时 测试属性。
· 测试 脚本 变量： CTEST_测试_超时
· 测试 模块变量： DART_TESTING_TIMEOUT
测试 保障范围 步骤
在一个 测试 脚本， ctest_coverage() 命令运行这一步。 命令的参数
可以指定一些步骤设置。
配置设置包括：
覆盖命令
用于执行软件覆盖率分析的命令行工具。 它将在
指定的位置 构建目录 设置。
· 测试 脚本 变量： CTEST_COVERAGE_COMMAND
· 测试 模块变量： 覆盖命令
覆盖范围额外标志
指定命令行选项 覆盖命令 工具。
· 测试 脚本 变量： CTEST_COVERAGE_EXTRA_FLAGS
· 测试 模块变量： COVERAGE_EXTRA_FLAGS
测试 内存检查 步骤
在一个 测试 脚本， ctest_memcheck() 命令运行这一步。 命令的参数
可以指定一些步骤设置。
配置设置包括：
内存检查命令
用于执行动态分析的命令行工具。 将启动测试命令行
通过这个工具。
· 测试 脚本 变量： CTEST_MEMORYCHECK_COMMAND
· 测试 模块变量： 内存检查命令
内存检查命令选项
指定命令行选项 内存检查命令 工具。 他们将被安置
在测试命令行之前。
· 测试 脚本 变量： CTEST_MEMORYCHECK_COMMAND_OPTIONS
· 测试 模块变量： MEMORYCHECK_COMMAND_OPTIONS
内存检查类型
指定要执行的内存检查类型。
· 测试 脚本 变量： CTEST_MEMORYCHECK_TYPE
· 测试 模块变量： 内存检查类型
MemoryCheckSanitizer 选项
在使用启用消毒的构建运行时指定消毒剂的选项。
· 测试 脚本 变量： CTEST_MEMORYCHECK_SANITIZER_OPTIONS
· 测试 模块变量： MEMORYCHECK_SANITIZER_OPTIONS
内存检查抑制文件
指定包含抑制规则的文件 内存检查命令 工具。 它
将传递适合该工具的选项。
· 测试 脚本 变量： CTEST_MEMORYCHECK_SUPRESSIONS_FILE
· 测试 模块变量： MEMORYCHECK_SUPPRESSIONS_FILE
其他配置设置包括：
BoundsChecker 命令
指定一个 内存检查命令 已知与命令行兼容
边界检查器。
· 测试 脚本 变量：无
· 测试 模块变量：无
净化命令
指定一个 内存检查命令 已知与命令行兼容
净化。
· 测试 脚本 变量：无
· 测试 模块变量： 净化命令
Valgrind命令
指定一个 内存检查命令 已知与命令行兼容
瓦尔格林。
· 测试 脚本 变量：无
· 测试 模块变量： VALGRIND_COMMAND 指令
Valgrind 命令选项
指定命令行选项 Valgrind命令 工具。 他们将被安置
在测试命令行之前。
· 测试 脚本 变量：无
· 测试 模块变量： VALGRIND_COMMAND_OPTIONS
测试 提交 步骤
在一个 测试 脚本， ctest_提交() 命令运行这一步。 命令的参数
可以指定一些步骤设置。
配置设置包括：
构建名称
用短字符串描述仪表板客户端平台。 （操作系统，
编译器等）
· 测试 脚本 变量： CTEST_BUILD_NAME
· 测试 模块变量： 建筑名称
CDash版本
指定版本 达世币 在服务器上。
· 测试 脚本 变量：无，从服务器检测到
· 测试 模块变量： CTEST_CDASH_版本
CTest提交重试次数
指定在网络故障时重试提交的次数。
· 测试 脚本 变量：无，使用 ctest_提交() RETRY_COUNT 个 选项。
· 测试 模块变量： CTEST_SUBMIT_RETRY_COUNT 个
CTest提交重试延迟
在网络故障时重试提交之前指定延迟。
· 测试 脚本 变量：无，使用 ctest_提交() 重试延迟 选项。
· 测试 模块变量： CTEST_SUBMIT_RETRY_DELAY
卷曲选项
指定一个以分号分隔的选项列表来控制 Curl 库
CTest 使用内部连接到服务器。 可能的选择是
CURLOPT_SSL_VERIFYPEER_OFF 和 CURLOPT_SSL_VERIFYHOST_OFF.
· 测试 脚本 变量： CTEST_CURL_OPTIONS
· 测试 模块变量： CTEST_CURL_OPTIONS
放置位置
仪表盘服务器上发送提交的路径。
· 测试 脚本 变量： CTEST_DROP_LOCATION
· 测试 模块变量： DROP_LOCATION 如果设置，否则 CTEST_DROP_LOCATION
丢弃方法
指定应将结果提交到仪表板服务器的方法。
该值可能是 cp, FTP, HTTP, HTTPS, SCP或 XMLRPC （如果 CMake 是用
支持它）。
· 测试 脚本 变量： CTEST_DROP_METHOD
· 测试 模块变量： 删除方法 如果设置，否则 CTEST_DROP_METHOD
网站
仪表板服务器名称（对于 FTP, HTTP和 HTTPS, SCP和 XMLRPC).
· 测试 脚本 变量： CTEST_DROP_SITE
· 测试 模块变量： 删除站点 如果设置，否则 CTEST_DROP_SITE
删除站点密码
仪表板服务器登录密码，如果有（对于 FTP, HTTP和 HTTPS).
· 测试 脚本 变量： CTEST_DROP_SITE_PASSWORD
· 测试 模块变量： DROP_SITE_PASSWORD 如果设置，否则 CTEST_DROP_SITE_PASWORD
删除站点用户
仪表板服务器登录用户名，如果有（对于 FTP, HTTP和 HTTPS).
· 测试 脚本 变量： CTEST_DROP_SITE_USER
· 测试 模块变量： DROP_SITE_USER 如果设置，否则 CTEST_DROP_SITE_USER
是CDash
指定仪表板服务器是否为 达世币 或较旧的仪表板服务器
实施需要 触发站点.
· 测试 脚本 变量： CTEST_DROP_SITE_CDASH
· 测试 模块变量： CTEST_DROP_SITE_CDASH
脚本命令
SCP 时使用的命令行工具 丢弃方法 is SCP.
· 测试 脚本 变量： CTEST_SCP_命令
· 测试 模块变量： SCP命令
网站 使用短字符串描述仪表板客户端主机站点。 （主机名、域、
等。）
· 测试 脚本 变量： CTEST_SITE网站
· 测试 模块变量： 站点, 由 站点名称（） 命令
触发站点
支持旧仪表板服务器实现的旧选项。 不使用时
是CDash 是真的。
· 测试 脚本 变量： CTEST_TRIGGER_SITE
· 测试 模块变量： 触发点 如果设置，否则 CTEST_TRIGGER_SITE
使用 onworks.net 服务在线使用 ctest
