En esta página

Variables

El comportamiento fundamental de qmake viene determinado por las declaraciones de variables que definen el proceso de compilación de cada proyecto. Algunas de ellas declaran recursos, como encabezados y archivos fuente, que son comunes a todas las plataformas. Otras se utilizan para personalizar el comportamiento de los compiladores y enlazadores en plataformas específicas.

Las variables específicas de cada plataforma siguen el patrón de nomenclatura de las variables que amplían o modifican, pero incluyen el nombre de la plataforma correspondiente en su nombre. Por ejemplo, un makespec puede utilizar ` QMAKE_LIBS ` para especificar una lista de bibliotecas con las que cada proyecto debe enlazarse, y se utilizaría ` QMAKE_LIBS_X11 ` para ampliar esta lista.

ANDROID_ABIS

Nota: Esta variable solo se aplica a los objetivos de Android.

Especifica una lista de ABI de destino de Android. Los valores válidos son: armeabi-v7a, arm64-v8a, x86, x86_64.

Puedes proporcionar las ABI como argumento de qmake:

qmake ANDROID_ABIS="armeabi-v7a arm64-v8a"

Nota: Es posible utilizar esta variable dentro del archivo *.pro; sin embargo, no se recomienda, ya que anulará cualquier ABI especificada en la línea de comandos de ` qmake `.

ANDROID_API_VERSION

Nota: Esta variable solo se aplica a los objetivos de Android.

Especifica el número de nivel de la API de Android. Para obtener más información, consulta Números de compilación de Android.

ANDROID_APPLICATION_ARGUMENTS

Nota: Esta variable solo se aplica a los objetivos de Android.

Especifica argumentos adicionales de línea de comandos para la aplicación de Android mediante el archivo « AndroidManifest.xml » con la etiqueta «android.app.arguments». Acepta una cadena de argumentos:

ANDROID_APPLICATION_ARGUMENTS = "arg1 arg2 arg3"

ANDROID_BUNDLED_JAR_DEPENDENCIES

Nota: Esta variable solo se aplica a los módulos de Android.

Resulta útil al escribir un módulo Qt. Especifica una lista de dependencias preintegradas que utiliza el módulo en formato .jar, por ejemplo:

ANDROID_BUNDLED_JAR_DEPENDENCIES += jar/Qt6Android.jar

ANDROID_DEPLOYMENT_DEPENDENCIES

Nota: Esta variable solo se aplica a los objetivos de Android.

Por defecto, androiddeployqt detectará las dependencias de tu aplicación. Sin embargo, dado que no se puede detectar el uso de los complementos en tiempo de ejecución, podrían producirse falsos positivos, ya que tu aplicación podría depender de cualquier complemento que sea una posible dependencia. Si desea minimizar el tamaño de su ` APK`, es posible anular la detección automática utilizando esta variable. Esta debe contener una lista de todos los archivos Qt que deben incluirse, con rutas relativas a la raíz de instalación de Qt.

Nota: Solo se incluyen los archivos Qt especificados con esta variable. Si no se incluyen todos los archivos correctos, pueden producirse fallos del sistema. También es importante asegurarse de que los archivos aparezcan en el orden de carga correcto. Esta variable permite anular por completo la detección automática, por lo que, si una biblioteca aparece antes que sus dependencias, no se cargará en algunos dispositivos.

ANDROID_DEPLOYMENT_SETTINGS_FILE

Nota: Esta variable solo se aplica a los objetivos de Android.

Especifica la ruta al archivo « android-deployment-settings.json » que necesitan «androiddeployqt » y « androidtestrunner ». Esto anula la ruta al archivo de configuración generado por «qmake», por lo que debes asegurarte de proporcionar un archivo de configuración válido.

ANDROID_EXTRA_LIBS

Nota: Esta variable solo se aplica a los objetivos de Android.

Una lista de bibliotecas externas que se copiarán en la carpeta « libs » de tu aplicación y se cargarán al iniciarla. Esto se puede utilizar, por ejemplo, para habilitar OpenSSL en tu aplicación. Para obtener más información, consulta «Añadir compatibilidad con OpenSSL para Android».

Para incluir bibliotecas externas para varias ABI, en las que cada ABI tiene su propio directorio, utiliza lo siguiente:

for (abi, ANDROID_ABIS): ANDROID_EXTRA_LIBS += $$PWD/$${abi}/library_name.so

De lo contrario, si la ABI está incluida en el nombre de la biblioteca, utiliza lo siguiente:

for (abi, ANDROID_ABIS): ANDROID_EXTRA_LIBS += $$PWD/library_name_$${abi}.so

ANDROID_EXTRA_PLUGINS

Nota: Esta variable solo se aplica a los destinos de Android.

Especifica una ruta a los complementos o recursos de C++ que tu aplicación debe incluir, pero que no pueden distribuirse a través del sistema de activos, como los complementos QML. Con esta variable, androiddeployqt se asegurará de que todo se empaquete y se implemente correctamente.

ANDROID_EXTRA_PLUGINS Debe apuntar al directorio donde se compilan los complementos adicionales. Además, la estructura del directorio de compilación debe seguir una convención de nomenclatura similar a la de los complementos de Qt, es decir, plugins/<nombre del complemento>.

Las bibliotecas de los complementos deben tener el formato de nombre libplugins_<tipo>_<nombre>_<abi>.so. Para ello, el archivo pro del complemento podría definirse de la siguiente manera:

TEMPLATE = lib
CONFIG += plugin

PLUGIN_TYPE = imageformats
DESTDIR = $$top_builddir/plugins/myplugin
TARGET = $$qt5LibraryTarget(myplugin, "plugins/$$PLUGIN_TYPE/")

con top_builddir definido en .qmake.conf como:

top_builddir=$$shadowed($$PWD)

Esto garantizará que se aplique la transformación de nombres correcta a la biblioteca del complemento (plugins/myplugin/libplugins_imageformats_myplugin_armeabi-v7a.so).

A continuación, suponiendo que se compila un complemento adicional de formato de imagen, myplugin, en $$DESTDIR/plugins/myplugin/, lo siguiente garantiza que se empaquete correctamente:

ANDROID_EXTRA_PLUGINS += $$top_builddir/plugins

ANDROID_FEATURES

Nota: Esta variable solo se aplica a los módulos de Android.

Especifica la lista de características de un módulo:

ANDROID_FEATURES += android.hardware.location.gps

Para obtener más información, consulta la documentación de Android sobre <uses-feature>.

ANDROID_LIB_DEPENDENCIES

Nota: Esta variable solo se aplica a los módulos de Android.

Resulta útil a la hora de escribir un módulo Qt. Especifica una lista de dependencias precompiladas que utiliza el módulo, por ejemplo:

ANDROID_LIB_DEPENDENCIES += \
    plugins/libplugins_platforms_qtforandroid.so

ANDROID_MIN_SDK_VERSION

Nota: Esta variable solo se aplica a los destinos de Android.

Especifica el nivel mínimo de API de Android para el proyecto. Por defecto, esta variable está establecida en el nivel de API 23.

ANDROID_PACKAGE_SOURCE_DIR

Nota: Esta variable solo se aplica a los objetivos de Android.

Especifica la ruta de acceso a una plantilla de paquete de Android personalizada. La plantilla de paquete de Android contiene:

  • el archivo AndroidManifest.xml
  • el archivo build.gradle y otros scripts de Gradle
  • El archivo `res/values/libs.xml`

La ruta especificada por esta variable puede contener clases Java personalizadas en el directorio src. De forma predeterminada, la herramienta androiddeployqt copia la plantilla de la aplicación desde la ruta de instalación de Qt para Android al directorio de compilación de tu proyecto y, a continuación, copia el contenido de la ruta especificada por esta variable encima de esa, sobrescribiendo cualquier archivo existente. Por ejemplo, puedes crear un archivo ` AndroidManifest.xml ` personalizado para tu aplicación y, a continuación, colocarlo directamente en el directorio especificado por esta variable.

ANDROID_PERMISSIONS

Nota: Esta variable solo se aplica a los módulos de Android.

Especifica la lista de permisos de un módulo:

ANDROID_PERMISSIONS += android.permission.ACCESS_FINE_LOCATION

Para obtener más información, consulta la documentación de Android sobre <uses-permission>.

ANDROID_TARGET_SDK_VERSION

Nota: Esta variable solo se aplica a los objetivos de Android.

Especifica el nivel de API de Android de destino para el proyecto. De forma predeterminada, esta variable está establecida en el nivel de API 37.

ANDROID_VERSION_CODE

Nota: Esta variable solo se aplica a los objetivos de Android.

Especifica el número de versión de la aplicación. Para obtener más información, consulta «Versiones de aplicaciones Android».

ANDROID_VERSION_NAME

Nota: Esta variable solo se aplica a los objetivos de Android.

Especifica la versión de la aplicación como una cadena legible para el usuario. Para obtener más información, consulta «Versiones de aplicaciones de Android».

CONFIG

Especifica la configuración del proyecto y las opciones del compilador. Los valores son reconocidos internamente por qmake y tienen un significado especial.

Nota: Los valores distinguen entre mayúsculas y minúsculas.

Los siguientes valores de « CONFIG » controlan los parámetros del compilador y del enlazador:

OpciónDescripción
releaseEl proyecto se compilará en modo de lanzamiento. Si también se especifica « debug », prevalecerá el último valor.
debugEl proyecto se compilará en modo depuración.
debug_and_releaseEl proyecto está preparado para compilarse tanto en modo depuración como en modo de lanzamiento.
debug_and_release_targetEsta opción está activada por defecto. Si también se activa la opción « debug_and_release », las compilaciones de depuración y de versión final se guardarán en directorios separados para cada una.
build_allSi se especifica « debug_and_release », el proyecto se compila de forma predeterminada tanto en modo de depuración como en modo de lanzamiento.
autogen_precompile_sourceGenera automáticamente un archivo « .cpp » que incluye el archivo de encabezado precompilado especificado en el archivo .pro.
orderedAl utilizar la plantilla ` subdirs `, esta opción especifica que los directorios enumerados deben procesarse en el orden en que aparecen.

Nota: Se desaconsejael uso de esta opción. Especifica las dependencias tal y como se describe en la documentación de la variable SUBDIRS.

