En esta página

Ejecución de qmake

El comportamiento de qmake se puede personalizar al ejecutarlo especificando diversas opciones en la línea de comandos. Estas opciones permiten ajustar con precisión el proceso de compilación, proporcionan información de diagnóstico útil y pueden utilizarse para especificar la plataforma de destino de tu proyecto.

Sintaxis del comando

La sintaxis utilizada para ejecutar qmake tiene la siguiente forma sencilla:

qmake [mode] [options] files

Nota: Si has instalado Qt a través de un gestor de paquetes, es posible que el binario se llame « qmake6 ».

Modos de funcionamiento

qmake admite dos modos de funcionamiento diferentes. En el modo predeterminado, qmake utiliza la información de un archivo de proyecto para generar un Makefile, pero también es posible utilizar qmake para generar archivos de proyecto. Si deseas establecer el modo de forma explícita, debes especificarlo antes que cualquier otra opción. El mode puede adoptar cualquiera de los dos valores siguientes:

  • -makefile
    La salida de qmake será un Makefile.
  • -project
    La salida de qmake será un archivo de proyecto.

    Nota: Es probable que sea necesario editar el archivo creado. Por ejemplo, añadiendo la variable « QT » para adaptarla a los módulos que requiere el proyecto.

Puedes utilizar la variable ` options ` para especificar tanto ajustes generales como específicos de cada modo. Las opciones que solo se aplican al modo Makefile se describen en la sección «Opciones del modo Makefile», mientras que las opciones que influyen en la creación de archivos de proyecto se describen en la sección «Opciones del modo de proyecto ».

Archivos

El argumento « files » representa una lista de uno o más archivos de proyecto, separados por espacios.

Opciones generales

Se puede especificar una amplia gama de opciones en la línea de comandos de qmake para personalizar el proceso de compilación y anular la configuración predeterminada de tu plataforma. Las siguientes opciones básicas proporcionan ayuda sobre el uso de qmake, especifican dónde escribe qmake el archivo de salida y controlan el nivel de información de depuración que se escribirá en la consola:

  • -help
    qmake repasará estas características y ofrecerá ayuda útil.
  • -o file
    La salida de qmake se dirigirá a . Si no se especifica esta opción, qmake intentará utilizar un nombre de archivo adecuado para su salida, dependiendo del modo en el que se esté ejecutando. Si se especifica «-», la salida se dirige a stdout. file
  • -d
    qmake mostrará información de depuración. Si se añade « » más de una vez, aumentará el nivel de detalle. -d

La plantilla utilizada para el proyecto suele especificarse mediante la variable TEMPLATE en el archivo de proyecto. Puedes anularla o modificarla utilizando las siguientes opciones:

  • -t tmpl
    qmake anulará cualquier variable establecida con , pero solo TEMPLATE tmpldespués de que se haya procesado el archivo .pro.
  • -tp prefix
    qmake añadirá a la variable . prefix TEMPLATE

El nivel de información de las advertencias se puede ajustar con precisión para ayudarte a detectar problemas en tu archivo de proyecto:

  • -Wall
    qmake informará de todas las advertencias conocidas.
  • -Wnone
    qmake no generará ninguna información de advertencia.
  • -Wparser
    qmake solo generará advertencias del analizador sintáctico. Esto te alertará de errores habituales y posibles problemas en el análisis sintáctico de tus archivos de proyecto.
  • -Wlogic
    qmake te avisará de errores comunes y posibles problemas en tu archivo de proyecto. Por ejemplo, qmake informará de la presencia de archivos repetidos en las listas y de archivos que faltan.

Opciones del modo Makefile

qmake -makefile [options] files

En el modo Makefile, qmake generará un Makefile que se utilizará para compilar el proyecto. Además, en este modo se pueden utilizar las siguientes opciones para influir en la forma en que se genera el archivo de proyecto:

  • -after
    qmake procesará las asignaciones indicadas en la línea de comandos después de los archivos especificados.
  • -nocache
    qmake ignorará el archivo « ». .qmake.cache
  • -nodepend
    qmake no generará ninguna información de dependencias.
  • -cache file
    qmake utilizará como archivo de caché, ignorando cualquier otro archivo .qmake.cache que encuentre. file
  • -spec spec
    qmake utilizará como ruta a la información de la plataforma y del compilador, e ignorará el valor de spec QMAKESPEC.

También puedes pasar asignaciones de qmake en la línea de comandos. Estas se procesan antes que todos los archivos especificados. Por ejemplo, el siguiente comando genera un Makefile a partir de test.pro:

qmake -makefile -o Makefile "CONFIG+=test" test.pro

Sin embargo, algunas de las opciones especificadas pueden omitirse, ya que son valores por defecto:

qmake "CONFIG+=test" test.pro

Si estás seguro de que quieres que tus variables se procesen después de los archivos especificados, puedes pasar la opción « -after ». Cuando se especifica esto, todas las asignaciones de la línea de comandos que sigan a la opción « -after » se pospondrán hasta que se hayan analizado los archivos especificados.

Opciones del modo de proyecto

qmake -project [options] files

En el modo de proyecto, qmake generará un archivo de proyecto. Además, en este modo puedes proporcionar las siguientes opciones:

  • -r
    qmake buscará en los directorios indicados de forma recursiva.
  • -nopwd
    qmake no buscará el código fuente en el directorio de trabajo actual. Solo utilizará el ` ` especificado. files

En este modo, el argumento « files » puede ser una lista de archivos o directorios. Si se especifica un directorio, se incluirá en la variable «DEPENDPATH», y el código relevante de ese directorio se incluirá en el archivo de proyecto generado. Si se indica un archivo, se añadirá a la variable correcta, en función de su extensión. Por ejemplo, los archivos de interfaz de usuario se añaden a FORMS, y los archivos C++ se añaden a SOURCES.

En este modo, también se pueden pasar asignaciones en la línea de comandos. Al hacerlo, estas asignaciones se colocarán al final del archivo de proyecto generado.

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