En esta página

Creación de archivos de proyecto

Los archivos de proyecto contienen toda la información que necesita qmake para compilar tu aplicación, biblioteca o complemento. Por lo general, se utiliza una serie de declaraciones para especificar los recursos del proyecto, pero la compatibilidad con construcciones de programación sencillas te permite describir diferentes procesos de compilación para distintas plataformas y entornos.

Elementos del archivo de proyecto

El formato de archivo de proyecto que utiliza qmake permite dar soporte tanto a sistemas de compilación sencillos como a otros bastante complejos. Los archivos de proyecto sencillos utilizan un estilo declarativo directo, definiendo variables estándar para indicar los archivos fuente y de cabecera que se utilizan en el proyecto. Los proyectos complejos pueden utilizar estructuras de flujo de control para ajustar con precisión el proceso de compilación.

En las secciones siguientes se describen los diferentes tipos de elementos utilizados en los archivos de proyecto.

Variables

En un archivo de proyecto, las variables se utilizan para almacenar listas de cadenas de caracteres. En los proyectos más sencillos, estas variables indican a qmake las opciones de configuración que debe utilizar, o proporcionan nombres de archivo y rutas que se emplearán en el proceso de compilación.

qmake busca determinadas variables en cada archivo de proyecto y utiliza su contenido para determinar qué debe escribir en un Makefile. Por ejemplo, las listas de valores de las variables HEADERS y SOURCES se utilizan para indicar a qmake cuáles son los archivos de cabecera y de código fuente que se encuentran en el mismo directorio que el archivo de proyecto.

Las variables también pueden utilizarse internamente para almacenar listas temporales de valores, y las listas de valores existentes pueden sobrescribirse o ampliarse con nuevos valores.

El siguiente fragmento de código ilustra cómo se asignan listas de valores a las variables:

HEADERS = mainwindow.h paintwidget.h

La lista de valores de una variable se amplía de la siguiente manera:

SOURCES = main.cpp mainwindow.cpp \
          paintwidget.cpp
CONFIG += console

Nota: La primera asignación solo incluye los valores especificados en la misma línea que la variable « HEADERS ». La segunda asignación divide los valores de la variable « SOURCES » en varias líneas utilizando una barra invertida (\).

La variable CONFIG es otra variable especial que qmake utiliza al generar un Makefile. Se trata en Configuración general. En el fragmento anterior, console se añade a la lista de valores existentes contenidos en CONFIG.

La siguiente tabla enumera algunas variables de uso frecuente y describe su contenido. Para obtener una lista completa de variables y sus descripciones, consulta «Variables».

VariableContenido
CONFIGOpciones generales de configuración del proyecto.
DESTDIREl directorio en el que se colocará el archivo ejecutable o binario.
FORMSLista de archivos de interfaz de usuario que debe procesar el User Interface Compiler (uic).
HEADERSUna lista de nombres de archivos de cabecera (.h) utilizados al compilar el proyecto.
QTUna lista de los módulos de Qt utilizados en el proyecto.
RECURSOSUna lista de los archivos de recursos (.qrc) que se incluirán en el proyecto final. Consulta «El sistema de recursos de Qt » para obtener más información sobre estos archivos.
FUENTESUna lista de archivos de código fuente que se utilizarán al compilar el proyecto.
PLANTILLALa plantilla que se utilizará para el proyecto. Esta determina si el resultado del proceso de compilación será una aplicación, una biblioteca o un complemento.

El contenido de una variable se puede leer anteponiendo el nombre de la variable a « $$ ». Esto se puede utilizar para asignar el contenido de una variable a otra:

TEMP_SOURCES = $$SOURCES

El operador « $$ » se utiliza ampliamente con funciones integradas que operan sobre cadenas de caracteres y listas de valores. Para obtener más información, consulta «Lenguaje de qmake».

Espacios en blanco

Normalmente, los espacios en blanco separan los valores en las asignaciones de variables. Para especificar valores que contengan espacios, debes encerrar los valores entre comillas dobles:

DEST = "Program Files"

El texto entre comillas se trata como un único elemento en la lista de valores que contiene la variable. Se utiliza un enfoque similar para gestionar las rutas que contienen espacios, especialmente al definir las variables INCLUDEPATH y LIBS para la plataforma Windows:

win32:INCLUDEPATH += "C:/mylibs/extra headers"
unix:INCLUDEPATH += "/home/user/extra headers"