precompile_headerHabilita el uso de encabezados precompilados en los proyectos.
precompile_header_c (solo MSVC)Habilita el uso de encabezados precompilados para archivos C.
warn_onEl compilador debe generar tantas advertencias como sea posible. Si también se especifica « warn_off », prevalecerá la última opción.
warn_offEl compilador debe generar el menor número posible de advertencias.
exceptionsSe habilita el soporte para excepciones. Está activado por defecto.
exceptions_offLa gestión de excepciones está desactivada.
ltcgLa generación de código en tiempo de enlace está activada. Esta opción está desactivada por defecto.
rttiLa compatibilidad con RTTI está habilitada. De forma predeterminada, se utiliza la configuración predeterminada del compilador.
rtti_offEl soporte para RTTI está desactivado. Por defecto, se utiliza la configuración predeterminada del compilador.
stlLa compatibilidad con STL está habilitada. Por defecto, se utiliza la configuración predeterminada del compilador.
stl_offLa compatibilidad con STL está desactivada. Por defecto, se utiliza la configuración predeterminada del compilador.
threadLa compatibilidad con subprocesos está habilitada. Se habilita cuando CONFIG incluye qt, que es el valor predeterminado.
no_utf8_sourceEspecifica que los archivos fuente del proyecto no utilizan la codificación UTF-8. En su lugar, se utiliza la configuración predeterminada del compilador.
hide_symbolsEstablece la visibilidad predeterminada de los símbolos en el binario como oculta. Por defecto, se utiliza la configuración predeterminada del compilador.
c99Se habilita la compatibilidad con C99. Esta opción no tiene ningún efecto si el compilador no es compatible con C99 o no puede seleccionar el estándar C. De forma predeterminada, se utiliza la configuración predeterminada del compilador.
c11Se habilita la compatibilidad con C11. Esta opción no tiene efecto si el compilador no admite C11 o no puede seleccionar el estándar C. De forma predeterminada, se utiliza la configuración predeterminada del compilador.
c17Se habilita la compatibilidad con C17, también conocido como C18. Esta opción no tiene ningún efecto si el compilador no es compatible con C17 o no puede seleccionar el estándar C. Por defecto, se utiliza la configuración predeterminada del compilador.
c18Es un alias del valor « c17 ».
strict_cDesactiva la compatibilidad con las extensiones del compilador C. De forma predeterminada, están activadas.
c++11La compatibilidad con C++11 está habilitada. Esta opción no tiene ningún efecto si el compilador no es compatible con C++11 o no puede seleccionar el estándar de C++. Por defecto, la compatibilidad está habilitada.
c++14La compatibilidad con C++14 está activada. Esta opción no tiene ningún efecto si el compilador no es compatible con C++14 o no puede seleccionar el estándar de C++. De forma predeterminada, la compatibilidad está activada.
c++17La compatibilidad con C++17 está activada. Esta opción no tiene ningún efecto si el compilador no es compatible con C++17 o no puede seleccionar el estándar de C++. De forma predeterminada, la compatibilidad está activada.
c++1zAlias obsoleto de C++17.
c++20La compatibilidad con C++20 está activada. Esta opción no tiene ningún efecto si el compilador no es compatible con C++20 o no puede seleccionar el estándar de C++. De forma predeterminada, la compatibilidad está desactivada.
c++2aAlias obsoleto de c++20.
c++latestSe habilita la compatibilidad con el último estándar del lenguaje C++. Esta opción resulta especialmente útil para MSVC, que admite el argumento de compilador « /std:c++latest ». Para otras cadenas de herramientas, esta opción habilita el último estándar de C++ conocido por Qt. De forma predeterminada, esta opción está desactivada.
strict_c++Desactiva la compatibilidad con las extensiones del compilador de C++. De forma predeterminada, están activadas.
depend_includepathSe habilita la adición del valor de INCLUDEPATH a DEPENDPATH. Está activada por defecto.
lreleaseEjecuta « lrelease » para todos los archivos enumerados en «TRANSLATIONS » y «EXTRA_TRANSLATIONS». Si no se ha definido « embed_translations », instala los archivos .qm generados en «QM_FILES_INSTALL_PATH». Utiliza «QMAKE_LRELEASE_FLAGS» para añadir opciones a la llamada a «lrelease». No está activado de forma predeterminada.
embed_translationsIncorpora las traducciones generadas desde lrelease en el ejecutable, bajo QM_FILES_RESOURCE_PREFIX. Requiere que también esté configurada la variable lrelease. No está configurada por defecto.
create_libtoolCrea un archivo .la de libtool para la biblioteca que se está compilando actualmente.
create_pcCrea un archivo .pc de pkg-config para la biblioteca que se está compilando actualmente.
no_batchSolo NMake: desactiva la generación de reglas por lotes o reglas de inferencia de NMake.
skip_target_version_extSuprime el número de versión automático que se añade al nombre del archivo DLL en Windows.
suppress_vcproj_warningsSuprime las advertencias del generador de proyectos de VS.
windeployqtEjecuta automáticamente windeployqt tras la vinculación y añade el resultado como elementos de implementación.
dont_recurseSuprime la recursividad de qmake para el subproyecto actual.
no_include_pwdNo añadir el directorio actual a INCLUDEPATHS.
compile_included_sourcesPor defecto, qmake no compila los archivos fuente que están incluidos en otros archivos fuente. Esta opción desactiva este comportamiento.

Cuando se utiliza la opción « debug_and_release » (que es la predeterminada en Windows), el proyecto se procesará tres veces: una vez para generar un «meta» Makefile, y dos veces más para generar un Makefile.Debug y un Makefile.Release.

Durante estas últimas pasadas, se añaden a ` CONFIG` la opción ` build_pass ` y la opción correspondiente ` debug ` o ` release `. Esto permite realizar tareas específicas de la compilación. Por ejemplo:

build_pass:CONFIG(debug, debug|release) {
    unix: TARGET = $$join(TARGET,,,_debug)
    else: TARGET = $$join(TARGET,,,d)
}

Como alternativa a escribir manualmente condiciones según el tipo de compilación, algunas variables ofrecen variantes específicas para cada compilación, por ejemplo, QMAKE_LFLAGS_RELEASE además de la general QMAKE_LFLAGS. Estas deben utilizarse siempre que estén disponibles.

El meta Makefile permite invocar las subcompilaciones a través de los objetivos « debug » y « release », y una compilación combinada a través del objetivo « all ». Cuando se utiliza la opción « build_all » CONFIG, la compilación combinada es la predeterminada. De lo contrario, la última opción « CONFIG » especificada del conjunto (debug, release) determina el valor predeterminado. En este caso, puedes invocar explícitamente el objetivo « all » para compilar ambas configuraciones a la vez:

make all

Nota: Los detalles varían ligeramente al generar proyectos de Visual Studio y Xcode.

Al enlazar una biblioteca, qmake se basa en la plataforma subyacente para saber con qué otras bibliotecas se enlaza esta biblioteca. Sin embargo, si se realiza un enlace estático, qmake no obtendrá esta información a menos que utilicemos las siguientes opciones de ` CONFIG `:

OpciónDescripción
create_prlEsta opción permite a qmake realizar un seguimiento de estas dependencias. Cuando se activa esta opción, qmake creará un archivo con la extensión .prl que guardará la metainformación sobre la biblioteca (consulta «Dependencias de bibliotecas» para obtener más información).
link_prlCuando esta opción está activada, qmake procesará todas las bibliotecas enlazadas por la aplicación y buscará su metainformación (véase «Dependencias de bibliotecas» para más información).
no_install_prlEsta opción desactiva la generación de reglas de instalación para los archivos .prl generados.

Nota: La opción « create_prl » es necesaria al compilar una biblioteca estática, mientras que « link_prl » es necesaria al utilizar una biblioteca estática.

Las siguientes opciones definen el tipo de aplicación o biblioteca:

OpciónDescripción
qtEl destino es una aplicación o biblioteca Qt y requiere la biblioteca Qt y los archivos de cabecera. Las rutas de inclusión y de biblioteca adecuadas para la biblioteca Qt se añadirán automáticamente al proyecto. Esto viene definido por defecto y se puede ajustar con la variable QT.
x11El objetivo es una aplicación o biblioteca X11. Las rutas de inclusión y las bibliotecas adecuadas se añadirán automáticamente al proyecto.
testcaseEl objetivo es una prueba automatizada. Se añadirá un objetivo de comprobación al Makefile generado para ejecutar la prueba. Solo es relevante al generar Makefiles.
prueba_insignificanteSe ignorará el código de salida de la prueba automatizada. Solo es relevante si también se ha establecido « testcase ».
windowsEl objetivo es una aplicación de ventana Win32 (solo aplicación). Las rutas de inclusión, las opciones del compilador y las bibliotecas adecuadas se añadirán automáticamente al proyecto.
consoleEl objetivo es una aplicación de consola Win32 (solo aplicación). Las rutas de inclusión, las opciones de compilación y las bibliotecas adecuadas se añadirán automáticamente al proyecto. Considera la posibilidad de utilizar la opción cmdline para aplicaciones multiplataforma.
cmdlineEl objetivo es una aplicación de línea de comandos multiplataforma. En Windows, esto implica « CONFIG += console ». En macOS, esto implica « CONFIG -= app_bundle ».
sharedEl objetivo es un objeto compartido/DLL. Las rutas de inclusión, las opciones de compilación y las bibliotecas adecuadas se añadirán automáticamente al proyecto. Ten en cuenta que « dll » también se puede utilizar en todas las plataformas; se creará un archivo de biblioteca compartida con la extensión adecuada para la plataforma de destino (.dll o .so).
dll
staticEl objetivo es una biblioteca estática (solo lib). Las opciones de compilador adecuadas se añadirán automáticamente al proyecto.
staticlib
pluginEl destino es un complemento (solo lib). Esto también habilita el formato dll.
diseñadorEl objetivo es un complemento para Qt Widgets Designer.
no_lflags_mergeGarantiza que la lista de bibliotecas almacenadas en la variable ` LIBS ` no se reduzca a una lista de valores únicos antes de su uso.
metatypesCrea un archivo ` <name>_metatypes.json ` para el proyecto actual. ` <name> ` es el nombre base de TARGET, todo en minúsculas.
qmltypesRegistra automáticamente los tipos QML definidos en C++. Para obtener más información, consulta Definición de tipos QML desde C++. Además, crea un archivo ` <template>.qmltypes ` para el proyecto actual. ` <template> ` será ` plugins ` (en plural, por razones históricas) si se establece ` plugin `, o el valor de `TEMPLATE ` en caso contrario. ` qmltypes ` implica ` metatypes`.

Estas opciones definen características específicas solo en Windows:

OpciónDescripción
flatAl utilizar la plantilla vcapp, esta opción colocará todos los archivos fuente en el grupo «source» y los archivos de cabecera en el grupo «header», independientemente del directorio en el que se encuentren. Si se desactiva esta opción, los archivos se agruparán dentro de los grupos «source» y «header» en función del directorio en el que se encuentren. Esta opción está activada de forma predeterminada.
embed_manifest_dllIncorpora un archivo de manifiesto en la DLL creada como parte de un proyecto de biblioteca.
embed_manifest_exeIncorpora un archivo de manifiesto en el EXE creado como parte de un proyecto de aplicación.

