En esta página

Funciones de prueba

Las funciones de prueba devuelven un valor booleano que se puede comprobar en las partes condicionales de los ámbitos. Las funciones de prueba se pueden dividir en funciones integradas y bibliotecas de funciones.

Véase también «Funciones de sustitución».

Funciones de prueba integradas

Las funciones de prueba básicas se implementan como funciones integradas.

cache(nombre_variable, [set|add|sub] [transient] [super|stash], [nombre_variable_fuente])

Se trata de una función interna que, por lo general, no necesitarás.

Esta función se introdujo en Qt 5.0.

CONFIG(config)

Esta función se puede utilizar para comprobar las variables almacenadas en la variable CONFIG. Es similar a scopes, pero tiene la ventaja añadida de que se puede pasar un segundo parámetro para comprobar la configuración activa. Dado que el orden de los valores es importante en las variables de CONFIG (es decir, el último valor establecido se considerará la configuración activa para valores mutuamente excluyentes), se puede utilizar un segundo parámetro para especificar un conjunto de valores a tener en cuenta. Por ejemplo:

CONFIG = debug
CONFIG += release
CONFIG(release, debug|release):message(Release build!) #will print
CONFIG(debug, debug|release):message(Debug build!) #no print

Dado que «release» se considera la configuración activa (para el análisis de características), será la CONFIG utilizada para generar el archivo de compilación. En el caso habitual no se necesita un segundo parámetro, pero para pruebas específicas mutuamente excluyentes resulta de gran utilidad.

contains(nombre_variable, valor)

Se ejecuta correctamente si la variable variablename contiene el valor value; en caso contrario, falla. Es posible especificar una expresión regular para el valor del parámetro.

Puedes comprobar el valor de retorno de esta función utilizando un ámbito.

Por ejemplo:

contains( drivers, network ) {
    # drivers contains 'network'
    message( "Configuring for network build..." )
    HEADERS += network.h
    SOURCES += network.cpp
}

El contenido del ámbito solo se procesa si la variable drivers contiene el valor network. Si es así, los archivos correspondientes se añaden a las variables SOURCES y HEADERS.

count(nombre_variable, número)

Se ejecuta correctamente si la variable variablename contiene una lista con el número number de valores especificado; de lo contrario, falla.

Esta función se utiliza para garantizar que las declaraciones dentro de un ámbito solo se procesen si la variable contiene el número correcto de valores. Por ejemplo:

options = $$find(CONFIG, "debug") $$find(CONFIG, "release")
count(options, 2) {
    message(Both release and debug specified.)
}

debug(nivel, mensaje)

Comprueba si qmake se ejecuta en el nivel de depuración especificado. En caso afirmativo, devuelve «true» y muestra un mensaje de depuración.

defined(nombre[, tipo])

Comprueba si la función o variable name está definida. Si se omite type, comprueba todas las funciones. Para comprobar solo variables o un tipo concreto de funciones, especifica type. Puede tomar los siguientes valores:

  • test solo comprueba las funciones de prueba
  • replace solo comprueba funciones de sustitución
  • var solo comprueba las variables

equals(nombre_variable, valor)

Comprueba si variablename es igual a la cadena value.

Por ejemplo:

TARGET = helloworld
equals(TARGET, "helloworld") {
    message("The target assignment was successful.")
}

error(cadena)

Esta función nunca devuelve un valor. qmake muestra « string » como mensaje de error al usuario y finaliza. Esta función solo debe utilizarse para errores irrecuperables.

Por ejemplo:

error(An error has occurred in the configuration process.)

eval(cadena)

Evalúa el contenido de la cadena utilizando las reglas sintácticas de qmake y devuelve «true». Se pueden utilizar definiciones y asignaciones en la cadena para modificar los valores de variables existentes o crear nuevas definiciones.

Por ejemplo:

eval(TARGET = myapp) {
    message($$TARGET)
}

Nota: Se pueden utilizarcomillas para delimitar la cadena, y el valor devuelto se puede descartar si no es necesario.

exists(nombre_archivo)

Comprueba si existe un archivo con el « filename » indicado. Si el archivo existe, la función se ejecuta con éxito; en caso contrario, falla.

El argumento « filename » puede contener caracteres comodín. En ese caso, esta función se ejecuta con éxito si hay algún archivo que coincida.

Por ejemplo:

exists( $(QTDIR)/lib/libqt-mt* ) {
      message( "Configuring for multi-threaded Qt..." )
      CONFIG += thread
}

Nota: Se debe utilizar« /» como separador de directorios, independientemente de la plataforma que se utilice.

export(nombre_de_variable)

Exporta el valor actual de variablename desde el contexto local de una función al contexto global.

for(iteración, lista)

Inicia un bucle que recorre todos los valores de list, asignando iterate a cada valor por turnos. Para mayor comodidad, si list es 1..10, entonces iterate recorrerá los valores del 1 al 10.

Por ejemplo:

LIST = 1 2 3
for(a, LIST):exists(file.$${a}):message(I see a file.$${a}!)

Los bucles se pueden interrumpir con ` break()`. La instrucción ` next() ` omite el resto del cuerpo del bucle y continúa la ejecución con la siguiente iteración.

greaterThan(nombre_variable, valor)

Comprueba si el valor de ` variablename ` es mayor que ` value`. En primer lugar, esta función intenta realizar una comparación numérica. Si al menos uno de los operandos no se puede convertir, esta función realiza una comparación de cadenas.

Por ejemplo:

ANSWER = 42
greaterThan(ANSWER, 1) {
    message("The answer might be correct.")
}

Es imposible comparar directamente dos números como cadenas. Como solución alternativa, se pueden crear valores temporales con un prefijo no numérico y comparar estos.

Por ejemplo:

VALUE = 123
TMP_VALUE = x$$VALUE
greaterThan(TMP_VALUE, x456): message("Condition may be true.")

Véase también lessThan().

if(condición)

Evalúa « condition ». Se utiliza para agrupar expresiones booleanas.

Por ejemplo:

if(linux-g++*|macx-g++*):CONFIG(debug, debug|release) {
    message("We are on Linux or Mac OS, and we are in debug mode.")
}

include(nombre_archivo)

Incluye el contenido del archivo especificado por filename en el proyecto actual en el punto en el que se incluye. Esta función se ejecuta correctamente si se incluye filename; en caso contrario, falla. El archivo incluido se procesa inmediatamente.

Puedes comprobar si el archivo se ha incluido utilizando esta función como condición para un ámbito. Por ejemplo:

include( shared.pri )
OPTIONS = standard custom
!include( options.pri ) {
    message( "No custom build options specified" )
OPTIONS -= custom
}

infile(nombre_archivo, var, val)

Se ejecuta correctamente si el archivo filename (al ser analizado por el propio qmake) contiene la variable var con el valor val; en caso contrario, falla. Si no se especifica val, la función comprueba si se ha asignado var en el archivo.

isActiveConfig

Se trata de un alias de la función CONFIG.

isEmpty(nombre_variable)

Se ejecuta correctamente si la variable variablename está vacía; en caso contrario, falla. Es equivalente a count( variablename, 0 ).

Por ejemplo:

isEmpty( CONFIG ) {
CONFIG += warn_on debug
}

isEqual

Es un alias de la función equals.

lessThan(nombre_variable, valor)

Comprueba si el valor de ` variablename ` es menor que ` value`. Funciona igual que `greaterThan()`.

Por ejemplo:

ANSWER = 42
lessThan(ANSWER, 1) {
    message("The answer might be wrong.")
}

load(feature)

Carga el archivo de características (.prf) especificado por feature, a menos que la característica ya se haya cargado.

log(message)

Muestra un mensaje en la consola. A diferencia de la función message, no antepone texto ni añade un salto de línea al final.

Esta función se introdujo en Qt 5.0.

Véase también message().

message(cadena)

Siempre se ejecuta con éxito y muestra « string » como mensaje general al usuario. A diferencia de la función error(), esta función permite que el procesamiento continúe.

message( "This is a message" )

La línea anterior hace que se escriba «This is a message» en la consola. El uso de comillas es opcional, pero recomendable.

Nota: Por defecto, se escriben mensajes para cada Makefile generado por qmake para un proyecto determinado. Si quieres asegurarte de que los mensajes solo aparezcan una vez por cada proyecto, prueba la variable ` build_pass ` junto con un ámbito para filtrar los mensajes durante las compilaciones. Por ejemplo:

!build_pass:message( "This is a message" )

mkpath(dirPath)

Crea la ruta de directorio dirPath. Esta función es una envoltura de la función QDir::mkpath.

Esta función se introdujo en Qt 5.0.

requires(condition)

Evalúa condition. Si la condición es falsa, qmake omite este proyecto (y sus SUBDIRS) durante la compilación.

Nota: Tambiénse puede utilizar la variable REQUIRES para este fin. Sin embargo, recomendamos utilizar esta función en su lugar.

system(comando)

Ejecuta el comando dado command en un shell secundario. Se ejecuta correctamente si el comando devuelve un estado de salida igual a cero; en caso contrario, falla. Se puede comprobar el valor de retorno de esta función utilizando un ámbito.

Por ejemplo:

system("ls /bin"): HAS_BIN = TRUE

Véase también la variante «replace» de system().

touch(nombre_archivo, nombre_archivo_de_referencia)

Actualiza la marca de tiempo de filename para que coincida con la marca de tiempo de reference_filename.

Esta función se introdujo en Qt 5.0.

unset(nombre_de_variable)

Elimina variablename del contexto actual.

Por ejemplo:

NARF = zort
unset(NARF)
!defined(NARF, var) {
    message("NARF is not defined.")
}

versionAtLeast(nombreDeVariable, númeroDeVersión)