Comentarios

Se pueden añadir comentarios a los archivos de proyecto. Los comentarios comienzan con el carácter « # » y continúan hasta el final de la misma línea. Por ejemplo:

# Comments usually start at the beginning of a line, but they
# can also follow other content on the same line.

Para incluir el carácter « # » en las asignaciones de variables, es necesario utilizar el contenido de la variable integrada LITERAL_HASH.

Funciones integradas y flujo de control

qmake proporciona una serie de funciones integradas que permiten procesar el contenido de las variables. La función más utilizada en archivos de proyecto sencillos es la función `include()`, que toma un nombre de archivo como argumento. El contenido del archivo indicado se incluye en el archivo de proyecto en el lugar donde se utiliza la función « include ». La función « include » se utiliza sobre todo para incluir otros archivos de proyecto:

include(other.pro)

El soporte para estructuras condicionales se ofrece a través de ámbitos que se comportan como las sentencias « if » en los lenguajes de programación:

win32 {
    SOURCES += paintwidget_win.cpp
}

Las asignaciones dentro de las llaves solo se realizan si la condición es verdadera. En este caso, debe activarse la opción win32 CONFIG. Esto ocurre automáticamente en Windows. La llave de apertura debe estar en la misma línea que la condición.

Las operaciones más complejas con variables, que normalmente requerirían bucles, se realizan mediante funciones integradas como find(), unique() y count(). Estas funciones, junto con muchas otras, permiten manipular cadenas y rutas, gestionar la entrada del usuario y llamar a herramientas externas. Para obtener más información sobre el uso de las funciones, consulta «Lenguaje de qmake». Para ver listas de todas las funciones y sus descripciones, consulta «Funciones de sustitución » y «Funciones de prueba».

Plantillas de proyecto

La variable TEMPLATE se utiliza para definir el tipo de proyecto que se va a compilar. Si no se declara en el archivo de proyecto, qmake asume que se debe compilar una aplicación y generará un Makefile (o archivo equivalente) adecuado para tal fin.

La siguiente tabla resume los tipos de proyectos disponibles y describe los archivos que qmake generará para cada uno de ellos:

PlantillaSalida de qmake
app (por defecto)Makefile para compilar una aplicación.
libMakefile para compilar una biblioteca.
auxMakefile para no compilar nada. Utilízalo si no es necesario invocar ningún compilador para crear el objetivo, por ejemplo, porque tu proyecto está escrito en un lenguaje interpretado.

Nota: Este tipo de plantilla solo está disponible para los generadores basados en Makefile. En concreto, no funcionará con los generadores vcxproj y Xcode.

subdirsMakefile que contiene reglas para los subdirectorios especificados mediante la variable SUBDIRS. Cada subdirectorio debe contener su propio archivo de proyecto.
vcappArchivo de proyecto de Visual Studio para compilar una aplicación.
vclibArchivo de proyecto de Visual Studio para compilar una biblioteca.
vcsubdirsArchivo de solución de Visual Studio para compilar proyectos en subdirectorios.

Consulta «Compilación de tipos de proyectos comunes » para obtener consejos sobre cómo escribir archivos de proyecto para proyectos que utilicen las plantillas « app » y « lib ».

Cuando se utiliza la plantilla subdirs, qmake genera un Makefile para examinar cada subdirectorio especificado, procesar cualquier archivo de proyecto que encuentre allí y ejecutar la herramienta make de la plataforma sobre el Makefile recién creado. La variable SUBDIRS se utiliza para contener una lista de todos los subdirectorios que se van a procesar.

Configuración general

La variable CONFIG especifica las opciones y características con las que debe configurarse el proyecto.

El proyecto se puede compilar en modo de lanzamiento o en modo de depuración, o en ambos. Si se especifican tanto el modo de depuración como el de lanzamiento, prevalece el último. Si se especifica la opción debug_and_release para compilar tanto la versión de depuración como la de lanzamiento de un proyecto, el Makefile que genera qmake incluye una regla que compila ambas versiones. Esto se puede invocar de la siguiente manera:

make all

Al añadir la opción « build_all » a la variable « CONFIG », esta regla se convierte en la predeterminada al compilar el proyecto.

Nota: Cada una de las opciones especificadas en la variable ` CONFIG ` también se puede utilizar como condición de ámbito. Se puede comprobar la presencia de determinadas opciones de configuración utilizando la función integrada `CONFIG()`. Por ejemplo, las siguientes líneas muestran la función como condición en un ámbito para comprobar si solo se está utilizando la opción ` opengl `:

