Compilación de tipos de proyectos habituales
En este capítulo se describe cómo configurar los archivos de proyecto de qmake para tres tipos de proyectos habituales basados en Qt: aplicación, biblioteca y complemento. Aunque todos los tipos de proyectos utilizan muchas de las mismas variables, cada uno de ellos emplea variables específicas del proyecto para personalizar los archivos de salida.
Las variables específicas de cada plataforma no se describen aquí. Para obtener más información, consulta Qt para Windows: implementación y Qt para macOS.
Compilación de una aplicación
La plantilla « app » indica a qmake que genere un Makefile que compile una aplicación. Con esta plantilla, se puede especificar el tipo de aplicación añadiendo una de las siguientes opciones a la definición de la variable CONFIG:
| Opción | Descripción |
|---|---|
| windows | La aplicación es una aplicación GUI para Windows. |
| console | app solo plantilla: la aplicación es una aplicación de consola de Windows. |
| caso de prueba | La aplicación es una prueba automatizada. |
Al utilizar esta plantilla, se reconocen las siguientes variables de sistema de qmake. Debes utilizarlas en tu archivo .pro para especificar información sobre tu aplicación. Para conocer otras variables de sistema dependientes de la plataforma, puedes consultar las Notas sobre la plataforma.
- HEADERS: una lista de archivos de cabecera para la aplicación.
- SOURCES: una lista de archivos fuente C++ para la aplicación.
- FORMS: una lista de archivos de interfaz de usuario para la aplicación (creados con Qt Widgets Designer).
- LEXSOURCES: una lista de archivos fuente Lex para la aplicación.
- YACCSOURCES: una lista de archivos fuente de Yacc para la aplicación.
- TARGET: nombre del ejecutable de la aplicación. Por defecto, es el nombre del archivo de proyecto. (La extensión, si la hay, se añade automáticamente).
- DESTDIR: el directorio en el que se coloca el ejecutable de destino.
- DEFINES: una lista de las definiciones de preprocesador adicionales necesarias para la aplicación.
- INCLUDEPATH: una lista de las rutas de inclusión adicionales necesarias para la aplicación.
- DEPENDPATH: la ruta de búsqueda de dependencias para la aplicación.
- VPATH: la ruta de búsqueda para localizar los archivos proporcionados.
- DEF_FILE - Solo para Windows: un archivo .def con el que se va a enlazar la aplicación.
Solo es necesario utilizar las variables del sistema para las que se disponga de valores. Por ejemplo, si no tienes ninguna ruta INCLUDEPATH adicional, no es necesario que especifiques ninguna. qmake añadirá los valores por defecto necesarios. Un archivo de proyecto de ejemplo podría tener este aspecto:
TEMPLATE = app
DESTDIR = c:/helloapp
HEADERS += hello.h
SOURCES += hello.cpp
SOURCES += main.cpp
DEFINES += USE_MY_STUFF
CONFIG += releasePara los elementos que tienen un único valor, como la plantilla o el directorio de destino, utilizamos «=»; pero para los elementos con varios valores utilizamos «+=» para añadirlos a los elementos existentes de ese tipo. El uso de «=» sustituye el valor de la variable por el nuevo valor. Por ejemplo, si escribimos DEFINES=USE_MY_STUFF, se eliminan todas las demás definiciones.
Creación de un caso de prueba
Un proyecto de caso de prueba es un proyecto app destinado a ejecutarse como una prueba automatizada. Cualquier app puede marcarse como caso de prueba añadiendo el valor testcase a la variable CONFIG.
En el caso de los proyectos de casos de prueba, qmake insertará un objetivo « check » en el Makefile generado. Este objetivo ejecutará la aplicación. Se considera que la prueba se ha superado si finaliza con un código de salida igual a cero.
El objetivo « check » recorre automáticamente de forma recursiva los proyectos de «SUBDIRS ». Esto significa que es posible ejecutar el comando « make check » desde dentro de un proyecto de «SUBDIRS» para ejecutar un conjunto completo de pruebas.
La ejecución del objetivo « check » puede personalizarse mediante determinadas variables del Makefile. Estas variables son:
| Variable | Descripción |
|---|---|
| TESTRUNNER | Un comando o fragmento de shell que se antepone a cada comando de prueba. Un ejemplo de uso es un script de «tiempo de espera» que dará por terminada una prueba si no se completa en un tiempo determinado. |
| TESTARGS | Argumentos adicionales añadidos al final de cada comando de prueba. Por ejemplo, puede resultar útil pasar argumentos adicionales para configurar el archivo de salida y el formato de la prueba (como la opción -o filename,format que admite QTestLib). |
Nota: Las variables deben configurarse al ejecutar la herramienta make, no en el archivo .pro. La mayoría de las herramientas de make admiten la configuración de variables de Makefile directamente en la línea de comandos:
# Run tests through test-wrapper and use JUnit XML output format.
# In this example, test-wrapper is a fictional wrapper script which terminates
# a test if it does not complete within the amount of seconds set by "--timeout".
# The "-o result.xml,junitxml" options are interpreted by QTestLib.
make check TESTRUNNER="test-wrapper --timeout 120" TESTARGS="-o result.xml,junitxml"Los proyectos de casos de prueba se pueden personalizar aún más con las siguientes opciones de CONFIG:
| Opción | Descripción |
|---|---|
| insignificant_test | El código de salida de la prueba se ignorará durante la ejecución de make check. |
Los casos de prueba suelen escribirse con « QTest » o « TestCase », pero no es obligatorio utilizar « CONFIG+=testcase » ni « make check ». El único requisito fundamental es que el programa de prueba finalice con un código de salida igual a cero en caso de éxito y con un código de salida distinto de cero en caso de fallo.
Compilación de una biblioteca
La plantilla lib indica a qmake que genere un Makefile que compile una biblioteca. Al utilizar esta plantilla, se admite la variable VERSION, además de las variables del sistema que admite la plantilla app. Utiliza las variables en tu archivo .pro para especificar información sobre la biblioteca.
Al utilizar la plantilla « lib », se pueden añadir las siguientes opciones a la variable CONFIG para determinar el tipo de biblioteca que se va a compilar:
| Opción | Descripción |
|---|---|
| dll | La biblioteca es una biblioteca compartida (dll). |
| staticlib | La biblioteca es una biblioteca estática. |
| plugin | La biblioteca es un complemento. |
También se puede definir la siguiente opción para proporcionar información adicional sobre la biblioteca.
- VERSION: el número de versión de la biblioteca de destino. Por ejemplo, 2.3.1.
El nombre del archivo de destino de la biblioteca depende de la plataforma. Por ejemplo, en X11, macOS e iOS, el nombre de la biblioteca llevará el prefijo « lib ». En Windows, no se añade ningún prefijo al nombre del archivo.
Compilación de un complemento
Los complementos se compilan utilizando la plantilla lib, tal y como se describe en la sección anterior. Esto indica a qmake que genere un Makefile para el proyecto que compile un complemento en un formato adecuado para cada plataforma, normalmente en forma de biblioteca. Al igual que con las bibliotecas normales, la variable VERSION se utiliza para especificar información sobre el complemento.
- VERSION: el número de versión de la biblioteca de destino. Por ejemplo, 2.3.1.
Compilación de un complemento « Qt Widgets Designer »
Qt Widgets Designer Los complementos se compilan utilizando un conjunto específico de ajustes de configuración que dependen de cómo se haya configurado Qt en su sistema. Para mayor comodidad, estos ajustes se pueden habilitar añadiendo designer a la variable QT. Por ejemplo:
QT += widgets designerConsulte los ejemplos deQt Widgets Designer para ver más ejemplos de proyectos basados en complementos.
Compilación e instalación en los modos de depuración y de lanzamiento
A veces, es necesario compilar un proyecto tanto en modo de depuración como en modo de lanzamiento. Aunque la variable CONFIG puede contener tanto la opción debug como la release, solo se aplica la opción especificada en último lugar.
Compilación en ambos modos
Para que un proyecto se pueda compilar en ambos modos, debes añadir la opción debug_and_release a la variable CONFIG:
CONFIG += debug_and_release
CONFIG(debug, debug|release) {
TARGET = debug_binary
} else {
TARGET = release_binary
}El ámbito del fragmento de código anterior modifica el objetivo de compilación en cada modo para garantizar que los objetivos resultantes tengan nombres diferentes. Asignar nombres diferentes a los objetivos garantiza que uno no sobrescriba al otro.
Cuando qmake procesa el archivo de proyecto, genera una regla Makefile que permite compilar el proyecto en ambos modos. Esta regla se puede invocar de la siguiente manera:
make allLa opción « build_all » se puede añadir a la variable « CONFIG » en el archivo de proyecto para garantizar que el proyecto se compile en ambos modos de forma predeterminada:
CONFIG += build_allEsto permite que el Makefile se procese utilizando la regla predeterminada:
makeInstalación en ambos modos
La opción « build_all » también garantiza que se instalen ambas versiones del objetivo cuando se invoque la regla de instalación:
make installEs posible personalizar los nombres de los objetivos de compilación en función de la plataforma de destino. Por ejemplo, una biblioteca o un complemento pueden nombrarse en Windows siguiendo una convención diferente a la utilizada en plataformas Unix:
CONFIG(debug, debug|release) {
mac: TARGET = $$join(TARGET,,,_debug)
win32: TARGET = $$join(TARGET,,d)
}El comportamiento por defecto en el fragmento anterior es modificar el nombre utilizado para el objetivo de compilación al compilar en modo de depuración. Se podría añadir una cláusula « else » al ámbito para hacer lo mismo en el modo de lanzamiento. Si se deja tal cual, el nombre del objetivo permanece sin modificar.
© 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.