Comprueba que el número de versión de variablename sea mayor o igual que versionNumber. El número de versión se considera una secuencia de números decimales no negativos delimitados por «.»; se ignorará cualquier parte no numérica al final de la cadena. La comparación se realiza por segmentos de izquierda a derecha; si una versión es un prefijo de la otra, se considera menor.

Esta función se introdujo en Qt 5.10.

versionAtMost(nombreDeVariable, númeroDeVersión)

Comprueba que el número de versión de variablename sea menor o igual que versionNumber. Funciona igual que versionAtLeast().

Esta función se introdujo en Qt 5.10.

warning(cadena)

Siempre se ejecuta con éxito y muestra string como mensaje de advertencia al usuario.

write_file(nombre_archivo, [nombre_variable, [modo]])

Escribe los valores de variablename en un archivo con el nombre filename, cada valor en una línea separada. Si no se especifica variablename, crea un archivo vacío. Si mode es append y el archivo ya existe, añade el contenido al final en lugar de sustituirlo.

Esta función se introdujo en Qt 5.0.

Biblioteca de funciones de prueba

Las funciones de prueba complejas se implementan en una biblioteca de archivos .prf.

packagesExist(packages)

Utiliza el mecanismo PKGCONFIG para determinar si los paquetes indicados existen o no en el momento del análisis del proyecto.

Esto puede resultar útil para habilitar o deshabilitar funciones de forma opcional. Por ejemplo:

packagesExist(sqlite3 QtNetwork QtDeclarative) {
    DEFINES += USE_FANCY_UI
}

Y luego, en el código:

#ifdef USE_FANCY_UI
    // Use the fancy UI, as we have extra packages available
#endif

prepareRecursiveTarget(target)

Facilita la creación de objetivos para todo el proyecto, similares al objetivo install, preparando un objetivo que recorre todos los subdirectorios. Por ejemplo:

TEMPLATE = subdirs
SUBDIRS = one two three
prepareRecursiveTarget(check)

Los subdirectorios que tengan especificado « have_no_default » o « no_<target>_target » en su archivo .CONFIG quedan excluidos de este objetivo:

two.CONFIG += no_check_target

Debes añadir manualmente el objetivo preparado a QMAKE_EXTRA_TARGETS:

QMAKE_EXTRA_TARGETS += check

Para que el objetivo sea global, el código anterior debe incluirse en todos los subproyectos de los subdirectorios. Además, para que estos objetivos funcionen, los subproyectos que no sean de subdirectorios deben incluir el código correspondiente. La forma más sencilla de lograrlo es creando un archivo de características personalizado. Por ejemplo:

# <project root>/features/mycheck.prf
equals(TEMPLATE, subdirs) {
    prepareRecursiveTarget(check)
} else {
    check.commands = echo hello user
}
QMAKE_EXTRA_TARGETS += check

El archivo de características debe incorporarse a cada subproyecto, por ejemplo, mediante .qmake.conf:

# <project root>/.qmake.conf
CONFIG += mycheck

Esta función se introdujo en Qt 5.0.

qtCompileTest(test)

Compila un proyecto de prueba. Si la prueba se supera, se devuelve «true» y se añade « config_<test> » a la variable CONFIG. De lo contrario, se devuelve «false».

Para que esta función esté disponible, es necesario cargar el archivo de características correspondiente:

# <project root>/project.pro
load(configure)

Esto también establece la variable QMAKE_CONFIG_TESTS_DIR en el subdirectorio « config.tests » del directorio principal del proyecto. Es posible sobrescribir este valor tras cargar el archivo de características.

Dentro del directorio «tests», debe haber un subdirectorio por cada prueba que contenga un proyecto qmake sencillo. El siguiente fragmento de código ilustra el archivo .pro del proyecto:

# <project root>/config.tests/test/test.pro
SOURCES = main.cpp
LIBS += -ltheFeature
# Note that the test project is built without Qt by default.

El siguiente fragmento de código ilustra el archivo .cpp principal del proyecto:

// <project root>/config.tests/test/main.cpp
#include <TheFeature/MainHeader.h>
int main() { return featureFunction(); }

El siguiente fragmento de código muestra cómo se ejecuta la prueba:

# <project root>/project.pro
qtCompileTest(test)

Si el proyecto de prueba se compila correctamente, la prueba se supera.

Los resultados de las pruebas se almacenan automáticamente en la caché, lo que también los pone a disposición de todos los subproyectos. Por lo tanto, se recomienda ejecutar todas las pruebas de configuración en el archivo de proyecto de nivel superior.

Para desactivar la reutilización de los resultados almacenados en caché, pasa ` CONFIG+=recheck ` a `qmake`.

Véase también load().

Esta función se introdujo en Qt 5.0.

qtHaveModule(name)

Comprueba si existe el módulo Qt especificado por name. Para ver una lista de los valores posibles, consulta QT.

Esta función se introdujo en Qt 5.0.1.

© 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.