En esta página

Uso avanzado

Añadir nuevas características de configuración

qmake te permite crear tus propias « features » (características de configuración) que pueden incluirse en los archivos de proyecto añadiendo sus nombres a la lista de valores especificados por la variable CONFIG. Las características son conjuntos de funciones y definiciones personalizadas en archivos « .prf » que pueden encontrarse en uno de los muchos directorios estándar. Las ubicaciones de estos directorios se definen en varios lugares, y qmake comprueba cada uno de ellos en el siguiente orden cuando busca archivos « .prf »:

  1. En un directorio incluido en la variable de entorno QMAKEFEATURES, que contiene una lista de directorios delimitados por el separador de la lista de rutas de la plataforma (dos puntos en Unix, punto y coma en Windows).
  2. En un directorio incluido en la variable de propiedad « QMAKEFEATURES », que contiene una lista de directorios delimitados por el separador de la lista de rutas de la plataforma.
  3. En un directorio «features» ubicado dentro de un directorio « mkspecs ». Los directorios « mkspecs » pueden encontrarse bajo cualquiera de los directorios indicados en la variable de entorno « QMAKEPATH », que contiene una lista de directorios delimitados por el separador de rutas de la plataforma. Por ejemplo: « $QMAKEPATH/mkspecs/<features> ».
  4. En un directorio «features» situado dentro del directorio indicado por la variable de entorno QMAKESPEC. Por ejemplo: $QMAKESPEC/<features>.
  5. En un directorio «features» ubicado en el directorio data_install/mkspecs. Por ejemplo: data_install/mkspecs/<features>.
  6. En un directorio «features» que se encuentre al mismo nivel que el directorio especificado por la variable de entorno « QMAKESPEC ». Por ejemplo: $QMAKESPEC/../<features>.

Se buscan archivos de características en los siguientes directorios de características:

  1. features/unix, features/win32 o features/macx, dependiendo de la plataforma utilizada
  2. features/

Por ejemplo, consideremos la siguiente asignación en un archivo de proyecto:

CONFIG += myfeatures

Con esta adición a la variable CONFIG, qmake buscará el archivo myfeatures.prf en las ubicaciones indicadas anteriormente una vez que haya terminado de analizar el archivo de proyecto. En sistemas Unix, buscará el siguiente archivo:

  1. $QMAKEFEATURES/myfeatures.prf (para cada directorio incluido en la variable de entorno QMAKEFEATURES )
  2. $$QMAKEFEATURES/myfeatures.prf (para cada directorio incluido en la variable de propiedad QMAKEFEATURES )
  3. myfeatures.prf (en el directorio raíz del proyecto). La raíz del proyecto viene determinada por el archivo ` .pro ` de nivel superior. Sin embargo, si colocas el archivo ` .qmake.cache ` en un subdirectorio o en el directorio de un subproyecto, la raíz del proyecto pasará a ser el propio subdirectorio.
  4. $QMAKEPATH/mkspecs/features/unix/myfeatures.prf y $QMAKEPATH/mkspecs/features/myfeatures.prf (para cada directorio incluido en la variable de entorno QMAKEPATH )
  5. $QMAKESPEC/features/unix/myfeatures.prf y $QMAKESPEC/features/myfeatures.prf
  6. data_install/mkspecs/features/unix/myfeatures.prf y data_install/mkspecs/features/myfeatures.prf
  7. $QMAKESPEC/../features/unix/myfeatures.prf y $QMAKESPEC/../features/myfeatures.prf

Nota: Los archivos « .prf » deben tener nombres en minúsculas.

Instalación de archivos

En Unix es habitual utilizar también la herramienta de compilación para instalar aplicaciones y bibliotecas; por ejemplo, ejecutando ` make install`. Por este motivo, qmake cuenta con el concepto de « install set », un objeto que contiene instrucciones sobre cómo debe instalarse una parte de un proyecto. Por ejemplo, una colección de archivos de documentación puede describirse de la siguiente manera:

