Primeros pasos con qmake
Este tutorial te enseña los conceptos básicos de qmake. Los demás apartados de este manual contienen información más detallada sobre el uso de qmake.
Empezando por lo sencillo
Supongamos que acabas de terminar una implementación básica de tu aplicación y que has creado los siguientes archivos:
- hello.cpp
- hello.h
- main.cpp
Encontrarás estos archivos en el directorio « examples/qmake/tutorial » de la distribución de Qt. Lo único que sabes sobre la configuración de la aplicación es que está escrita en Qt. En primer lugar, utilizando tu editor de texto plano favorito, crea un archivo llamado « hello.pro » en « examples/qmake/tutorial ». Lo primero que debes hacer es añadir las líneas que indican a qmake cuáles son los archivos fuente y de cabecera que forman parte de tu proyecto de desarrollo.
Añadiremos primero los archivos fuente al archivo de proyecto. Para ello, debes utilizar la variable SOURCES. Empieza una nueva línea con « SOURCES += » y escribe «hello.cpp» a continuación. Deberías tener algo como esto:
SOURCES += hello.cppRepetimos esto para cada archivo fuente del proyecto, hasta que obtengamos lo siguiente:
SOURCES += hello.cpp
SOURCES += main.cppSi prefieres utilizar una sintaxis similar a la de Make, con todos los archivos enumerados de una sola vez, puedes utilizar el escape de nueva línea de la siguiente manera:
SOURCES = hello.cpp \
main.cppAhora que los archivos fuente aparecen en el archivo de proyecto, hay que añadir los archivos de cabecera. Estos se añaden exactamente de la misma forma que los archivos fuente, salvo que la variable que utilizamos es HEADERS.
Una vez hecho esto, tu archivo de proyecto debería tener un aspecto similar a este:
HEADERS += hello.h
SOURCES += hello.cpp
SOURCES += main.cppEl nombre del objetivo se establece automáticamente. Es el mismo que el nombre del archivo de proyecto, pero con el sufijo adecuado para la plataforma. Por ejemplo, si el archivo de proyecto se llama « hello.pro », el objetivo será « hello.exe » en Windows y « hello » en Unix. Si quieres utilizar un nombre diferente, puedes establecerlo en el archivo de proyecto:
TARGET = helloworldEl archivo de proyecto final debería tener este aspecto:
HEADERS += hello.h
SOURCES += hello.cpp
SOURCES += main.cppAhora puedes utilizar qmake para generar un Makefile para tu aplicación. En la línea de comandos, desde el directorio de tu proyecto, escribe lo siguiente:
qmake -o Makefile hello.proNota: Si has instalado Qt a través de un gestor de paquetes, el binario podría ser qmake6.
A continuación, escribe make o nmake, dependiendo del compilador que utilices.
Para los usuarios de Visual Studio, qmake también puede generar archivos de proyecto de Visual Studio. Por ejemplo:
qmake -tp vc hello.proCómo hacer que una aplicación sea depurable
La versión final de una aplicación no contiene símbolos de depuración ni otra información de depuración. Durante el desarrollo, resulta útil crear una versión de depuración de la aplicación que incluya la información pertinente. Esto se consigue fácilmente añadiendo debug a la variable CONFIG en el archivo de proyecto.
Por ejemplo:
CONFIG += debug
HEADERS += hello.h
SOURCES += hello.cpp
SOURCES += main.cppUtiliza qmake como antes para generar un Makefile. Ahora obtendrás información útil sobre tu aplicación al ejecutarla en un entorno de depuración.
Añadir archivos fuente específicos de la plataforma
Tras unas horas de programación, es posible que hayas empezado a trabajar en la parte específica de la plataforma de tu aplicación y hayas decidido mantener el código dependiente de la plataforma por separado. Así pues, ahora tienes dos nuevos archivos que incluir en tu archivo de proyecto: hellowin.cpp y hellounix.cpp. No podemos limitarnos a añadirlos a la variabl SOURCES, ya que eso colocaría ambos archivos en el Makefile. Por lo tanto, lo que debemos hacer aquí es utilizar un ámbito que se procesará en función de la plataforma para la que estemos compilando.
Un ámbito sencillo que añade el archivo específico de la plataforma para Windows tiene este aspecto:
win32 {
SOURCES += hellowin.cpp
}Al compilar para Windows, qmake añade hellowin.cpp a la lista de archivos fuente. Al compilar para cualquier otra plataforma, qmake simplemente lo ignora. Ahora solo queda crear un ámbito para el archivo específico de Unix.
Una vez hecho esto, tu archivo de proyecto debería tener un aspecto similar a este:
CONFIG += debug
HEADERS += hello.h
SOURCES += hello.cpp
SOURCES += main.cpp
win32 {
SOURCES += hellowin.cpp
}
unix {
SOURCES += hellounix.cpp
}Utiliza qmake como antes para generar un Makefile.
Detener qmake si un archivo no existe
Es posible que no quieras crear un Makefile si un determinado archivo no existe. Podemos comprobar si un archivo existe utilizando la función `exists() `. Podemos detener el procesamiento de qmake utilizando la función `error()`. Esto funciona de la misma manera que los ámbitos. Basta con sustituir la condición del ámbito por la función. Una comprobación de un archivo llamado `main.cpp` tiene este aspecto:
!exists( main.cpp ) {
error( "No main.cpp file found" )
}El símbolo « ! » se utiliza para negar la comprobación. Es decir, « exists( main.cpp ) » es verdadero si el archivo existe, y « !exists( main.cpp ) » es verdadero si el archivo no existe.
CONFIG += debug
HEADERS += hello.h
SOURCES += hello.cpp
SOURCES += main.cpp
win32 {
SOURCES += hellowin.cpp
}
unix {
SOURCES += hellounix.cpp
}
!exists( main.cpp ) {
error( "No main.cpp file found" )
}Utiliza qmake como antes para generar un archivo makefile. Si cambias temporalmente el nombre de « main.cpp », aparecerá el mensaje y qmake dejará de procesar.
Comprobación de más de una condición
Supongamos que utilizas Windows y quieres poder ver la salida de la instrucción con qDebug() al ejecutar tu aplicación desde la línea de comandos. Para ver la salida, debes compilar tu aplicación con la configuración de consola adecuada. Podemos añadir fácilmente console a la línea CONFIG para incluir esta configuración en el Makefile en Windows. Sin embargo, supongamos que solo queremos añadir la línea « CONFIG » cuando ejecutemos la aplicación en Windows y cuando « debug » ya figure en la línea « CONFIG ». Para ello, es necesario utilizar dos ámbitos anidados. Primero, crea un ámbito y, a continuación, crea el otro dentro de él. Coloca la configuración que se va a procesar dentro del segundo ámbito, de la siguiente manera:
win32 {
debug {
CONFIG += console
}
}Los ámbitos anidados se pueden unir mediante dos puntos, por lo que el archivo de proyecto final queda así:
CONFIG += debug
HEADERS += hello.h
SOURCES += hello.cpp
SOURCES += main.cpp
win32 {
SOURCES += hellowin.cpp
}
unix {
SOURCES += hellounix.cpp
}
!exists( main.cpp ) {
error( "No main.cpp file found" )
}
win32:debug {
CONFIG += console
}¡Ya está! Has completado el tutorial de qmake y ya estás listo para escribir archivos de proyecto para tus proyectos de desarrollo.
© 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.