QtScrcpy单元测试指南：关键模块的QTest用例编写

2026-02-06 05:03:00作者：舒璇辛Bertina

测试框架搭建

QtScrcpy项目基于Qt框架开发，推荐使用Qt自带的QTest框架进行单元测试。首先需要在项目中创建测试目录结构，建议在根目录下新建tests文件夹，用于存放所有测试相关代码。测试项目的CMakeLists.txt配置示例如下：

cmake_minimum_required(VERSION 3.14)
project(QtScrcpyTests)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(Qt6 COMPONENTS Test Core Widgets REQUIRED)

add_executable(${PROJECT_NAME} 
    config_test.cpp
    mousetap_test.cpp
    audiooutput_test.cpp
)

target_link_libraries(${PROJECT_NAME} PRIVATE 
    Qt6::Test 
    Qt6::Core 
    Qt6::Widgets
    QtScrcpyCore
)

add_test(NAME ${PROJECT_NAME} COMMAND ${PROJECT_NAME})

配置模块测试

配置模块(QtScrcpy/util/config.cpp)是QtScrcpy的核心组件，负责应用程序的配置管理。以下是针对配置模块的QTest测试用例：

#include <QTest>
#include "util/config.h"

class ConfigTest : public QObject {
    Q_OBJECT

private slots:
    void initTestCase();
    void cleanupTestCase();
    void testConfigPath();
    void testUserData();
    void testWindowRect();

private:
    Config* m_config;
};

void ConfigTest::initTestCase() {
    m_config = &Config::getInstance();
}

void ConfigTest::cleanupTestCase() {
    // 清理测试产生的临时文件
    QFile::remove(Config::getConfigPath() + "/config.ini");
    QFile::remove(Config::getConfigPath() + "/userdata.ini");
}

void ConfigTest::testConfigPath() {
    QVERIFY(!Config::getConfigPath().isEmpty());
#ifdef Q_OS_OSX
    QVERIFY(Config::getConfigPath().contains("Contents/MacOS/config"));
#else
    QCOMPARE(Config::getConfigPath(), "config");
#endif
}

void ConfigTest::testUserData() {
    UserBootConfig bootConfig;
    bootConfig.bitRate = 4000000;
    bootConfig.recordPath = "/tmp/test_record.mp4";
    m_config->setUserBootConfig(bootConfig);

    UserBootConfig loadedConfig = m_config->getUserBootConfig();
    QCOMPARE(loadedConfig.bitRate, 4000000u);
    QCOMPARE(loadedConfig.recordPath, "/tmp/test_record.mp4");
}

void ConfigTest::testWindowRect() {
    QRect testRect(100, 200, 800, 600);
    m_config->setRect("test_serial", testRect);
    
    QRect loadedRect = m_config->getRect("test_serial");
    QCOMPARE(loadedRect, testRect);
}

QTEST_APPLESS_MAIN(ConfigTest)
#include "config_test.moc"

输入模拟模块测试

鼠标模拟模块(QtScrcpy/util/mousetap.cpp)负责处理不同操作系统下的鼠标事件模拟。以下是跨平台鼠标事件模拟的测试用例：

#include <QTest>
#include "util/mousetap.h"
#include "util/winmousetap.h"
#include "util/xmousetap.h"

class MouseTapTest : public QObject {
    Q_OBJECT

private slots:
    void testMouseTapCreation();
    void testMouseEvents();

private:
    MouseTap* m_mouseTap;
};

void MouseTapTest::testMouseTapCreation() {
#ifdef Q_OS_WIN
    m_mouseTap = new WinMouseTap();
#elif defined(Q_OS_LINUX)
    m_mouseTap = new XMouseTap();
#else
    QSKIP("Mouse tap test not implemented for this OS");
#endif
    QVERIFY(m_mouseTap != nullptr);
}

void MouseTapTest::testMouseEvents() {
    QVERIFY(m_mouseTap->tap(100, 200)); // 测试点击
    QVERIFY(m_mouseTap->swipe(100, 200, 300, 400, 500)); // 测试滑动
    QVERIFY(m_mouseTap->pressKey(AMOTION_EVENT_ACTION_DOWN, 0)); // 测试按键按下
    QVERIFY(m_mouseTap->pressKey(AMOTION_EVENT_ACTION_UP, 0)); // 测试按键释放
}

QTEST_APPLESS_MAIN(MouseTapTest)
#include "mousetap_test.moc"

音频输出模块测试

音频输出模块(QtScrcpy/audio/audiooutput.cpp)负责处理Android设备的音频播放。以下是音频输出功能的测试用例：

#include <QTest>
#include <QAudioFormat>
#include "audio/audiooutput.h"

class AudioOutputTest : public QObject {
    Q_OBJECT

private slots:
    void initTestCase();
    void cleanupTestCase();
    void testAudioFormat();
    void testAudioPlayback();

private:
    AudioOutput* m_audioOutput;
};

void AudioOutputTest::initTestCase() {
    m_audioOutput = new AudioOutput();
}

void AudioOutputTest::cleanupTestCase() {
    delete m_audioOutput;
}

void AudioOutputTest::testAudioFormat() {
    QAudioFormat format;
    format.setSampleRate(44100);
    format.setChannelCount(2);
    format.setSampleSize(16);
    format.setCodec("audio/pcm");
    format.setByteOrder(QAudioFormat::LittleEndian);
    format.setSampleType(QAudioFormat::SignedInt);

    QVERIFY(m_audioOutput->start(format));
}

void AudioOutputTest::testAudioPlayback() {
    // 创建测试音频数据
    QByteArray audioData(44100 * 2 * 2, 0); // 1秒的静音PCM数据
    
    m_audioOutput->write(audioData);
    QTest::qWait(1000); // 等待音频播放
    
    m_audioOutput->stop();
    QVERIFY(true); // 如果没有崩溃，测试通过
}

QTEST_APPLESS_MAIN(AudioOutputTest)
#include "audiooutput_test.moc"

测试执行与集成

将编写好的测试用例添加到项目构建系统后，可以使用以下命令执行测试：

cd build
cmake ..
make
ctest -V

测试结果将显示每个测试用例的执行情况，帮助开发人员快速定位问题。为确保代码质量，建议将单元测试集成到CI/CD流程中，项目中已有的CI配置文件(ci/linux/build_for_linux.sh)可以作为参考。

测试执行流程.jpg)

测试覆盖率分析

为了评估测试的完整性，可以使用Qt Creator的测试覆盖率工具或gcov等命令行工具生成测试覆盖率报告。以下是使用gcov的示例命令：

# 添加覆盖率编译选项
cmake -DCMAKE_CXX_FLAGS="--coverage" ..
make
ctest
lcov --capture --directory . --output-file coverage.info
genhtml coverage.info --output-directory coverage_report

生成的覆盖率报告将显示哪些代码行被测试覆盖，帮助开发人员识别未测试的代码区域，进一步完善测试用例。