Configuración de qmake
Propiedades
qmake dispone de un sistema de configuración persistente que permite establecer una propiedad en qmake una sola vez y consultarla cada vez que se ejecuta qmake. Puedes establecer una propiedad en qmake de la siguiente manera:
qmake -set PROPERTY VALUESe deben sustituir PROPERTY y VALUE por la propiedad y el valor adecuados.
Puede recuperar esta información de qmake de la siguiente manera:
qmake -query PROPERTY
qmake -query #queries all current PROPERTY/VALUE pairsNota: qmake -query muestra las propiedades integradas, además de las propiedades que se hayan establecido con qmake -set PROPERTY VALUE.
Esta información se guardará en un objeto ` QSettings ` (lo que significa que se almacenará en diferentes ubicaciones según la plataforma).
La siguiente lista resume las propiedades de ` built-in `:
- QMAKE_SPEC: el nombre abreviado del archivo «
mkspec» del host que se resuelve y se almacena en la variable QMAKESPEC durante la compilación del host - QMAKE_VERSION: la versión actual de qmake
- QMAKE_XSPEC: el nombre abreviado del e
mkspece de destino que se resuelve y se almacena en la variable QMAKESPEC durante una compilación del destino - QT_HOST_BINS: ubicación de los ejecutables del host
- QT_HOST_DATA: ubicación de los datos para los ejecutables del host utilizados por qmake
- QT_HOST_LIBS: ubicación de las bibliotecas del host
- QT_HOST_LIBEXECS: ubicación de los ejecutables que necesitan las bibliotecas del host en tiempo de ejecución
- QT_HOST_PREFIX: prefijo predeterminado para todas las rutas del host
- QT_INSTALL_ARCHDATA: ubicación de los datos generales de Qt dependientes de la arquitectura
- QT_INSTALL_BINS: ubicación de los binarios de Qt (herramientas y aplicaciones)
- QT_INSTALL_CONFIGURATION: ubicación de la configuración de Qt. No aplicable en Windows
- QT_INSTALL_DATA: ubicación de los datos generales de Qt independientes de la arquitectura
- QT_INSTALL_DOCS: ubicación de la documentación
- QT_INSTALL_EXAMPLES: ubicación de los ejemplos
- QT_INSTALL_HEADERS: ubicación de todos los archivos de cabecera
- QT_INSTALL_LIBEXECS: ubicación de los ejecutables que necesitan las bibliotecas en tiempo de ejecución
- QT_INSTALL_LIBS: ubicación de las bibliotecas
- QT_INSTALL_PLUGINS: ubicación de los complementos de Qt
- QT_INSTALL_PREFIX: prefijo predeterminado para todas las rutas
- QT_INSTALL_QML: ubicación de las extensiones de QML 2.x
- QT_INSTALL_TESTS: ubicación de los casos de prueba de Qt Test
- QT_INSTALL_TRANSLATIONS: ubicación de la información de traducción de las cadenas de Qt
- QT_SYSROOT: el sysroot utilizado por el entorno de compilación de destino
- QT_VERSION - la versión de Qt. Recomendamos consultar los números de versión específicos de cada módulo de Qt utilizando en su lugar las variables $$QT.<módulo>.version.
Por ejemplo, puede consultar la instalación de Qt para esta versión de qmake con la propiedad « QT_INSTALL_PREFIX »:
qmake -query "QT_INSTALL_PREFIX"Puede consultar los valores de las propiedades en un archivo de proyecto de la siguiente manera:
QMAKE_VERS = $$[QMAKE_VERSION]QMAKESPEC
qmake requiere un archivo de descripción de la plataforma y del compilador que contenga muchos valores predeterminados utilizados para generar los Makefiles adecuados. La distribución estándar de Qt incluye muchos de estos archivos, ubicados en el subdirectorio « mkspecs » de la instalación de Qt.
La variable de entorno ` QMAKESPEC ` puede contener cualquiera de los siguientes elementos:
- Una ruta completa a un directorio que contenga un archivo «
qmake.conf». En este caso, qmake abrirá el archivo «qmake.conf» desde dicho directorio. Si el archivo no existe, qmake se cerrará con un error. - El nombre de una combinación de plataforma y compilador. En este caso, qmake buscará en el directorio especificado por el subdirectorio «
mkspecs» de la ruta de datos especificada al compilar Qt (véase QLibraryInfo::DataPath).
Nota: La ruta QMAKESPEC se añadirá automáticamente al Makefile generado después del contenido de la variable de sistema INCLUDEPATH.
Archivo de caché
El archivo de caché es un archivo especial que qmake lee para encontrar configuraciones no especificadas en el archivo qmake.conf, en los archivos de proyecto o en la línea de comandos. Cuando se ejecuta qmake, busca un archivo llamado .qmake.cache en los directorios superiores del directorio actual, a menos que se especifique -nocache. Si qmake no encuentra este archivo, ignorará silenciosamente este paso del procesamiento.
Si qmake encuentra un archivo .qmake.cache, lo procesará primero antes de procesar el archivo de proyecto.
Extensiones de archivo
En circunstancias normales, qmake intentará utilizar las extensiones de archivo adecuadas para tu plataforma. Sin embargo, a veces es necesario anular las opciones predeterminadas para cada plataforma y definir explícitamente las extensiones de archivo que debe utilizar qmake. Esto se consigue redefiniendo ciertas variables integradas. Por ejemplo, la extensión utilizada para los archivos moc se puede redefinir con la siguiente asignación en un archivo de proyecto:
QMAKE_EXT_MOC = .mymocLas siguientes variables pueden utilizarse para redefinir las extensiones de archivo más comunes reconocidas por qmake:
- QMAKE_EXT_MOC modifica la extensión que se aplica a los archivos moc incluidos.
- QMAKE_EXT_UI modifica la extensión utilizada para los archivos de interfaz de usuario de « Qt Widgets Designer » (normalmente en FORMS).
- QMAKE_EXT_PRL modifica la extensión que se asigna a los archivos de dependencia de bibliotecas.
- QMAKE_EXT_LEX cambia el sufijo utilizado en los archivos Lex (normalmente en LEXSOURCES).
- QMAKE_EXT_YACC cambia el sufijo utilizado en los archivos Yacc (normalmente en YACCSOURCES).
- QMAKE_EXT_OBJ cambia el sufijo utilizado en los archivos objeto generados.
Todas las variables anteriores solo admiten un único valor, por lo que debes asignarle un único valor que se utilizará en todo el archivo de proyecto. Hay dos variables que admiten una lista de valores:
- QMAKE_EXT_CPP hace que qmake interprete todos los archivos con estas extensiones como archivos fuente de C++.
- QMAKE_EXT_H hace que qmake interprete todos los archivos con estos sufijos como archivos de cabecera de C y C++.
© 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.