应用程序扩展 C++应用程序

自测试运行器

运行项目中所有自测试的产品。 更多...

属性

详细描述

自测试运行器依赖所有具有 "autotest" 类型的 产品。因此，构建自测试运行器产品将会运行相应的可执行文件。默认情况下，将 builtByDefault 属性设置为 false，因此运行自测试必须明确请求。默认的产品名称为 "autotest-runner"。

要使用此功能

  1. 将 "autotest" 类型附加到您的自测试中
    CppApplication {
    name: "tst_mytest"
    type: ["application", "autotest"]
    // ...
}
  2. 在项目中选择一个精确的自测试运行器实例，通常在最顶层
    Project {
    // ...
    AutotestRunner { }
    // ...
}
  3. 通过构建产品触发自测试执行
    qbs build -p autotest-runner

为单个测试设置属性

为了控制单个测试的行为，可以通过依赖自测试模块并设置其属性来覆盖一些 AutotestRunner 的属性。

CppApplication {
    name: "tst_mytest"
    type: ["application", "autotest"]

    Depends { name: "autotest" }

    autotest.timeout: 60

    // ...
}

相关的作业池

池自从说明
"autotest-runner"1.15运行测试所使用的作业池。

属性文档

arguments : 字符串列表

调用自测试时要使用的参数列表。一个测试可以通过设置autotest模块的参数属性来覆盖此属性。

默认值: []


[从 Qbs 1.12 开始] auxiliaryInputs : 字符串列表

此属性可以包含任意文件标签。自测试运行器将获得所有产品类型的依赖关系，只要其中一个与这些标签匹配，则测试可执行文件的调用将仅在相应工件构建完毕后发生。如果您的测试可执行文件在其他产品上具有运行时依赖关系，请设置此属性。

默认值: 未定义

此属性是从 Qbs 1.12 中引入的。


environment : 字符串列表

以下是在运行环境追加的环境变量列表。它们按“变量名=值”的格式提供，作为字符串列表。

默认值：在 macOS 上设置为 DYLD_LIBRARY_PATH、DYLD_FRAMEWORK_PATH 和 DYLD_ROOT_PATH，在其他平台上则为空列表。


limitToSubProject : bool

默认情况下，只有与 AutotestRunner 实例化相同的子项目中的 autotest 被认为是已考虑的。如果您想运行所有 autotest，而不管它们的在项目结构中的位置，请将此属性设置为 false。

默认值：true


[自 Qbs 1.15 起使用] timeout : int

个测试执行的时限。如果测试在时限内没有完成，测试将被取消并被认为是失败的。值小于或等于0表示没有时限。测试可以通过设置 autotest 模块的 autotest 属性来覆盖此值。

默认值：-1

此属性是在 Qbs 1.15 中引入的。


[自 Qbs 1.12 起使用] workingDir : string

如果设置此属性，它将是所有调用的测试可执行文件的工作目录。否则，工作目录将是相应的可执行文件的父目录。测试可以通过设置 autotest 模块的 autotest 属性来覆盖此值。

默认值: 未定义

此属性是从 Qbs 1.12 中引入的。


wrapper : stringList

包装二进制及其参数，用于包装 autotest 调用。这对于 Valgrind 等工具非常有用。

默认值：空


ApplicationExtension CppApplication

©2023 The Qt Company Ltd。包含在本处的文档贡献是各自拥有者的版权。本提供的文档是根据自由软件基金会发布的 GNU 自由文档许可协议版本 1.3 的条款许可的。Qt 和相关徽标是芬兰和/或其他国家的 The Qt Company Ltd 的商标。所有其他商标均为其各自所有者的财产。