En esta página

Capítulo 1: Cómo escribir una prueba unitaria

Este primer capítulo muestra cómo escribir una prueba unitaria sencilla y cómo ejecutar el caso de prueba como un ejecutable independiente.

Cómo escribir una prueba

Supongamos que quieres probar el comportamiento de nuestra clase ` QString `. En primer lugar, necesitas una clase que contenga tus funciones de prueba. Esta clase debe heredar de ` QObject`:

#include <QTest>

class TestQString: public QObject
{
    Q_OBJECT
private slots:
    void toUpper();
};

Nota: Debes incluir el encabezado ` QTest ` y declarar las funciones de prueba como slots privados para que el marco de pruebas las encuentre y las ejecute.

A continuación, hay que implementar la propia función de prueba. La implementación podría tener este aspecto:

void TestQString::toUpper()
{
    QString str = "Hello";
    QVERIFY(str.toUpper() == "HELLO");
}

La macro ` QVERIFY()` evalúa la expresión pasada como argumento. Si la expresión se evalúa como verdadera, la ejecución de la función de prueba continúa. De lo contrario, se añade al registro de pruebas un mensaje que describe el fallo y la función de prueba deja de ejecutarse.

Pero si quieres una salida más detallada en el registro de pruebas, deberías utilizar en su lugar la macro QCOMPARE():

void TestQString::toUpper()
{
    QString str = "Hello";
    QCOMPARE(str.toUpper(), QString("HELLO"));
}

Si las cadenas no son iguales, el contenido de ambas cadenas se añade al registro de pruebas, lo que permite ver de inmediato por qué ha fallado la comparación.

Preparación del ejecutable independiente

Por último, para convertir nuestro caso de prueba en un ejecutable independiente, se necesitan las dos líneas siguientes:

QTEST_MAIN(TestQString)
#include "testqstring.moc"

La macro QTEST_MAIN() se expande en un sencillo método main() que ejecuta todas las funciones de prueba. Ten en cuenta que, si tanto la declaración como la implementación de nuestra clase de prueba se encuentran en un archivo .cpp, también debemos incluir el archivo moc generado para que funcione la introspección de Qt.

Compilación del ejecutable

Puedes compilar el ejecutable del caso de prueba utilizando CMake o qmake.

Compilación con CMake

Configura los parámetros de compilación en tu archivo CMakeLists.txt:

# Copyright (C) 2022 The Qt Company Ltd.
# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause

cmake_minimum_required(VERSION 3.16)
project(tutorial1 LANGUAGES CXX)

find_package(Qt6 REQUIRED COMPONENTS Core Gui Test Widgets)

qt_standard_project_setup()

qt_add_executable(tutorial1
    testqstring.cpp
)

set_target_properties(tutorial1 PROPERTIES
    WIN32_EXECUTABLE TRUE
    MACOSX_BUNDLE TRUE
)

target_link_libraries(tutorial1 PRIVATE
    Qt6::Core
    Qt6::Gui
    Qt6::Test
    Qt6::Widgets
)

install(TARGETS tutorial1
    BUNDLE  DESTINATION .
    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
)

qt_generate_deploy_app_script(
    TARGET tutorial1
    OUTPUT_SCRIPT deploy_script
    NO_UNSUPPORTED_PLATFORM_ERROR
)
install(SCRIPT ${deploy_script})

A continuación, desde la línea de comandos, ejecuta « cmake » o utiliza el script de conveniencia « qt-cmake », ubicado en « Qt-prefix/<version>/<platform>/bin/qt-cmake »:

<Qt-prefix>/<version>/<platform>/bin/qt-cmake <source-dir> <build-dir> -G Ninja

A continuación, ejecuta tu herramienta generadora preferida para compilar el ejecutable. En este caso, utilizamos Ninja:

ninja

Compilación con qmake

Configura los ajustes de compilación en tu archivo « .pro »:

QT += widgets testlib

SOURCES = testqstring.cpp

# install
target.path = $$[QT_INSTALL_EXAMPLES]/qtestlib/tutorial1
INSTALLS += target

A continuación, ejecuta qmake y, por último, ejecuta make para compilar tu ejecutable:

qmake
make

Nota: Si utilizas Windows, sustituye make por nmake o por la herramienta de compilación que utilices.

Ejecución del ejecutable

Al ejecutar el ejecutable resultante, deberías obtener el siguiente resultado:

********* Start testing of TestQString *********
Config: Using QtTest library %VERSION%, Qt %VERSION%
PASS   : TestQString::initTestCase()
PASS   : TestQString::toUpper()
PASS   : TestQString::cleanupTestCase()
Totals: 3 passed, 0 failed, 0 skipped
********* Finished testing of TestQString *********

¡Enhorabuena! Acabas de escribir y ejecutar tu primera prueba unitaria utilizando el marco de trabajo Qt Test.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.