Consulta las Notas sobre plataformas para obtener más información sobre las opciones para incrustar archivos de manifiesto.

Las siguientes opciones solo surten efecto en macOS:

OpciónDescripción
app_bundleColoca el ejecutable en un paquete (esta es la opción predeterminada).
lib_bundleColoca la biblioteca en un paquete de biblioteca.
plugin_bundleColoca el complemento en un paquete de complementos. El generador de proyectos de Xcode no admite este valor.

El proceso de compilación de los paquetes también se ve influido por el contenido de la variable QMAKE_BUNDLE_DATA.

Las siguientes opciones solo surten efecto en plataformas Linux/Unix:

OpciónDescripción
largefileIncluye soporte para archivos de gran tamaño.
separate_debug_infoColoca la información de depuración de las bibliotecas en archivos separados.

La variable ` CONFIG ` también se comprobará al resolver ámbitos. Puedes asignarle cualquier valor a esta variable.

Por ejemplo:

CONFIG += console newstuff
...
newstuff {
    SOURCES += new.cpp
    HEADERS += new.h
}

DEFINES

qmake añade los valores de esta variable como macros del preprocesador C del compilador (opción -D).

Por ejemplo:

DEFINES += USE_MY_STUFF

DEFINES_DEBUG

Especifica las definiciones del preprocesador para la configuración de depuración. Los valores de esta variable se añaden a DEFINES una vez cargado el proyecto. Esta variable suele configurarse en qmake.conf y rara vez es necesario modificarla.

Esta variable se introdujo en Qt 5.13.2.

DEFINES_RELEASE

Especifica las definiciones del preprocesador para la configuración de lanzamiento. Los valores de esta variable se añaden a DEFINES una vez cargado el proyecto. Esta variable suele configurarse en qmake.conf y rara vez es necesario modificarla.

Nota: En los archivos «mkspec» de MSVC, esta variable contiene por defecto el valor « NDEBUG ».

Esta variable se introdujo en Qt 5.13.2.

DEF_FILE

Nota: Esta variable solo se utiliza en Windows cuando se emplea la plantilla « app ».

Especifica un archivo « .def » que se incluirá en el proyecto.

DEPENDPATH

Especifica una lista de directorios que qmake debe analizar para resolver las dependencias. Esta variable se utiliza cuando qmake recorre los archivos de cabecera que se incluyen mediante ` #include ` en el código fuente.

DESTDIR

Especifica dónde colocar el archivo de destino.

Por ejemplo:

DESTDIR = ../../lib

Nota: La lista de caracteres admitidos puede depender de la herramienta de compilación utilizada. En concreto, los paréntesis no funcionan con ` make`.

DISTFILES

Especifica una lista de archivos que se incluirán en el destino «dist». Esta característica solo es compatible con las especificaciones de UnixMake.

Por ejemplo:

DISTFILES += ../program.txt

DLLDESTDIR

Nota: Esta variable solo se aplica a los objetivos de Windows.

Especifica dónde copiar el archivo DLL del objetivo.

EXTRA_TRANSLATIONS

Especifica una lista de archivos de traducción (.ts) que contienen traducciones del texto de la interfaz de usuario a idiomas distintos del idioma nativo.

A diferencia de TRANSLATIONS, los archivos de traducción de « EXTRA_TRANSLATIONS » solo serán procesados por lrelease, no por lupdate.

Puedes utilizar CONFIG += lrelease para compilar automáticamente los archivos durante la compilación, y CONFIG += lrelease embed_translations para que estén disponibles en el sistema de recursos de Qt.

Consulte el Manual deQt Linguist para obtener más información sobre la internacionalización (i18n) y la localización (l10n) con Qt.

FORMS

Especifica los archivos de interfaz de usuario (véase el Manual deQt Widgets Designer ) que debe procesar uic antes de la compilación. Todas las dependencias, los encabezados y los archivos fuente necesarios para compilar estos archivos de interfaz de usuario se añadirán automáticamente al proyecto.

Por ejemplo:

FORMS = mydialog.ui \
    mywidget.ui \
        myconfig.ui

GUID

Especifica el GUID que se establece dentro de un archivo « .vcproj ». El GUID suele determinarse aleatoriamente. Sin embargo, si necesitas un GUID fijo, puedes establecerlo mediante esta variable.

Esta variable es específica únicamente de los archivos « .vcproj »; en los demás casos, se ignora.

HEADERS

Define los archivos de cabecera del proyecto.

qmake detecta automáticamente si las clases de los encabezados requieren moc y añade al proyecto las dependencias y los archivos adecuados para generar y enlazar los archivos moc.

Por ejemplo:

HEADERS = myclass.h \
          login.h \
          mainwindow.h

Véase también SOURCES.

ICON

Esta variable solo se utiliza en Mac OS para configurar el icono de la aplicación. Consulta la documentación sobre el icono de la aplicación para obtener más información.

IDLSOURCES

Esta variable se utiliza únicamente en Windows para que, al generar un proyecto de Visual Studio, los archivos especificados se coloquen en la carpeta «Archivos generados».

INCLUDEPATH

Especifica los directorios #include en los que se debe buscar al compilar el proyecto.

Por ejemplo:

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

Para especificar una ruta que contenga espacios, hay que ponerla entre comillas siguiendo la técnica descrita en «Espacios en blanco».

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

INSTALLS

Especifica una lista de recursos que se instalarán al ejecutar « make install » o un procedimiento de instalación similar. Cada elemento de la lista suele definirse con atributos que proporcionan información sobre dónde se instalará.

Por ejemplo, la siguiente definición de « target.path » describe dónde se instalará el objetivo de compilación, y la asignación « INSTALLS » añade el objetivo de compilación a la lista de recursos existentes que se van a instalar:

target.path += $$[QT_INSTALL_PLUGINS]/imageformats
INSTALLS += target

INSTALLS tiene un miembro .CONFIG que puede adoptar varios valores:

ValorDescripción
no_check_existSi no se establece, qmake comprueba si los archivos que se van a instalar existen realmente. Si estos archivos no existen, qmake no crea la regla de instalación. Utiliza este valor de configuración si necesitas instalar archivos que se generan como parte de tu proceso de compilación, como los archivos HTML creados por qdoc.
nostripSi se establece, se desactiva la funcionalidad típica de «strip» de Unix y la información de depuración permanecerá en el binario.
executableEn Unix, esto establece el indicador de ejecutable.
no_buildCuando se ejecuta « make install » y aún no se dispone de una compilación del proyecto, primero se compila el proyecto y, a continuación, se instala. Si no deseas este comportamiento, configura este valor para garantizar que el objetivo de compilación no se añada como dependencia del objetivo de instalación.
no_default_installUn proyecto tiene un objetivo de nivel superior en el que, al ejecutar « make install », se instala todo. Sin embargo, si tienes un objetivo de instalación con este valor de configuración establecido, no se instalará de forma predeterminada. En ese caso, tendrás que especificar explícitamente « make install_<file> ».

Para obtener más información, consulta Instalación de archivos.

Esta variable también se utiliza para especificar qué archivos adicionales se implementarán en los dispositivos integrados.

JAVA_HOME

Nota: Esta variable solo es útil para los objetivos de Android.

Especifica la ruta de instalación de JDK/OpenJDK utilizada para compilar el proyecto.

LEXIMPLS

Especifica una lista de archivos de implementación de Lex. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

LEXOBJECTS

Especifica los nombres de los archivos objeto intermedios de Lex. El valor de esta variable suele ser gestionado por qmake y rara vez es necesario modificarlo.

LEXSOURCES

Especifica una lista de archivos fuente de Lex. Todas las dependencias, los encabezados y los archivos fuente se añadirán automáticamente al proyecto para compilar estos archivos Lex.

Por ejemplo:

LEXSOURCES = lexer.l

LIBS

Especifica una lista de bibliotecas que se van a vincular al proyecto. Si utilizas los indicadores de Unix « -l » (biblioteca) y «-L» (ruta de la biblioteca), qmake gestiona las bibliotecas correctamente en Windows (es decir, pasa la ruta completa de la biblioteca al enlazador). La biblioteca debe existir para que qmake pueda encontrar el directorio donde se encuentra una biblioteca « -l ».

Por ejemplo:

unix:LIBS += -L/usr/local/lib -lmath
win32:LIBS += c:/mylibs/math.lib

Para especificar una ruta que contenga espacios, hay que ponerla entre comillas siguiendo la técnica descrita en «Espacios en blanco».

win32:LIBS += "C:/mylibs/extra libs/extra.lib"
unix:LIBS += "-L/home/user/extra libs" -lextra

Por defecto, la lista de bibliotecas almacenada en LIBS se reduce a una lista de nombres únicos antes de ser utilizada. Para cambiar este comportamiento, añade la opción no_lflags_merge a la variable CONFIG:

CONFIG += no_lflags_merge

LIBS_PRIVATE

Especifica una lista de bibliotecas que se deben vincular de forma privada al proyecto. El comportamiento de esta variable es idéntico al de LIBS, salvo que los proyectos de bibliotecas compartidas compilados para Unix no exponen estas dependencias en su interfaz de enlace.

El efecto de esto es que, si el proyecto C depende de la biblioteca B, que a su vez depende de la biblioteca A de forma privada, pero C también quiere utilizar símbolos de A directamente, deberá vincularse a A de forma explícita. Dicho de otro modo, las bibliotecas vinculadas de forma privada no se exponen de forma transitiva en el momento de la compilación.

LITERAL_HASH

