Qt Test功能及架构-优快云博客

本文链接：https://blog.youkuaiyun.com/kangjunfei/article/details/148492483

Qt Test 是 Qt 框架中的单元测试模块，在 Qt 6.0 中提供了全面的测试功能。

一、主要功能

核心功能

1. 单元测试框架

提供完整的单元测试基础设施
支持测试用例、测试套件的组织和执行
包含断言宏和测试结果收集

2. 测试类型支持

单元测试：对单个函数或类的测试
GUI 测试：对图形用户界面的测试
基准测试：性能测量和比较
数据驱动测试：使用不同输入数据运行相同测试逻辑

主要组件

1. 测试宏

QVERIFY(condition)      // 验证条件为真
QCOMPARE(actual, expected) // 比较实际值和期望值
QTRY_VERIFY(condition)  // 异步验证，带超时
QTEST_MAIN(TestClass)   // 生成main()函数

2. 测试类

QTest：核心测试功能命名空间
QSignalSpy：用于监视信号发射
QTestEventList：模拟用户输入事件

Qt 6.0 中的新特性

改进的 CMake 集成：更好地支持现代 CMake 项目结构
增强的基准测试：更精确的计时和统计功能
更好的 Qt Quick 测试支持：改进对 QML 应用的测试能力
C++17 兼容性：充分利用现代 C++ 特性

基本测试示例

#include <QtTest>

class TestMath : public QObject
{
    Q_OBJECT
private slots:
    void testAddition()
    {
        QCOMPARE(1 + 1, 2);
    }
    
    void testString_data()
    {
        QTest::addColumn<QString>("string");
        QTest::addColumn<bool>("result");
        
        QTest::newRow("empty") << "" << true;
        QTest::newRow("non-empty") << "test" << false;
    }
    
    void testString()
    {
        QFETCH(QString, string);
        QFETCH(bool, result);
        QCOMPARE(string.isEmpty(), result);
    }
};

QTEST_MAIN(TestMath)
#include "testmath.moc"

高级功能

GUI 测试：
- 模拟鼠标点击、键盘输入
- 验证窗口属性和小部件状态

基准测试：

void benchmarkLoop()
{
    QString str;
    QBENCHMARK {
        str = "test";
        str.append("123");
    }
}

异步测试：
- 使用 QSignalSpy 等待信号
- QTRY_VERIFY 和 QTRY_COMPARE 宏
测试覆盖率：
- 与覆盖率工具（如 gcov、lcov）集成
- 支持生成覆盖率报告

测试执行

命令行执行：
```
./testname -o result.xml,xunit
```
输出格式：
- 纯文本
- XML（兼容xUnit）
- CSV
- LightXML
测试选择：
- 按测试函数名选择执行
- 按数据行选择执行

与 CI/CD 集成

支持主流持续集成系统
可生成机器可读的测试结果
可与 CMake/CTest 集成

Qt 6.0 的 Test 模块为 Qt 应用程序提供了全面的测试解决方案，从简单的单元测试到复杂的 GUI 和性能测试，帮助开发者构建高质量的 Qt 应用程序。

二、架构解析

1. 整体架构概览

Qt Test 模块的架构可分为以下几个核心层次：

层级	功能	关键组件
测试声明层	定义测试用例、数据驱动测试	`QTEST_MAIN`, `Q_DECLARE_TEST`, `QTEST_*` 宏
测试执行引擎	运行测试、管理测试生命周期	`QTest::qExec()`, `QTestEventLoop`
断言与验证	提供测试断言和结果检查	`QVERIFY`, `QCOMPARE`, `QTRY_*` 宏
模拟与事件	GUI 测试、信号监测、事件模拟	`QSignalSpy`, `QTestEventList`
基准测试	性能测量与统计	`QBENCHMARK`, `QTest::setBenchmarkResult()`
输出与报告	生成测试报告（文本、XML、JUnit）	`QTestLog`, `QTestResult`

2. 核心组件详解

(1) 测试声明与运行

QTEST_MAIN 宏：自动生成 main() 函数，调用 QTest::qExec() 执行测试。
测试类：继承 QObject，并使用 Q_OBJECT 宏，测试函数声明为 private slots。
数据驱动测试：使用 QTest::addColumn() 和 QTest::newRow() 定义测试数据表。

#include <QtTest>

class TestExample : public QObject {
    Q_OBJECT
private slots:
    void testCase1() { QVERIFY(1 + 1 == 2); }
    void testCase2_data();
    void testCase2();
};

void TestExample::testCase2_data() {
    QTest::addColumn<int>("input");
    QTest::addColumn<int>("expected");
    QTest::newRow("case1") << 1 << 2;
    QTest::newRow("case2") << 2 << 4;
}

void TestExample::testCase2() {
    QFETCH(int, input);
    QFETCH(int, expected);
    QCOMPARE(input * 2, expected);
}

QTEST_MAIN(TestExample)
#include "testexample.moc"

(2) 测试执行引擎

QTest::qExec()：核心测试运行器，管理测试生命周期（initTestCase(), cleanupTestCase()）。
事件循环集成：支持异步测试（QTestEventLoop）。
测试选择：支持按名称筛选测试用例（./test -functions）。

(3) 断言与验证

宏	用途
`QVERIFY(cond)`	检查条件是否为 `true`
`QCOMPARE(actual, expected)`	比较实际值和期望值
`QTRY_VERIFY(cond)`	异步等待条件成立（带超时）
`QTRY_COMPARE(actual, expected)`	异步比较（带超时）
`QFAIL(msg)`	强制测试失败

(4) 模拟与事件

QSignalSpy：监听信号发射次数及参数。
QTestEventList：模拟鼠标、键盘事件。

// 监听信号
QSignalSpy spy(button, &QPushButton::clicked);
QTest::mouseClick(button, Qt::LeftButton);
QCOMPARE(spy.count(), 1);

// 模拟键盘输入
QTest::keyClick(lineEdit, Qt::Key_A);
QCOMPARE(lineEdit->text(), "A");

(5) 基准测试

QBENCHMARK：测量代码执行时间。
QTest::setBenchmarkResult()：自定义基准结果。

void BenchmarkExample::testStringConcat() {
    QString str;
    QBENCHMARK {
        str += "test";
    }
    QVERIFY(!str.isEmpty());
}

(6) 输出与报告

支持多种格式：
- 文本（默认）
- XML（-o result.xml,xunit）
- JUnit（CI/CD 集成）
日志控制：
- -silent（静默模式）
- -v1/-v2（详细输出）

3. Qt 6.0 的改进

CMake 集成优化：
- 使用 find_package(Qt6 REQUIRED COMPONENTS Test) 引入测试模块。
- 支持 qt_add_test() 自动注册测试到 CTest。
C++17 支持：
- 更高效的模板元编程优化。
- 改进的 QSignalSpy 实现。
Qt Quick 测试增强：
- 更好的 QML 单元测试支持（QUICK_TEST_MAIN）。