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 »:
- 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). - 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. - 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>». - En un directorio «features» situado dentro del directorio indicado por la variable de entorno QMAKESPEC. Por ejemplo:
$QMAKESPEC/<features>. - En un directorio «features» ubicado en el directorio
data_install/mkspecs. Por ejemplo:data_install/mkspecs/<features>. - 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:
features/unix,features/win32ofeatures/macx, dependiendo de la plataforma utilizadafeatures/
Por ejemplo, consideremos la siguiente asignación en un archivo de proyecto:
CONFIG += myfeaturesCon 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:
$QMAKEFEATURES/myfeatures.prf(para cada directorio incluido en la variable de entornoQMAKEFEATURES)$$QMAKEFEATURES/myfeatures.prf(para cada directorio incluido en la variable de propiedadQMAKEFEATURES)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.$QMAKEPATH/mkspecs/features/unix/myfeatures.prfy$QMAKEPATH/mkspecs/features/myfeatures.prf(para cada directorio incluido en la variable de entornoQMAKEPATH)$QMAKESPEC/features/unix/myfeatures.prfy$QMAKESPEC/features/myfeatures.prfdata_install/mkspecs/features/unix/myfeatures.prfydata_install/mkspecs/features/myfeatures.prf$QMAKESPEC/../features/unix/myfeatures.prfy$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 += documentationqmake 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.docEl á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 += targetEn 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.targetLas 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 mytarget2Esto 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:
| Miembro | Descripción |
|---|---|
| commands | Los comandos para generar el objetivo de compilación personalizado. |
| CONFIG | Opciones 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. |
| depends | Los objetivos de compilación existentes de los que depende el objetivo de compilación personalizado. |
| recurse | Especifica 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_target | Especifica 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. |
| target | El 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_mocCon 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:
| Miembro | Descripción |
|---|---|
| commands | Los comandos utilizados para generar la salida a partir de la entrada. |
| CONFIG | Opciones de configuración específicas para el compilador personalizado. Consulta la tabla CONFIG para obtener más detalles. |
| depend_command | Especifica un comando utilizado para generar la lista de dependencias de la salida. |
| dependency_type | Especifica 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. |
| depends | Especifica las dependencias del archivo de salida. |
| input | La variable que especifica los archivos que deben procesarse con el compilador personalizado. |
| nombre | Una descripción de lo que hace el compilador personalizado. Solo se utiliza en algunos backends. |
| salida | El nombre del archivo creado por el compilador personalizado. |
| función_de_salida | Especifica una función personalizada de qmake que se utiliza para indicar el nombre del archivo que se va a crear. |
| variables | Indica que las variables especificadas aquí se sustituyen por $(QMAKE_COMP_VARNAME) cuando se hace referencia a ellas en el archivo pro como $(VARNAME). |
| variable_out | La variable a la que deben añadirse los archivos creados a partir de la salida. |
El miembro CONFIG admite las siguientes opciones:
| Opción | Descripción |
|---|---|
| combine | Indica que todos los archivos de entrada se combinan en un único archivo de salida. |
| target_predeps | Indica que la salida debe añadirse a la lista de PRE_TARGETDEPS. |
| explicit_dependencies | Las dependencias de la salida solo se generan a partir del miembro «depends» y de ningún otro sitio. |
| dep_existing_only | Se 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_lines | La 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_link | Indica 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_prlEsto 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_prlCuando 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.