Esta variable se utiliza siempre que se necesita un carácter de hash literal (#) en la declaración de una variable, tal vez como parte de un nombre de archivo o en una cadena pasada a alguna aplicación externa.

Por ejemplo:

# To include a literal hash character, use the $$LITERAL_HASH variable:
urlPieces = http://doc.qt.io/qt-5/qtextdocument.html pageCount
message($$join(urlPieces, $$LITERAL_HASH))

Al utilizar LITERAL_HASH de esta forma, el carácter # puede emplearse para construir una URL que la función message() imprima en la consola.

MAKEFILE

Especifica el nombre del Makefile generado. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

MAKEFILE_GENERATOR

Especifica el nombre del generador de Makefile que se utilizará al generar un Makefile. El valor de esta variable suele ser gestionado internamente por qmake y rara vez es necesario modificarlo.

MSVCPROJ_*

Estas variables son gestionadas internamente por qmake y no deben modificarse ni utilizarse.

MOC_DIR

Especifica el directorio donde deben colocarse todos los archivos moc intermedios.

Por ejemplo:

unix:MOC_DIR = ../myproject/tmp
win32:MOC_DIR = c:/myproject/tmp

OBJECTIVE_HEADERS

Define los archivos de cabecera de Objective-C++ para el proyecto.

qmake detecta automáticamente si las clases de los encabezados requieren moc y añade al proyecto las dependencias y los archivos adecuados para generar y enlazar los archivos moc.

Esto es similar a la variable HEADERS, pero permite que los archivos moc generados se compilen con el compilador de Objective-C++.

Véase también OBJECTIVE_SOURCES.

OBJECTIVE_SOURCES

Especifica los nombres de todos los archivos fuente de Objective-C/C++ del proyecto.

Esta variable ha quedado obsoleta; los archivos de Objective-C/C++ (.m y .mm) se pueden añadir a la variable SOURCES.

Véase también OBJECTIVE_HEADERS.

OBJECTS

Esta variable se rellena automáticamente a partir de la variable SOURCES. La extensión de cada archivo fuente se sustituye por .o (Unix) o .obj (Win32). Se pueden añadir objetos a la lista.

OBJECTS_DIR

Especifica el directorio donde deben colocarse todos los objetos intermedios.

Por ejemplo:

unix:OBJECTS_DIR = ../myproject/tmp
win32:OBJECTS_DIR = c:/myproject/tmp

POST_TARGETDEPS

Enumera las bibliotecas de las que depende el objetivo. Algunos backends, como los generadores de archivos de proyecto de Visual Studio y Xcode, no admiten esta variable. Por lo general, estas herramientas de compilación admiten esta variable internamente, y resulta útil para enumerar explícitamente las bibliotecas estáticas dependientes.

Esta lista se coloca después de todas las dependencias integradas (y de $$PRE_TARGETDEPS).

PRE_TARGETDEPS

Enumera las bibliotecas de las que depende el objetivo. Algunos backends, como los generadores de archivos de proyecto de Visual Studio y Xcode, no admiten esta variable. Por lo general, esta variable es compatible internamente con estas herramientas de compilación y resulta útil para enumerar explícitamente las bibliotecas estáticas dependientes.

Esta lista se coloca antes de todas las dependencias integradas.

PRECOMPILED_HEADER

Indica el archivo de cabecera para crear un archivo de cabecera precompilado, con el fin de aumentar la velocidad de compilación de un proyecto. Actualmente, las cabeceras precompiladas solo son compatibles con algunas plataformas (Windows: todos los tipos de proyectos MSVC; Apple: Xcode y Makefile; Unix: gcc 3.3 y versiones posteriores).

PWD

Especifica la ruta completa que conduce al directorio que contiene el archivo actual que se está analizando. Esto puede resultar útil para hacer referencia a archivos dentro del árbol de fuentes al escribir archivos de proyecto para admitir compilaciones en segundo plano.

Véase también _PRO_FILE_PWD_.

Nota: No intentes sobrescribir el valor de esta variable.

OUT_PWD

Especifica la ruta completa que conduce al directorio donde qmake coloca el Makefile generado.

Nota: No intentes sobrescribir el valor de esta variable.

QM_FILES_RESOURCE_PREFIX

Especifica el directorio del sistema de recursos en el que los archivos « .qm » estarán disponibles mediante «CONFIG += embed_translations».

El valor por defecto es :/i18n/.

QM_FILES_INSTALL_PATH

Especifica el directorio de destino en el que se instalarán los archivos « .qm » generados por `CONFIG += lrelease `. No tiene ningún efecto si se ha establecido `CONFIG += embed_translations `.

QML_IMPORT_PATH

Esta variable solo la utiliza Qt Creator. Si tienes un módulo adicional que se encuentra fuera de tu instalación de Qt, puedes especificar su ruta aquí.

Consulta Qt Creator: Uso de módulos QML con complementos para obtener más detalles.

QMLPATHS

Se espera una lista de rutas de importación que apunten a los directorios raíz de los árboles de módulos QML. Por ejemplo, si tienes una ubicación personalizada para tus módulos QML, puedes especificarla aquí.

Nota: Las entradas de ruta para QMLPATHS apuntan a los directorios raíz de los árboles de módulos QML. Este es el concepto de rutas de importación que entiende el motor QML. Puedes pasar las mismas rutas a tu aplicación QML a través de la variable de entorno ` QML_IMPORT_PATH `, pero son diferentes del contenido esperado de la variable de qmake ` QML_IMPORT_PATH`. Esta última espera rutas a módulos individuales que serán procesadas únicamente por ` Qt Creator `.

Nota: El contenido de QMLPATHS no se pasa automáticamente a tu aplicación. Por el contrario, solo se utiliza en el momento de la compilación. En concreto, qmlimportscanner lo utiliza para encontrar cualquier módulo QML que pueda necesitar marcar como importado por tu aplicación.

QMAKE

Especifica el nombre del propio programa qmake y se incluye en los archivos Makefile generados. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKESPEC

Variable del sistema que contiene la ruta completa de la configuración de qmake que se utiliza al generar los archivos Makefile. El valor de esta variable se calcula automáticamente.

Nota: No intentes sobrescribir el valor de esta variable.

QMAKE_APPLE_DEVICE_ARCHS

Nota: Esta variable solo se utiliza en macOS.

Especifica una lista de arquitecturas para las que se va a compilar. Por defecto, un proyecto se compila para la arquitectura del equipo de desarrollo. Esta variable permite anular el valor por defecto y compilar para una arquitectura diferente o crear binarios multiarquitectura.

Esta variable suele especificarse en la línea de comandos o en el archivo de proyecto.

Consulta Qt para macOS para obtener más información.

QMAKE_AR_CMD

Nota: Esta variable solo se utiliza en plataformas Unix.

Especifica el comando que se debe ejecutar al crear una biblioteca compartida. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_BUNDLE_DATA

Nota: Esta variable se utiliza únicamente en macOS, iOS, tvOS y watchOS.

Especifica los datos que se instalarán junto con un paquete de bibliotecas y se utiliza a menudo para indicar un conjunto de archivos de cabecera.

Por ejemplo, las siguientes líneas añaden path/to/header_one.h y path/to/header_two.h a un grupo que contiene información sobre los encabezados suministrados con el marco de trabajo:

FRAMEWORK_HEADERS.version = Versions
FRAMEWORK_HEADERS.files = path/to/header_one.h path/to/header_two.h
FRAMEWORK_HEADERS.path = Headers
QMAKE_BUNDLE_DATA += FRAMEWORK_HEADERS

La última línea añade la información sobre los encabezados a la colección de recursos que se instalarán con el paquete de biblioteca.

Los paquetes de bibliotecas se crean cuando se añade la opción lib_bundle a la variable CONFIG.

Consulta las Notas sobre la plataforma para obtener más información sobre la creación de paquetes de bibliotecas.

Un proyecto también puede utilizar esta variable para empaquetar los archivos de traducción de la aplicación. La sintaxis exacta depende de si el proyecto utiliza el sistema de compilación heredado de Xcode o su nuevo sistema de compilación.

Por ejemplo, cuando se compila el siguiente fragmento de código del proyecto utilizando el sistema de compilación heredado:

translations_en.files = $$PWD/en.lproj/InfoPlist.strings
translations_en.path = en.lproj
QMAKE_BUNDLE_DATA += translations_en

Xcode ignorará la ubicación original de InfoPlist.strings y el archivo se colocará en el directorio Resources del paquete, bajo la ruta proporcionada translations_en.path, por lo que Resources/en.lproj/InfoPlist.strings

Con el nuevo sistema de compilación, se conserva la ubicación relativa del archivo, lo que significa que el archivo se colocará incorrectamente en Resources/en.lproj/en.lproj/InfoPlist.strings

Para garantizar la ubicación correcta del archivo, el proyecto puede mover el archivo original para que no se encuentre en un subdirectorio o puede optar por no especificar la variable ` translations_en.path `.

# Approach 1
translations_en.files = $$PWD/InfoPlist.strings
translations_en.path = en.lproj

# Approach 2
translations_de.files = $$PWD/de.lproj/InfoPlist.strings

QMAKE_BUNDLE_DATA += translations_en translations_de

Consulte QTBUG-98417 para obtener más detalles sobre cómo ha cambiado el comportamiento del sistema de compilación de Xcode a la hora de agrupar los archivos de traducción.

QMAKE_BUNDLE_EXTENSION

Nota: Esta variable solo se utiliza en macOS, iOS, tvOS y watchOS.

Especifica la extensión que se utilizará para los paquetes de bibliotecas. Esto permite crear marcos con extensiones personalizadas en lugar de la extensión estándar del nombre de directorio « .framework ».

Por ejemplo, la siguiente definición dará como resultado un marco con la extensión « .myframework »:

QMAKE_BUNDLE_EXTENSION = .myframework

QMAKE_CC

Especifica el compilador de C que se utilizará al compilar proyectos que contengan código fuente en C. Solo es necesario especificar el nombre del archivo ejecutable del compilador, siempre y cuando se encuentre en una ruta incluida en la variable PATH cuando se procese el Makefile.

QMAKE_CFLAGS

Especifica las opciones del compilador de C para compilar un proyecto. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo. Las opciones específicas para los modos de depuración y de lanzamiento pueden ajustarse modificando las variables ` QMAKE_CFLAGS_DEBUG ` y ` QMAKE_CFLAGS_RELEASE `, respectivamente.

QMAKE_CFLAGS_DEBUG

Especifica las opciones del compilador C para las compilaciones de depuración. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_CFLAGS_RELEASE

Especifica las opciones del compilador C para las compilaciones de versión final. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_CFLAGS_RELEASE_WITH_DEBUGINFO

Especifica los parámetros del compilador C para las compilaciones de versión final en las que se ha establecido « force_debug_info » en « CONFIG ». El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_CFLAGS_SHLIB

Nota: Esta variable solo se utiliza en plataformas Unix.

Especifica las opciones del compilador para crear una biblioteca compartida. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_CFLAGS_THREAD

Especifica las opciones del compilador para crear una aplicación multihilo. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_CFLAGS_WARN_OFF

Esta variable solo se utiliza cuando está activada la opción CONFIG « warn_off ». El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_CFLAGS_WARN_ON

Esta variable solo se utiliza cuando se activa la opción CONFIG « warn_on ». El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_CLEAN

Especifica una lista de archivos generados (por moc y uic, por ejemplo) y archivos objeto que deben eliminarse mediante ` make clean`.

QMAKE_CXX

Especifica el compilador de C++ que se utilizará al compilar proyectos que contengan código fuente en C++. Solo es necesario especificar el nombre del archivo ejecutable del compilador, siempre que se encuentre en una ruta incluida en la variable PATH cuando se procese el Makefile.

QMAKE_CXXFLAGS

Especifica las opciones del compilador de C++ para compilar un proyecto. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo. Las opciones específicas para los modos de depuración y de compilación final pueden ajustarse modificando las variables QMAKE_CXXFLAGS_DEBUG y QMAKE_CXXFLAGS_RELEASE, respectivamente.

QMAKE_CXXFLAGS_DEBUG

Especifica las opciones del compilador de C++ para las compilaciones de depuración. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_CXXFLAGS_RELEASE

Especifica las opciones del compilador de C++ para las compilaciones de versión final. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_CXXFLAGS_RELEASE_WITH_DEBUGINFO

Especifica las opciones del compilador C++ para las compilaciones de versión final en las que se ha establecido « force_debug_info » en « CONFIG ». El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_CXXFLAGS_SHLIB

Especifica los parámetros del compilador C++ para crear una biblioteca compartida. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_CXXFLAGS_THREAD

Especifica las opciones del compilador de C++ para crear una aplicación multihilo. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_CXXFLAGS_WARN_OFF

Especifica las opciones del compilador de C++ para suprimir las advertencias del compilador. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_CXXFLAGS_WARN_ON

Especifica las opciones del compilador de C++ para generar advertencias del compilador. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_DEVELOPMENT_TEAM

Nota: Esta variable solo se utiliza en macOS, iOS, tvOS y watchOS.

El identificador de un equipo de desarrollo que se utilizará para firmar certificados y perfiles de aprovisionamiento.

QMAKE_DISTCLEAN

Especifica una lista de archivos que debe eliminar make distclean.

QMAKE_EXTENSION_SHLIB

Contiene la extensión de las bibliotecas compartidas. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

Nota: Las variablesespecíficas de la plataforma que modifican la extensión anulan el contenido de esta variable.

QMAKE_EXTENSION_STATICLIB

Contiene la extensión de las bibliotecas estáticas compartidas. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_EXT_MOC

Contiene la extensión utilizada en los archivos moc incluidos.

Véase también «Extensiones de archivo».

QMAKE_EXT_UI

Contiene la extensión utilizada en los archivos de interfaz de usuario de Qt Widgets Designer.

Véase también «Extensiones de archivo».

QMAKE_EXT_PRL

Contiene la extensión utilizada en los archivos PRL creados.

Véase también «Extensiones de archivo» y «Dependencias de bibliotecas».

QMAKE_EXT_LEX

Contiene la extensión utilizada en los archivos pasados a Lex.

Véase también «Extensiones de archivo» y «LEXSOURCES».

QMAKE_EXT_YACC

Contiene la extensión utilizada en los archivos pasados a Yacc.

Véase también «Extensiones de archivo» y «YACCSOURCES».

QMAKE_EXT_OBJ

Contiene la extensión utilizada en los archivos objeto generados.

Véase también «Extensiones de archivo».

QMAKE_EXT_CPP

Contiene los sufijos de los archivos que deben interpretarse como código fuente de C++.

Véase también «Extensiones de archivo».

QMAKE_EXT_H

Contiene las extensiones de los archivos que deben interpretarse como archivos de cabecera de C.

Véase también «Extensiones de archivo».

QMAKE_EXTRA_COMPILERS

Especifica una lista de compiladores o preprocesadores adicionales.

Véase también «Añadir compiladores».

QMAKE_EXTRA_TARGETS

Especifica una lista de objetivos adicionales de qmake.

Véase también «Añadir objetivos personalizados».

QMAKE_FAILED_REQUIREMENTS

Contiene la lista de requisitos no cumplidos. El valor de esta variable lo establece qmake y no se puede modificar.

Véase también requires() y REQUIRES.

QMAKE_FRAMEWORK_BUNDLE_NAME

Nota: Esta variable solo se utiliza en macOS, iOS, tvOS y watchOS.

En un proyecto de marco de trabajo, esta variable contiene el nombre que se utilizará para el marco de trabajo que se compila.

Por defecto, esta variable contiene el mismo valor que la variable TARGET.

Consulta «Creación de marcos » para obtener más información sobre la creación de marcos y paquetes de bibliotecas.

QMAKE_FRAMEWORK_VERSION

Nota: Esta variable solo se utiliza en macOS, iOS, tvOS y watchOS.

En los proyectos cuyo objetivo de compilación sea un marco de trabajo de macOS, iOS, tvOS o watchOS, esta variable se utiliza para especificar el número de versión que se aplicará al marco de trabajo que se compila.

Por defecto, esta variable contiene el mismo valor que la variable VERSION.

Consulte «Creación de marcos » para obtener más información sobre la creación de marcos.

QMAKE_HOST

Proporciona información sobre el equipo host en el que se ejecuta qmake. Por ejemplo, puedes obtener la arquitectura del equipo host mediante « QMAKE_HOST.arch ».

ClavesValores
.archArquitectura del host
.osSistema operativo del host
.cpu_countNúmero de CPU disponibles
.nameNombre del ordenador anfitrión
.versionNúmero de versión del sistema operativo del ordenador central
.version_stringCadena de la versión del sistema operativo del host
win32-g++:contains(QMAKE_HOST.arch, x86_64):{
    message("Host is 64bit")
    ...
}

QMAKE_INCDIR

Especifica la lista de rutas de los encabezados del sistema que se añaden a INCLUDEPATH. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_INCDIR_EGL

Especifica la ubicación de los archivos de cabecera de EGL que se añadirán a INCLUDEPATH al compilar un objetivo con soporte para OpenGL/ES u OpenVG. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_INCDIR_OPENGL

Especifica la ubicación de los archivos de cabecera de OpenGL que se añadirán a INCLUDEPATH al compilar un objetivo con soporte para OpenGL. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

Si la implementación de OpenGL utiliza EGL (la mayoría de los sistemas OpenGL/ES), es posible que también sea necesario configurar QMAKE_INCDIR_EGL.

QMAKE_INCDIR_OPENGL_ES2

Esta variable especifica la ubicación de los archivos de cabecera de OpenGL que se deben añadir a INCLUDEPATH al compilar un objetivo con soporte para OpenGL ES 2.

El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

Si la implementación de OpenGL utiliza EGL (la mayoría de los sistemas OpenGL/ES), es posible que también sea necesario definir QMAKE_INCDIR_EGL.

QMAKE_INCDIR_OPENVG

Especifica la ubicación de los archivos de cabecera de OpenVG que se añadirán a INCLUDEPATH al compilar un objetivo compatible con OpenVG. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

Si la implementación de OpenVG utiliza EGL, es posible que también sea necesario configurar QMAKE_INCDIR_EGL.

QMAKE_INCDIR_X11

Nota: Esta variable solo se utiliza en plataformas Unix.

Especifica la ubicación de las rutas de los archivos de cabecera de X11 que se añadirán a INCLUDEPATH al compilar un objetivo X11. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_INFO_PLIST

Nota: Esta variable se utiliza únicamente en plataformas macOS, iOS, tvOS y watchOS.

Especifica el nombre del archivo de lista de propiedades, .plist, que deseas incluir en el paquete de tu aplicación para macOS, iOS, tvOS y watchOS.

En el archivo .plist, puede definir algunas variables que qmake sustituirá por los valores correspondientes:

Marcadores de posiciónEfecto
${PRODUCT_BUNDLE_IDENTIFIER}, @BUNDLEIDENTIFIER@Se expande a la cadena de identificación del paquete de destino, por ejemplo: com.example.myapp. Se determina concatenando los valores de QMAKE_TARGET_BUNDLE_PREFIX y QMAKE_BUNDLE, separados por un punto (.). El valor de QMAKE_BUNDLE se deriva de QMAKE_APPLICATION_BUNDLE_NAME, QMAKE_PLUGIN_BUNDLE_NAME o QMAKE_FRAMEWORK_BUNDLE_NAME. El proyecto no debe establecerlo directamente.
${EXECUTABLE_NAME}, @EXECUTABLE@, @LIBRARY@Equivalente al valor de QMAKE_APPLICATION_BUNDLE_NAME, QMAKE_PLUGIN_BUNDLE_NAME o QMAKE_FRAMEWORK_BUNDLE_NAME (dependiendo del tipo de destino que se esté creando), o a TARGET si no se ha establecido ninguno de los valores anteriores.
${ASSETCATALOG_COMPILER_APPICON_NAME}, @ICON@Se expande al valor de ICON.
${QMAKE_PKGINFO_TYPEINFO}, @TYPEINFO@Se expande al valor de QMAKE_PKGINFO_TYPEINFO.
${QMAKE_FULL_VERSION}, @FULL_VERSION@Se expande al valor de VERSION expresado con tres componentes de versión.
${QMAKE_SHORT_VERSION}, @SHORT_VERSION@Se expande al valor de VERSION expresado con dos componentes de versión.
${MACOSX_DEPLOYMENT_TARGET}Se expande al valor de QMAKE_MACOSX_DEPLOYMENT_TARGET.
${IPHONEOS_DEPLOYMENT_TARGET}Se expande al valor de QMAKE_IPHONEOS_DEPLOYMENT_TARGET.
${TVOS_DEPLOYMENT_TARGET}Se expande al valor de QMAKE_TVOS_DEPLOYMENT_TARGET.
${WATCHOS_DEPLOYMENT_TARGET}Se expande al valor de QMAKE_WATCHOS_DEPLOYMENT_TARGET.
${IOS_LAUNCH_SCREEN}Se expande al valor de QMAKE_IOS_LAUNCH_SCREEN.

Nota: Al utilizar el generador de Xcode, los marcadores de posición del tipo « ${var} » mencionados anteriormente son sustituidos directamente por el sistema de compilación de Xcode y no son gestionados por qmake. Los marcadores de posición del tipo « @var@ » solo funcionan con los generadores de Makefile de qmake y no con el generador de Xcode.

Si se realiza una compilación para iOS y el archivo .plist contiene la clave NSPhotoLibraryUsageDescription, qmake incluirá un complemento adicional en la compilación que añade compatibilidad con el acceso a las fotos (por ejemplo, QFile/QFileDialog). Consulte la documentación de Info.plist de Apple para obtener más información sobre esta clave.

Nota: En la mayoría de los casos, el archivo « Info.plist » predeterminado es suficiente.

QMAKE_IOS_DEPLOYMENT_TARGET

Nota: Esta variable solo se utiliza en la plataforma iOS.

Especifica la versión mínima absoluta de iOS que admite la aplicación.

Para obtener más información, consulta «Expresión de las versiones de iOS compatibles».

QMAKE_IOS_LAUNCH_SCREEN

Nota: Esta variable solo se utiliza en la plataforma iOS.

Especifica la pantalla de inicio que utiliza la aplicación. Si no se configura, se utiliza una pantalla de inicio predeterminada.

QMAKE_LFLAGS

Especifica un conjunto general de opciones que se pasan al enlazador. Si necesitas cambiar las opciones utilizadas para una plataforma concreta o un tipo de proyecto específico, utiliza una de las variables especializadas para ese fin en lugar de esta variable.

QMAKE_LFLAGS_CONSOLE

Nota: Esta variable solo se utiliza en Windows.

Especifica los indicadores del enlazador para compilar programas de consola. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LFLAGS_DEBUG

Especifica los parámetros del enlazador para compilaciones de depuración. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LFLAGS_PLUGIN

Especifica las opciones del enlazador para compilar complementos. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LFLAGS_RPATH

Nota: Esta variable solo se utiliza en plataformas Unix.

Especifica los parámetros del enlazador necesarios para utilizar los valores de QMAKE_RPATHDIR.

El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LFLAGS_REL_RPATH

Especifica los parámetros del enlazador necesarios para habilitar las rutas relativas en QMAKE_RPATHDIR.

El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_REL_RPATH_BASE

Especifica la cadena que el enlazador dinámico interpreta como la ubicación del ejecutable o la biblioteca a la que se hace referencia.

El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

Especifica los parámetros del enlazador necesarios para utilizar los valores de QMAKE_RPATHLINKDIR.

El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LFLAGS_RELEASE

Especifica las opciones del enlazador para las compilaciones de versión final. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LFLAGS_RELEASE_WITH_DEBUGINFO

Especifica las opciones del enlazador para las compilaciones de versión final en las que se ha establecido « force_debug_info » en CONFIG. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LFLAGS_APP

Especifica las opciones del enlazador para la compilación de aplicaciones. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LFLAGS_SHLIB

Especifica los parámetros del enlazador utilizados para compilar bibliotecas compartidas. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LFLAGS_SONAME

Especifica las opciones del enlazador para establecer el nombre de los objetos compartidos, como .so o .dll. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LFLAGS_THREAD

Especifica los parámetros del enlazador para compilar proyectos multihilo. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LFLAGS_WINDOWS

Nota: Esta variable solo se utiliza en Windows.

Especifica los parámetros del enlazador para compilar proyectos GUI de Windows (es decir, aplicaciones que no son de consola). El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LIBDIR

Especifica una lista de rutas de búsqueda de bibliotecas para todos los proyectos. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

Para especificar rutas de búsqueda adicionales en los archivos de proyecto, utiliza LIBS de la siguiente manera:

LIBS += -L/path/to/libraries

QMAKE_LIBDIR_POST

Especifica una lista de rutas de búsqueda de bibliotecas del sistema para todos los proyectos. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LIBDIR_FLAGS

Nota: Esta variable solo se utiliza en plataformas Unix.

Especifica la ubicación de todos los directorios de bibliotecas precedidos por el prefijo -L. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LIBDIR_EGL

Especifica la ubicación del directorio de la biblioteca EGL, cuando se utiliza EGL con OpenGL/ES u OpenVG. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LIBDIR_OPENGL

Especifica la ubicación del directorio de la biblioteca de OpenGL. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

Si la implementación de OpenGL utiliza EGL (la mayoría de los sistemas OpenGL/ES), es posible que también sea necesario configurar QMAKE_LIBDIR_EGL.

QMAKE_LIBDIR_OPENVG

Especifica la ubicación del directorio de la biblioteca OpenVG. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

Si la implementación de OpenVG utiliza EGL, es posible que también sea necesario configurar QMAKE_LIBDIR_EGL.

QMAKE_LIBDIR_X11

Nota: Esta variable solo se utiliza en plataformas Unix.

Especifica la ubicación del directorio de la biblioteca X11. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LIBS

Especifica las bibliotecas adicionales con las que cada proyecto debe enlazarse. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

Para especificar bibliotecas en un archivo de proyecto, utiliza LIBS en su lugar.

QMAKE_LIBS_PRIVATE

Especifica las bibliotecas privadas adicionales con las que cada proyecto necesita enlazarse. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

Para especificar bibliotecas privadas en un archivo de proyecto de biblioteca, utilice LIBS_PRIVATE en su lugar.

QMAKE_LIBS_EGL

Especifica todas las bibliotecas EGL al compilar Qt con OpenGL/ES u OpenVG. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo. El valor habitual es -lEGL.

QMAKE_LIBS_OPENGL

Especifica todas las bibliotecas de OpenGL. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

Si la implementación de OpenGL utiliza EGL (la mayoría de los sistemas OpenGL/ES), es posible que también sea necesario definir QMAKE_LIBS_EGL.

QMAKE_LIBS_OPENGL_ES1, QMAKE_LIBS_OPENGL_ES2

Estas variables especifican todas las bibliotecas de OpenGL para OpenGL ES 1 y OpenGL ES 2.

El valor de estas variables suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

Si la implementación de OpenGL utiliza EGL (la mayoría de los sistemas OpenGL/ES), es posible que también sea necesario configurar QMAKE_LIBS_EGL.

QMAKE_LIBS_OPENVG

Especifica todas las bibliotecas de OpenVG. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo. El valor habitual es -lOpenVG.

Algunos motores OpenVG se implementan sobre OpenGL. Esto se detectará en el momento de la configuración y QMAKE_LIBS_OPENGL se añadirá implícitamente a QMAKE_LIBS_OPENVG siempre que se enlacen las bibliotecas OpenVG.

Si la implementación de OpenVG utiliza EGL, es posible que también sea necesario establecer QMAKE_LIBS_EGL.

QMAKE_LIBS_THREAD

Nota: Esta variable solo se utiliza en plataformas Unix.

Especifica todas las bibliotecas con las que hay que vincular al compilar un objetivo multihilo. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LIBS_X11

Nota: Esta variable solo se utiliza en plataformas Unix.

Especifica todas las bibliotecas X11. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LIB_FLAG

Esta variable no está vacía si se especifica la plantilla « lib ». El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

Especifica el enlazador que se utilizará al compilar proyectos basados en aplicaciones. Solo es necesario especificar el nombre del archivo ejecutable del enlazador, siempre que se encuentre en una ruta incluida en la variable ` PATH ` cuando se procese el Makefile. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

Especifica el comando que se ejecutará al crear una biblioteca compartida. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LN_SHLIB

Especifica el comando que se debe ejecutar al crear un enlace a una biblioteca compartida. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_LRELEASE_FLAGS

Lista de opciones adicionales que se pasan a lrelease cuando se habilita mediante CONFIG += lrelease.

QMAKE_OBJECTIVE_CFLAGS

Especifica las opciones del compilador de Objective C/C++ para compilar un proyecto. Estas opciones se utilizan además de QMAKE_CFLAGS y QMAKE_CXXFLAGS.

QMAKE_POST_LINK

Especifica el comando que se debe ejecutar tras enlazar el TARGET. Esta variable suele estar vacía, por lo que no se ejecuta nada.

Nota: Esta variable no tiene ningún efecto en los proyectos de Xcode.

Especifica el comando que se debe ejecutar antes de enlazar el TARGET. Esta variable suele estar vacía, por lo que no se ejecuta nada.

Advertencia: Esta variable no es compatible cuando se utiliza el generador de Xcode y el nuevo sistema de compilación de Xcode.

QMAKE_PROJECT_NAME

Nota: Esta variable se utiliza únicamente para los archivos de proyecto de Visual Studio.

Determina el nombre del proyecto al generar archivos de proyecto para entornos de desarrollo integrado (IDE). El valor por defecto es el nombre del target. El valor de esta variable suele ser gestionado por qmake y rara vez es necesario modificarlo.

QMAKE_PROVISIONING_PROFILE

Nota: Esta variable solo se utiliza en macOS, iOS, tvOS y watchOS.

El UUID de un perfil de aprovisionamiento válido. Se utiliza junto con QMAKE_DEVELOPMENT_TEAM para especificar el perfil de aprovisionamiento.

Nota: Al especificar el perfil de aprovisionamiento se desactiva la firma gestionada automáticamente.

QMAKE_MAC_SDK

Esta variable se utiliza en macOS al compilar binarios universales.

QMAKE_MACOSX_DEPLOYMENT_TARGET

Nota: Esta variable solo se utiliza en la plataforma macOS.

Especifica la versión mínima imprescindible de macOS que admite la aplicación.

Para obtener más información, consulta «Configuraciones compatibles con macOS».

QMAKE_MAKEFILE

Especifica el nombre del archivo Makefile que se va a crear. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_QMAKE

Contiene la ruta absoluta del ejecutable de qmake.

Nota: No intentes sobrescribir el valor de esta variable.

QMAKE_RESOURCE_FLAGS

Esta variable se utiliza para personalizar la lista de opciones que se pasan a la Resource Compiler en cada una de las reglas de compilación en las que se utiliza. Por ejemplo, la siguiente línea garantiza que las opciones « -threshold » y « -compress » se utilicen con valores concretos cada vez que se invoque a « rcc »:

QMAKE_RESOURCE_FLAGS += -threshold 0 -compress 9

QMAKE_RPATHDIR

Nota: Esta variable solo se utiliza en plataformas Unix.

Especifica una lista de rutas de bibliotecas que se añaden al ejecutable en el momento de la vinculación, de modo que dichas rutas se busquen de forma preferente en tiempo de ejecución.

Cuando se especifican rutas relativas, qmake las transforma a un formato que el enlazador dinámico interpreta como relativo a la ubicación del ejecutable o la biblioteca de referencia. Esto solo es compatible con algunas plataformas (actualmente las basadas en Linux y Darwin) y se puede detectar comprobando si está definida la variable QMAKE_REL_RPATH_BASE.

QMAKE_RPATHLINKDIR

Especifica una lista de rutas de bibliotecas para que el enlazador estático busque dependencias implícitas de bibliotecas compartidas. Para obtener más información, consulta la página del manual de ld(1).

QMAKE_RUN_CC

Especifica la regla concreta necesaria para compilar un objeto. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_RUN_CC_IMP

Especifica la regla concreta necesaria para compilar un objeto. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_RUN_CXX

Especifica la regla concreta necesaria para compilar un objeto. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_RUN_CXX_IMP

Especifica la regla concreta necesaria para compilar un objeto. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_SONAME_PREFIX

Si se define, el valor de esta variable se utiliza como ruta que se antepone al identificador « SONAME » de la biblioteca compartida compilada. El « SONAME » es el identificador que el enlazador dinámico utilizará posteriormente para hacer referencia a la biblioteca. En general, esta referencia puede ser un nombre de biblioteca o la ruta completa de la biblioteca. En macOS, iOS, tvOS y watchOS, la ruta se puede especificar de forma relativa utilizando los siguientes marcadores de posición:

Marcador de posiciónEfecto
@rpathSe expande a las rutas definidas por los comandos mach-o de LC_RPATH en el ejecutable del proceso actual o en las bibliotecas a las que se hace referencia.
@executable_pathSe expande a la ubicación del ejecutable del proceso actual.
@loader_pathSe expande a la ubicación del ejecutable o la biblioteca a la que se hace referencia.

En la mayoría de los casos, basta con utilizar « @rpath », lo cual es recomendable:

# <project root>/project.pro
QMAKE_SONAME_PREFIX = @rpath

Sin embargo, el prefijo también se puede especificar utilizando diferentes marcadores de posición o una ruta absoluta, como cualquiera de las siguientes:

# <project root>/project.pro
QMAKE_SONAME_PREFIX = @executable_path/../Frameworks
QMAKE_SONAME_PREFIX = @loader_path/Frameworks
QMAKE_SONAME_PREFIX = /Library/Frameworks

Para obtener más información, consulta la documentación de dyld sobre los nombres de instalación de las bibliotecas dinámicas.

QMAKE_TARGET

Especifica el nombre del objetivo del proyecto. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

QMAKE_TARGET_COMPANY

Solo en Windows. Especifica la empresa del objetivo del proyecto; se utiliza, cuando procede, para incluir el nombre de la empresa en las propiedades de la aplicación. Solo se utiliza si se ha definido la variable VERSION o RC_ICONS y no se han definido las variables RC_FILE y RES_FILE.

QMAKE_TARGET_DESCRIPTION

Solo para Windows. Especifica la descripción del objetivo del proyecto; se utiliza, cuando procede, para incluir la descripción en las propiedades de la aplicación. Solo se utiliza si se ha definido la variable VERSION o RC_ICONS y no se han definido las variables RC_FILE ni RES_FILE.

Solo para Windows. Especifica la información de derechos de autor del objetivo del proyecto; se utiliza, cuando procede, para incluir la información de derechos de autor en las propiedades de la aplicación. Solo se utiliza si se ha definido la variable VERSION o RC_ICONS y no se han definido las variables RC_FILE y RES_FILE.

QMAKE_TARGET_PRODUCT

Solo para Windows. Especifica el producto del objetivo del proyecto; se utiliza, cuando procede, para incluir el producto en las propiedades de la aplicación. Solo se utiliza si se ha definido la variable VERSION o RC_ICONS y no se han definido las variables RC_FILE y RES_FILE.

QMAKE_TARGET_ORIGINAL_FILENAME

Solo para Windows. Especifica el nombre de archivo original del objetivo del proyecto; se utiliza, cuando procede, para incluir el nombre de archivo original en las propiedades de la aplicación. Solo se utiliza si se ha definido la variable VERSION o RC_ICONS y no se han definido las variables RC_FILE y RES_FILE.

QMAKE_TARGET_INTERNALNAME

Solo para Windows. Especifica el nombre interno del objetivo del proyecto; se utiliza, cuando procede, para incluir el nombre interno en las propiedades de la aplicación. Solo se utiliza si se ha definido la variable VERSION o RC_ICONS y no se han definido las variables RC_FILE ni RES_FILE.

QMAKE_TARGET_COMMENTS

Solo para Windows. Especifica los comentarios del objetivo del proyecto; se utiliza, cuando procede, para incluir los comentarios en las propiedades de la aplicación. Solo se utiliza si se ha definido la variable VERSION o RC_ICONS y no se han definido las variables RC_FILE y RES_FILE.

QMAKE_TARGET_TRADEMARKS

Solo para Windows. Especifica la información sobre marcas registradas para el objetivo del proyecto; se utiliza, cuando procede, para incluir dicha información en las propiedades de la aplicación. Solo se utiliza si se ha definido la variable VERSION o RC_ICONS y no se han definido las variables RC_FILE y RES_FILE.

QMAKE_MANIFEST

Solo para Windows. Especifica el archivo de manifiesto para el objetivo del proyecto. Solo se utiliza si las variables RC_FILE y RES_FILE no están definidas. No olvides eliminar embed_manifest_exe y embed_manifest_dll de la variable CONFIG; de lo contrario, entrará en conflicto con el generado por el compilador.

QMAKE_TVOS_DEPLOYMENT_TARGET

Nota: Esta variable solo se utiliza en la plataforma tvOS.

Especifica la versión mínima imprescindible de tvOS que admite la aplicación.

Para obtener más información, consulta «Expresión de las versiones de iOS compatibles».

QMAKE_UIC_FLAGS

Esta variable se utiliza para personalizar la lista de opciones que se pasan a la User Interface Compiler en cada una de las reglas de compilación en las que se utiliza.

QMAKE_WATCHOS_DEPLOYMENT_TARGET

Nota: Esta variable solo se utiliza en la plataforma watchOS.

Especifica la versión mínima imprescindible de watchOS que admite la aplicación.

Para obtener más información, consulta «Expresión de las versiones de iOS compatibles».

QML_IMPORT_MAJOR_VERSION

Especifica la versión principal que se utilizará para los registros de tipos QML generados automáticamente. Para obtener más información, consulta «Definición de tipos QML desde C++».

QML_IMPORT_MINOR_VERSION

Al registrar automáticamente tipos QML definidos en C++, se registra una versión adicional del módulo utilizando esta versión secundaria. Por lo general, las versiones secundarias que se deben registrar se deducen a partir de los metaobjetos.

Puede utilizar esta variable si los metaobjetos no han cambiado y, aun así, desea importar un módulo QML con un número de versión menor más reciente. Por ejemplo, los metaobjetos de MyModule se encuentran en el nivel 1.1, pero desea importar el módulo como 1.3.

QML_IMPORT_VERSION

Especifica QML_IMPORT_MAJOR_VERSION y QML_IMPORT_MINOR_VERSION como una cadena de versión de <major>.<minor>.

QML_IMPORT_NAME

Especifica el nombre del módulo que se utilizará para los registros de tipos QML generados automáticamente. Para obtener más información, consulta Definición de tipos QML desde C++.

QML_FOREIGN_METATYPES

Especifica otros archivos JSON con metatipos que deben tenerse en cuenta al generar archivos qmltypes. Utiliza esta opción cuando las bibliotecas externas proporcionen tipos que se expongan a QML, ya sea directamente o como tipos base o propiedades de otros tipos. Los tipos de Qt se tendrán en cuenta automáticamente y no es necesario añadirlos aquí.

QT

Especifica los módulos de Qt que utiliza su proyecto. Para conocer el valor que debe añadir para cada módulo, consulte la documentación del módulo.

A nivel de implementación en C++, el uso de un módulo de Qt hace que sus encabezados estén disponibles para su inclusión y provoca que se vincule al binario.

De forma predeterminada, QT contiene core y gui, lo que garantiza que se puedan compilar aplicaciones GUI estándar sin necesidad de configuración adicional.

Si deseas compilar un proyecto sin el Qt GUI módulo, debe excluir el valor de gui mediante el operador «-=». La siguiente línea dará lugar a la compilación de un proyecto Qt mínimo:

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

Si su proyecto es un complemento de Qt Widgets Designer, utilice el valor uiplugin para especificar que el proyecto se compile como una biblioteca, pero con soporte específico para el complemento Qt Widgets Designer. Para obtener más información, consulte «Compilación e instalación del complemento».

QTPLUGIN

Especifica una lista de nombres de complementos Qt estáticos que deben vincularse a una aplicación para que estén disponibles como recursos integrados.

qmake añade automáticamente los complementos que suelen necesitar los módulos de Qt utilizados (véase QT). Los valores predeterminados están ajustados para ofrecer una experiencia óptima desde el primer momento. Consulte «Complementos estáticos» para obtener una lista de los complementos disponibles y conocer las formas de anular la vinculación automática.

Actualmente, esta variable no tiene ningún efecto al vincular con una compilación compartida o dinámica de Qt, ni al vincular bibliotecas. Podría utilizarse para la implementación de complementos dinámicos en una fase posterior.

QT_VERSION

Contiene la versión actual de Qt.

QT_MAJOR_VERSION

Contiene la versión principal actual de Qt.

QT_MINOR_VERSION

Contiene la versión secundaria actual de Qt.

QT_PATCH_VERSION

Contiene la versión de parche actual de Qt.

RC_FILE

Solo para Windows. Especifica el nombre del archivo de recursos de Windows (.rc) para el destino. Véase «Añadir archivos de recursos de Windows».

RC_CODEPAGE

Solo para Windows. Especifica la página de códigos que debe indicarse en un archivo .rc generado. Solo se utiliza si se ha definido la variable VERSION o RC_ICONS y no se han definido las variables RC_FILE y RES_FILE.

RC_DEFINES

Solo para Windows. qmake añade los valores de esta variable como macros del preprocesador RC (opción /d). Si esta variable no está definida, se utiliza en su lugar la variable DEFINES.

RC_DEFINES += USE_MY_STUFF

RC_ICONS

Solo para Windows. Especifica los iconos que deben incluirse en un archivo .rc generado. Solo se utiliza si no están definidas las variables RC_FILE y RES_FILE. Se puede encontrar más información sobre la generación de archivos .rc en las Notas de la plataforma.

RC_LANG

Solo para Windows. Especifica el idioma que debe indicarse en un archivo .rc generado. Solo se utiliza si se ha definido la variable VERSION o RC_ICONS y no se han definido las variables RC_FILE y RES_FILE.

RC_INCLUDEPATH

Especifica las rutas de inclusión que se pasan al ` Resource Compiler` de Windows.

RCC_DIR

Especifica el directorio para los archivos de salida de Qt XML Resource Compiler.

Por ejemplo:

unix:RCC_DIR = ../myproject/resources
win32:RCC_DIR = c:/myproject/resources

REQUIRES

Especifica una lista de valores que se evalúan como condiciones. Si alguna de las condiciones es falsa, qmake omite este proyecto (y sus SUBDIRS) durante la compilación.

Nota: Recomendamos utilizar la función requires() en su lugar si deseas omitir proyectos o subproyectos durante la compilación.

RESOURCES

Especifica el nombre de los archivos de recopilación de recursos (qrc) para el objetivo. Para obtener más información sobre el archivo de recopilación de recursos, consulta El sistema de recursos de Qt.

RES_FILE

Solo para Windows. Especifica el nombre del archivo de salida del Resource Compiler de Windows para este objetivo. Consulta RC_FILE y «Cómo añadir archivos de recursos de Windows».

El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

SOURCES

Especifica los nombres de todos los archivos fuente del proyecto.

Nota sobre los archivos fuente incluidos

Por defecto, QMake analiza los archivos fuente en busca de dependencias y excluye automáticamente los archivos .cpp que están incluidos en otros archivos .cpp para evitar la compilación duplicada y los errores del enlazador. Esta exclusión automática tiene importantes limitaciones:

  • La exclusión se produce independientemente de las condiciones del preprocesador (#ifdef, #ifndef, etc.).
  • Un archivo .cpp que contenga #included en cualquier parte del proyecto quedará excluido de SOURCES, incluso si la inclusión es condicional.

Para forzar la compilación de los archivos excluidos, añade CONFIG += compile_included_sources a tu archivo .pro. Como alternativa, elimina los archivos incluidos de SOURCES y asegúrate de que solo se compilen a través de su archivo de inclusión. Esto se aplica a todos los archivos con extensiones incluidas en QMAKE_EXT_CPP.

Por ejemplo:

SOURCES = myclass.cpp \
      login.cpp \
      mainwindow.cpp

Véase también HEADERS.

SUBDIRS

Esta variable, cuando se utiliza con la plantilla « subdirs », especifica los nombres de todos los subdirectorios o archivos de proyecto que contienen partes del proyecto que deben compilarse. Cada subdirectorio especificado mediante esta variable debe contener su propio archivo de proyecto.

Se recomienda que el archivo de proyecto de cada subdirectorio tenga el mismo nombre base que el propio subdirectorio, ya que así es posible omitir el nombre del archivo. Por ejemplo, si el subdirectorio se llama myapp, el archivo de proyecto de ese directorio debería llamarse myapp.pro.

Como alternativa, puede especificar una ruta relativa a un archivo .pro en cualquier directorio. Se recomienda encarecidamente que especifique únicamente rutas en el directorio principal del proyecto actual o en sus subdirectorios.

Por ejemplo:

SUBDIRS = kernel \
          tools \
          myapp

Si necesitas asegurarte de que los subdirectorios se compilen en un orden concreto, utiliza el modificador « .depends » en los elementos « SUBDIRS » correspondientes.

Por ejemplo:

SUBDIRS += my_executable my_library tests doc
my_executable.depends = my_library
tests.depends = my_executable

La configuración anterior garantiza que my_library se compile antes que my_executable y que my_executable se compile antes que tests. Sin embargo, doc puede compilarse en paralelo con los demás subdirectorios, lo que acelera el proceso de compilación.

Nota: Se pueden enumerarvarias dependencias y todas ellas se compilarán antes que el objetivo que depende de ellas.

Nota: Se desaconsejael uso de `CONFIG += ordered`, ya que puede ralentizar las compilaciones en sistemas multinúcleo. A diferencia del ejemplo mostrado anteriormente, todas las compilaciones se realizarán de forma secuencial, incluso si no tienen dependencias.

Además de definir el orden de compilación, es posible modificar el comportamiento predeterminado de « SUBDIRS » añadiendo modificadores adicionales a los elementos « SUBDIRS ». Los modificadores admitidos son:

ModificadorEfecto
.subdirUtiliza el subdirectorio especificado en lugar del valor de « SUBDIRS ».
.fileEspecifica explícitamente el archivo de « pro » del subproyecto. No se puede utilizar junto con el modificador « .subdir ».
.dependsEste subproyecto depende de los subproyectos especificados.
.makefileEl archivo makefile del subproyecto. Disponible únicamente en plataformas que utilizan archivos makefile.
.targetCadena base utilizada para los objetivos del archivo «makefile» relacionados con este subproyecto. Disponible únicamente en plataformas que utilizan archivos «makefile».

Por ejemplo, define dos subdirectorios, ambos ubicados en un directorio distinto al valor de « SUBDIRS », y uno de los subdirectorios debe compilarse antes que el otro:

SUBDIRS += my_executable my_library
my_executable.subdir = app
my_executable.depends = my_library
my_library.subdir = lib

TARGET

Especifica el nombre del archivo de destino. Por defecto, contiene el nombre base del archivo del proyecto.

Por ejemplo:

TEMPLATE = app
TARGET = myapp
SOURCES = main.cpp

El archivo de proyecto anterior generaría un ejecutable llamado « myapp » en Unix y « myapp.exe » en Windows.

TARGET_EXT

Especifica la extensión de TARGET. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

TARGET_x

Especifica la extensión de TARGET con un número de versión principal. El valor de esta variable suele gestionarse mediante qmake o qmake.conf y rara vez es necesario modificarlo.

TARGET_x.y.z

Especifica la extensión de TARGET con un número de versión. El valor de esta variable suele ser gestionado por qmake o qmake.conf y rara vez es necesario modificarlo.

TEMPLATE

Especifica el nombre de la plantilla que se utilizará al generar el proyecto. Los valores permitidos son:

OpciónDescripción
appCrea un Makefile para compilar aplicaciones (opción predeterminada). Consulta «Compilación de una aplicación» para obtener más información.
libCrea un Makefile para compilar bibliotecas. Consulta «Compilación de una biblioteca » para obtener más información.
subdirsCrea un Makefile para compilar objetivos en subdirectorios. Los subdirectorios se especifican mediante la variable SUBDIRS.
auxCrea un Makefile para no compilar nada. Utiliza esta opción 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 generadores basados en Makefile. En concreto, no funcionará con los generadores vcxproj y Xcode.

vcappSolo para Windows. Crea un proyecto de aplicación para Visual Studio. Consulta Creación de archivos de proyecto de Visual Studio para obtener más información.
vclibSolo para Windows. Crea un proyecto de biblioteca para Visual Studio.

Por ejemplo:

TEMPLATE = lib
SOURCES = main.cpp
TARGET = mylib

La plantilla se puede anular especificando un nuevo tipo de plantilla con la opción de línea de comandos « -t ». Esto anula el tipo de plantilla una vez que se ha procesado el archivo .pro. Con los archivos .pro que utilizan el tipo de plantilla para determinar cómo se compila el proyecto, es necesario declarar «TEMPLATE» en la línea de comandos en lugar de utilizar la opción « -t ».

TRADUCCIONES

Especifica una lista de archivos de traducción (.ts) que contienen traducciones del texto de la interfaz de usuario a idiomas distintos del idioma nativo.

Los archivos de traducción de TRANSLATIONS serán procesados tanto por lrelease como por lupdate. Utiliza EXTRA_TRANSLATIONS si deseas que solo lrelease procese un archivo.

Puede utilizar CONFIG += lrelease para compilar automáticamente los archivos durante la compilación, y CONFIG += lrelease embed_translations para que estén disponibles en el sistema de recursos de Qt.

Consulta el Manual deQt Linguist para obtener más información sobre la internacionalización (i18n) y la localización (l10n) con Qt.

TR_EXCLUDE

Especifica una lista de rutas (archivos fuente, subdirectorios y rutas de inclusión de C++) que deben excluirse del procesamiento en « lupdate ». Las rutas pueden contener comodines. Las rutas relativas se consideran relativas a _PRO_FILE_PWD_.

Por ejemplo, para excluir archivos fuente:

SOURCES += main.cpp \
    excluded.cpp \
    3rdparty/sqlite3.h \
    3rdparty/sqlite3.c
TR_EXCLUDE += excluded.cpp 3rdparty/*

Para excluir subdirectorios de un proyecto de SUBDIRS:

SUBDIRS += \
    libs \
    apps \
    tests
TR_EXCLUDE += tests

Para acelerar el analizador sintáctico de C++ de lupdate, excluye las rutas de inclusión:

linux {
    TR_EXCLUDE += /usr/include/boost/*
}

UI_DIR

Especifica el directorio donde deben colocarse todos los archivos intermedios de uic.

Por ejemplo:

unix:UI_DIR = ../myproject/ui
win32:UI_DIR = c:/myproject/ui

VERSION

Especifica el número de versión de la aplicación si se indica la plantilla « app », o el número de versión de la biblioteca si se indica la plantilla « lib ».

En Windows, activa la generación automática de un archivo .rc si no se han definido las variables RC_FILE y RES_FILE. El archivo .rc generado tendrá las entradas FILEVERSION y PRODUCTVERSION rellenadas con el nivel mayor, menor, de parche y el número de compilación. Cada número debe estar comprendido entre 0 y 65535. Se puede encontrar más información sobre la generación de archivos .rc en las Notas de la plataforma.

Por ejemplo:

win32:VERSION = 1.2.3.4 # major.minor.patch.build
else:VERSION = 1.2.3    # major.minor.patch

VERSION_PE_HEADER

Solo para Windows. Especifica el número de versión que el enlazador de Windows incluye en el encabezado del archivo .exe o .dll mediante la opción /VERSION. Solo se pueden especificar la versión principal y la secundaria. Si no se establece VERSION_PE_HEADER, se recurre a la versión principal y secundaria de VERSION (si está establecida).

VERSION_PE_HEADER = 1.2

VER_MAJ

Especifica el número de versión principal de la biblioteca si se especifica la plantilla « lib ».

VER_MIN

Especifica el número de versión secundaria de la biblioteca si se especifica la plantilla « lib ».

VER_PAT

Especifica el número de versión de parche de la biblioteca si se especifica la plantilla « lib ».

VPATH

Indica a qmake dónde buscar los archivos que no puede abrir. Por ejemplo, si qmake busca en SOURCES y encuentra una entrada que no puede abrir, revisa toda la lista de VPATH para ver si puede encontrar el archivo por sí mismo.

Véase también DEPENDPATH.

WINDOWS_TARGET_PLATFORM_VERSION

Especifica la versión de Windows de destino; esto se corresponde con la etiqueta WindowsTargetPlatformVersion en los archivos vcxproj.

En Windows de escritorio, el valor predeterminado es el valor de la variable de entorno WindowsSDKVersion.

WINDOWS_TARGET_PLATFORM_MIN_VERSION

Especifica la versión mínima de la plataforma de destino de Windows; esto se corresponde con la etiqueta WindowsTargetPlatformMinVersion en los archivos vcxproj.

El valor por defecto es WINDOWS_TARGET_PLATFORM_VERSION.

YACCSOURCES

Especifica una lista de archivos fuente de Yacc que se incluirán en el proyecto. Todas las dependencias, los encabezados y los archivos fuente se incluirán automáticamente en el proyecto.

Por ejemplo:

YACCSOURCES = moc.y

_PRO_FILE_

Contiene la ruta al archivo de proyecto que se está utilizando.

Por ejemplo, la siguiente línea hace que se escriba en la consola la ubicación del archivo de proyecto:

message($$_PRO_FILE_)

Nota: No intentes sobrescribir el valor de esta variable.

_PRO_FILE_PWD_

Contiene la ruta al directorio que contiene el archivo de proyecto que se está utilizando.

Por ejemplo, la siguiente línea hace que se escriba en la consola la ubicación del directorio que contiene el archivo de proyecto:

message($$_PRO_FILE_PWD_)

Nota: No intentes sobrescribir el valor de esta variable.

Véase también QQmlEngine::addImportPath().

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