CONFIG(opengl) {
    message(Building with OpenGL support.)
} else {
    message(OpenGL support is not available.)
}

Esto permite definir diferentes configuraciones para las compilaciones « release » y « debug ». Para obtener más información, consulte Uso de ámbitos.

Las siguientes opciones definen el tipo de proyecto que se va a compilar.

Nota: Algunas de estas opciones solo surten efecto cuando se utilizan en la plataforma correspondiente.

OpciónDescripción
qtEl proyecto es una aplicación Qt y debe vincularse a la biblioteca Qt. Puedes utilizar la variable ` QT ` para controlar cualquier módulo Qt adicional que requiera tu aplicación. Este valor se añade por defecto, pero puedes eliminarlo para utilizar qmake en un proyecto que no sea Qt.
x11El proyecto es una aplicación o biblioteca X11. Este valor no es necesario si el objetivo utiliza Qt.

Las plantillas de proyecto para aplicaciones y bibliotecas te ofrecen opciones de configuración más especializadas para ajustar con precisión el proceso de compilación. Las opciones se explican detalladamente en «Compilación de tipos de proyecto comunes».

Por ejemplo, si su aplicación utiliza la biblioteca Qt y desea compilarla en modo « debug », su archivo de proyecto contendrá la siguiente línea:

CONFIG += qt debug

Nota: Debes utilizar «+=», no «=», ya que, de lo contrario, qmake no podrá utilizar la configuración de Qt para determinar los ajustes necesarios para tu proyecto.

Declaración de bibliotecas Qt

Si la variable CONFIG contiene el valor « qt », se habilita la compatibilidad de qmake con las aplicaciones Qt. Esto permite ajustar con precisión qué módulos de Qt utiliza tu aplicación. Esto se consigue mediante la variable QT, que se puede utilizar para declarar los módulos de extensión necesarios. Por ejemplo, podemos habilitar los módulos XML y de red de la siguiente manera:

QT += network xml

Nota: « QT » incluye de forma predeterminada los módulos « core » y « gui », por lo que la declaración anterior añade los módulos de red y XML a esta lista predeterminada. La siguiente asignación omite los módulos predeterminados y provocará errores al compilar el código fuente de la aplicación:

QT = network xml # This will omit the core and gui modules.

Si desea compilar un proyecto sin el módulo gui, debe excluirlo mediante el operador «-=». Por defecto, QT contiene tanto core como gui, por lo que la siguiente línea dará como resultado la compilación de un proyecto Qt mínimo:

QT -= gui # Only the core module is used.

Para obtener una lista de los módulos de Qt que puedes añadir a la variable ` QT `, consulta QT.

Características de configuración

qmake se puede configurar con características adicionales que se especifican en archivos de características (.prf). Estas características adicionales suelen proporcionar compatibilidad con herramientas personalizadas que se utilizan durante el proceso de compilación. Para añadir una característica al proceso de compilación, añada el nombre de la característica (la raíz del nombre del archivo de características) a la variable CONFIG.

Por ejemplo, qmake puede configurar el proceso de compilación para aprovechar las bibliotecas externas compatibles con pkg-config, como las bibliotecas D-Bus y ogg, con las siguientes líneas:

CONFIG += link_pkgconfig
PKGCONFIG += ogg dbus-1

Para obtener más información sobre cómo añadir características, consulta «Añadir nuevas características de configuración».

Declaración de otras bibliotecas

Si utiliza otras bibliotecas en su proyecto además de las suministradas con Qt, deberá especificarlas en su archivo de proyecto.

Las rutas en las que qmake busca las bibliotecas y las bibliotecas específicas con las que se va a enlazar se pueden añadir a la lista de valores de la variable LIBS. Puede especificar las rutas a las bibliotecas o utilizar la notación al estilo Unix para especificar bibliotecas y rutas.

Por ejemplo, las siguientes líneas muestran cómo se puede especificar una biblioteca:

LIBS += -L/usr/local/lib -lmath

Las rutas que contienen archivos de cabecera también se pueden especificar de forma similar utilizando la variable INCLUDEPATH.

Por ejemplo, para añadir varias rutas en las que buscar archivos de cabecera:

INCLUDEPATH = c:/msdev/include d:/stl/include

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