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():
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 NinjaA continuación, ejecuta tu herramienta generadora preferida para compilar el ejecutable. En este caso, utilizamos Ninja:
ninjaCompilació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 += targetA continuación, ejecuta qmake y, por último, ejecuta make para compilar tu ejecutable:
qmake
makeNota: 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.