documentation.path = /usr/local/program/doc
documentation.files = docs/*

El miembro « path » indica a qmake que los archivos deben instalarse en « /usr/local/program/doc » (el miembro «path»), y el miembro « files » especifica los archivos que deben copiarse al directorio de instalación. En este caso, todo el contenido del directorio « docs » se copiará a « /usr/local/program/doc ».

Una vez descrito completamente un conjunto de instalación, puedes añadirlo a la lista de instalación con una línea como esta:

INSTALLS += documentation

qmake se asegurará de que los archivos especificados se copien al directorio de instalación. Si necesitas un mayor control sobre este proceso, también puedes proporcionar una definición para el miembro extra del objeto. Por ejemplo, la siguiente línea indica a qmake que ejecute una serie de comandos para este conjunto de instalación:

unix:documentation.extra = create_docs; mv master.doc toc.doc

El ámbito « unix » garantiza que estos comandos concretos solo se ejecuten en plataformas Unix. Se pueden definir los comandos adecuados para otras plataformas utilizando otras reglas de ámbito.

Los comandos especificados en el miembro « extra » se ejecutan antes de que se lleven a cabo las instrucciones de los demás miembros del objeto.

Si se añade un conjunto de instalación integrado a la variable ` INSTALLS ` y no se especifican los miembros ` files ` o ` extra `, qmake decidirá por ti qué es lo que hay que copiar. Actualmente, se admiten los conjuntos de instalación ` target ` y ` dlltarget `. Por ejemplo:

target.path = /usr/local/myprogram
INSTALLS += target

En las líneas anteriores, qmake sabe qué hay que copiar y se encargará del proceso de instalación automáticamente.

Añadir objetivos personalizados

qmake intenta hacer todo lo que se espera de una herramienta de compilación multiplataforma. A menudo, esto no resulta lo ideal cuando realmente necesitas ejecutar comandos especiales dependientes de la plataforma. Esto se puede lograr con instrucciones específicas para los diferentes backends de qmake.

La personalización de la salida del Makefile se realiza a través de una API de estilo «objeto», como la que se encuentra en otras partes de qmake. Los objetos se definen automáticamente especificando sus miembros. Por ejemplo:

mytarget.target = .buildfile
mytarget.commands = touch $$mytarget.target
mytarget.depends = mytarget2

mytarget2.commands = @echo Building $$mytarget.target

Las definiciones anteriores definen un objetivo de qmake llamado « mytarget », que contiene un objetivo Makefile llamado « .buildfile », el cual, a su vez, se genera con el comando « touch ». Por último, el miembro « .depends » especifica que « mytarget » depende de « mytarget2 », otro objetivo que se define a continuación. « mytarget2 » es un objetivo ficticio. Solo se define para mostrar un mensaje en la consola.

El último paso consiste en utilizar la variable « QMAKE_EXTRA_TARGETS » para indicar a qmake que este objeto es un objetivo que debe compilarse:

QMAKE_EXTRA_TARGETS += mytarget mytarget2

Esto es todo lo que hay que hacer para compilar realmente objetivos personalizados. Por supuesto, es posible que quieras vincular uno de estos objetivos al objetivo de compilación de qmake. Para ello, solo tienes que incluir tu objetivo Makefile en la lista de PRE_TARGETDEPS.

Las especificaciones de objetivos personalizados admiten los siguientes miembros:

MiembroDescripción
commandsLos comandos para generar el objetivo de compilación personalizado.
CONFIGOpciones de configuración específicas para el objetivo de compilación personalizado. Se puede establecer en « recursive » para indicar que se deben crear reglas en el Makefile para llamar al objetivo correspondiente dentro del Makefile específico del subobjetivo. Por defecto, este miembro crea una entrada para cada uno de los subobjetivos.
dependsLos objetivos de compilación existentes de los que depende el objetivo de compilación personalizado.
recurseEspecifica qué subobjetivos deben utilizarse al crear las reglas en el Makefile para llamar al Makefile específico del subobjetivo. Este miembro solo se utiliza cuando se establece « recursive » en « CONFIG ». Los valores habituales son «Debug» y «Release».
recurse_targetEspecifica el objetivo que debe compilarse mediante el Makefile del subobjetivo para la regla del Makefile. Este miembro añade algo similar a $(MAKE) -f Makefile.[subtarget] [recurse_target]. Este miembro solo se utiliza cuando se establece recursive en CONFIG.
targetEl nombre del objetivo de compilación personalizado.

Añadir compiladores

Es posible personalizar qmake para que admita nuevos compiladores y preprocesadores:

new_moc.output  = moc_${QMAKE_FILE_BASE}.cpp
new_moc.commands = moc ${QMAKE_FILE_NAME} -o ${QMAKE_FILE_OUT}
new_moc.depend_command = g++ -E -M ${QMAKE_FILE_NAME} | sed "s,^.*: ,,"
new_moc.input = NEW_HEADERS
QMAKE_EXTRA_COMPILERS += new_moc

Con las definiciones anteriores, puedes utilizar un sustituto directo de moc si hay alguno disponible. El comando se ejecuta sobre todos los argumentos proporcionados a la variable NEW_HEADERS (desde el miembro input ), y el resultado se escribe en el archivo definido por el miembro output. Este archivo se añade al resto de archivos fuente del proyecto. Además, qmake ejecutará depend_command para generar información sobre dependencias y también incluirá esta información en el proyecto.

Las especificaciones personalizadas del compilador admiten los siguientes miembros:

MiembroDescripción
commandsLos comandos utilizados para generar la salida a partir de la entrada.
CONFIGOpciones de configuración específicas para el compilador personalizado. Consulta la tabla CONFIG para obtener más detalles.
depend_commandEspecifica un comando utilizado para generar la lista de dependencias de la salida.
dependency_typeEspecifica el tipo de archivo que es la salida. Si se trata de un tipo conocido (como TYPE_C, TYPE_UI o TYPE_QRC), se gestiona como uno de esos tipos de archivos.
dependsEspecifica las dependencias del archivo de salida.
inputLa variable que especifica los archivos que deben procesarse con el compilador personalizado.
nombreUna descripción de lo que hace el compilador personalizado. Solo se utiliza en algunos backends.
salidaEl nombre del archivo creado por el compilador personalizado.
función_de_salidaEspecifica una función personalizada de qmake que se utiliza para indicar el nombre del archivo que se va a crear.
variablesIndica que las variables especificadas aquí se sustituyen por $(QMAKE_COMP_VARNAME) cuando se hace referencia a ellas en el archivo pro como $(VARNAME).
variable_outLa variable a la que deben añadirse los archivos creados a partir de la salida.

El miembro CONFIG admite las siguientes opciones:

OpciónDescripción
combineIndica que todos los archivos de entrada se combinan en un único archivo de salida.
target_predepsIndica que la salida debe añadirse a la lista de PRE_TARGETDEPS.
explicit_dependenciesLas dependencias de la salida solo se generan a partir del miembro «depends» y de ningún otro sitio.
dep_existing_onlySe comprueba la existencia de todas las dependencias resultantes de .depend_command. Se ignoran las dependencias que no existen. Este valor se introdujo en Qt 5.13.2.
dep_linesLa salida de .depend_command se interpreta como un archivo por línea. El valor por defecto es dividir por espacios en blanco y se mantiene únicamente por motivos de compatibilidad con versiones anteriores.
no_linkIndica que la salida no debe añadirse a la lista de objetos que se van a enlazar.

Dependencias de bibliotecas

A menudo, al vincular con una biblioteca, qmake confía en que la plataforma subyacente sepa con qué otras bibliotecas se vincula esta biblioteca, y deja que sea la plataforma la que las incorpore. Sin embargo, en muchos casos esto no es suficiente. Por ejemplo, al vincular estáticamente una biblioteca, no se vincula con ninguna otra biblioteca y, por lo tanto, no se crean dependencias con respecto a ellas. No obstante, una aplicación que posteriormente se vincule a esta biblioteca necesitará saber dónde encontrar los símbolos que requerirá la biblioteca estática. qmake intenta realizar un seguimiento de las dependencias de una biblioteca, cuando sea apropiado, si se habilita explícitamente dicho seguimiento.

El primer paso es habilitar el seguimiento de dependencias en la propia biblioteca. Para ello, debes indicar a qmake que guarde información sobre la biblioteca:

CONFIG += create_prl

Esto solo es relevante para la plantilla « lib » y se ignorará en todas las demás. Cuando se habilita esta opción, qmake creará un archivo con extensión .prl en el que se guardará cierta metainformación sobre la biblioteca. Este metarchivo es igual que un archivo de proyecto normal, pero solo contiene declaraciones de variables internas. Al instalar esta biblioteca, al especificarla como destino en una declaración INSTALLS, qmake copiará automáticamente el archivo .prl a la ruta de instalación.

El segundo paso de este proceso consiste en habilitar la lectura de esta metainformación en las aplicaciones que utilizan la biblioteca estática:

CONFIG += link_prl

Cuando esta opción está habilitada, qmake procesará todas las bibliotecas a las que está enlazada la aplicación y buscará su metainformación. qmake utilizará esta información para determinar los datos de enlace pertinentes, concretamente añadiendo valores a la lista de DEFINES y LIBS del archivo de proyecto de la aplicación. Una vez que qmake haya procesado este archivo, examinará las bibliotecas recién introducidas en la variable « LIBS » y buscará sus archivos .prl dependientes, continuando hasta que se hayan resuelto todas las bibliotecas. En este punto, se crea el Makefile como de costumbre y las bibliotecas se vinculan explícitamente a la aplicación.

Los archivos .prl deben ser creados únicamente por qmake y no deben transferirse entre sistemas operativos, ya que pueden contener información dependiente de la plataforma.

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