En esta página

Notas sobre plataformas

Muchos proyectos multiplataforma pueden gestionarse mediante las funciones básicas de configuración de qmake. Sin embargo, en algunas plataformas, a veces resulta útil, o incluso necesario, aprovechar las características específicas de cada una de ellas. qmake reconoce muchas de estas características, a las que se puede acceder mediante variables específicas que solo surten efecto en las plataformas en las que son relevantes.

macOS, iOS, tvOS y watchOS

Entre las características específicas de estas plataformas se incluyen la compatibilidad con la creación de binarios universales, marcos de trabajo y paquetes.

Paquetes fuente y binarios

La versión de qmake incluida en los paquetes fuente se configura de forma ligeramente diferente a la incluida en los paquetes binarios, ya que utiliza una especificación de características distinta. Mientras que el paquete fuente suele utilizar la especificación macx-g++, el paquete binario suele configurarse para utilizar la especificación macx-xcode.

Los usuarios de cada paquete pueden anular esta configuración ejecutando qmake con la opción -spec (consulte «Ejecución de qmake» para obtener más información). Por ejemplo, para utilizar qmake desde un paquete binario con el fin de crear un Makefile en el directorio de un proyecto, ejecute el siguiente comando:

qmake -spec macx-g++

Uso de marcos de trabajo

qmake es capaz de generar automáticamente reglas de compilación para enlazar con los marcos de trabajo del directorio estándar de marcos de trabajo en macOS, ubicado en /Library/Frameworks/.

Los directorios distintos del directorio estándar de marcos deben especificarse al sistema de compilación, lo cual se consigue añadiendo opciones del enlazador a la variable LIBS, tal y como se muestra en el siguiente ejemplo:

LIBS += -F/path/to/framework/directory/

El propio marco se vincula añadiendo las opciones « -framework » y el nombre del marco a la variable LIBS:

LIBS += -framework TheFramework

Creación de marcos

Cualquier proyecto de biblioteca puede configurarse de modo que el archivo de biblioteca resultante se coloque en un marco de trabajo, listo para su implementación. Para ello, configura el proyecto para que utilice la plantillalib y añade la opción lib_bundle a la variable CONFIG:

TEMPLATE = lib
CONFIG += lib_bundle

Los datos asociados a la biblioteca se especifican mediante la variable QMAKE_BUNDLE_DATA. Esta variable contiene los elementos que se instalarán junto con el paquete de la biblioteca y suele utilizarse para especificar un conjunto de archivos de cabecera, como en el siguiente ejemplo:

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 variable FRAMEWORK_HEADERS se utiliza para especificar los encabezados que requiere un marco de trabajo concreto. Al añadirla a la variable QMAKE_BUNDLE_DATA, se garantiza que la información sobre estos encabezados se incluya en la colección de recursos que se instalarán junto con el paquete de la biblioteca. Además, el nombre y la versión del marco de trabajo se especifican mediante las variables QMAKE_FRAMEWORK_BUNDLE_NAME y QMAKE_FRAMEWORK_VERSION. De forma predeterminada, los valores utilizados para estas variables se obtienen de las variables TARGET y VERSION.

Consulta Qt para macOS - Implementación para obtener más información sobre la implementación de aplicaciones y bibliotecas.

Creación y traslado de proyectos de Xcode

En macOS, los desarrolladores pueden generar archivos de proyecto de Xcode a partir de un archivo de proyecto de qmake existente. Por ejemplo:

qmake -spec macx-xcode project.pro

Nota: Si posteriormente se traslada un proyecto en el disco, es necesario volver a ejecutar qmake para procesar el archivo de proyecto y crear un nuevo archivo de proyecto de Xcode.

Compatibilidad con dos objetivos de compilación simultáneos

Actualmente, esto no es factible, ya que el concepto de «Configuraciones de compilación activas» de Xcode es conceptualmente diferente de la idea de «objetivos de compilación» de qmake.

Los ajustes de «Configuraciones de compilación activas» de Xcode sirven para modificar las configuraciones de Xcode, los parámetros del compilador y otras opciones de compilación similares. A diferencia de Visual Studio, Xcode no permite seleccionar archivos de biblioteca específicos en función de si se eligen configuraciones de compilación de depuración o de lanzamiento. Los ajustes de depuración y lanzamiento de qmake controlan qué archivos de biblioteca se vinculan al ejecutable.

Actualmente no es posible establecer archivos en los ajustes de configuración de Xcode a partir del archivo de proyecto de Xcode generado por qmake. La forma en que se enlazan las bibliotecas en la fase «Frameworks & Libraries» del sistema de compilación de Xcode.

Además, la configuración de compilación activa seleccionada se almacena en un archivo .pbxuser, que es generado por Xcode al cargarse por primera vez, y no creado por qmake.

Windows

Las características específicas de esta plataforma incluyen la compatibilidad con archivos de recursos de Windows (proporcionados o generados automáticamente), la creación de archivos de proyecto de Visual Studio y la gestión de archivos de manifiesto al implementar aplicaciones Qt desarrolladas con Visual Studio 2005 o versiones posteriores.

Incorporación de archivos de recursos de Windows

En esta sección se describe cómo gestionar un archivo de recursos de Windows con qmake para vincularlo a un ejecutable de aplicación (EXE) o a una biblioteca de enlace dinámico (DLL). qmake puede, opcionalmente, generar automáticamente un archivo de recursos de Windows debidamente rellenado.

Un archivo de recursos de Windows vinculado puede contener numerosos elementos a los que pueden acceder su EXE o su DLL. Sin embargo, se debe utilizar el sistema de recursos de Qt para acceder a los recursos vinculados de forma independiente de la plataforma. No obstante, Windows accede directamente a algunos elementos estándar del archivo de recursos de Windows vinculado. Por ejemplo, en el Explorador de Windows, la pestaña «Versión» de las propiedades del archivo se rellena con elementos de recursos. Además, el icono del programa EXE se lee a partir de estos elementos. Por lo tanto, es una buena práctica que un archivo EXE o DLL de Windows creado con Qt utilice ambas técnicas al mismo tiempo: vincular recursos independientes de la plataforma a través del sistema de recursos de Qt y añadir recursos específicos de Windows mediante un archivo de recursos de Windows.

Normalmente, un script de definición de recursos (archivo .rc) se compila en un archivo de recursos de Windows. Dentro de la cadena de herramientas de Microsoft, la herramienta RC genera un archivo .res, que puede enlazarse con el enlazador de Microsoft a un archivo EXE o DLL. La cadena de herramientas MinGW utiliza la herramienta windres para generar un archivo .o que puede enlazarse con el enlazador de MinGW a un archivo EXE o DLL.

La generación automática opcional de un archivo .rc debidamente rellenado por qmake se activa estableciendo al menos una de las variables de sistema VERSION y RC_ICONS. El archivo .rc generado se compila y enlaza automáticamente. Los elementos que se añaden al archivo .rc vienen definidos por las variables de sistema QMAKE_TARGET_COMPANY, QMAKE_TARGET_DESCRIPTION, QMAKE_TARGET_COPYRIGHT, QMAKE_TARGET_PRODUCT, QMAKE_TARGET_ORIGINAL_FILENAME, QMAKE_TARGET_INTERNALNAME, QMAKE_TARGET_COMMENTS, QMAKE_TARGET_TRADEMARKS, QMAKE_MANIFEST, RC_CODEPAGE, RC_ICONS, RC_LANG y VERSION.

Si estos elementos no son suficientes, qmake dispone de las dos variables de sistema RC_FILE y RES_FILE que apuntan directamente a un archivo .rc o .res creado externamente. Al establecer una de estas variables, el archivo especificado se vincula al EXE o a la DLL.

Nota: La generación del archivo .rc por parte de qmake queda bloqueada si se establece RC_FILE o RES_FILE. En este caso, qmake no realiza más cambios en el archivo .rc dado ni en el archivo .res o .o; las variables relacionadas con la generación del archivo .rc no tienen ningún efecto.

Creación de archivos de proyecto de Visual Studio

En esta sección se describe cómo importar un proyecto qmake existente a Visual Studio. qmake es capaz de tomar un archivo de proyecto y crear un proyecto de Visual Studio que contenga toda la información necesaria que requiere el entorno de desarrollo. Esto se consigue configurando la plantilla de proyecto de qmake como vcapp (para proyectos de aplicación) o vclib (para proyectos de biblioteca).

Esto también se puede configurar mediante una opción de línea de comandos, por ejemplo:

qmake -tp vc

Es posible generar de forma recursiva archivos « .vcproj » en los subdirectorios y un archivo « .sln » en el directorio principal, escribiendo:

qmake -tp vc -r

Cada vez que actualices el archivo de proyecto, deberás ejecutar qmake para generar un proyecto de Visual Studio actualizado.

Nota: Si utilizas el complemento de Visual Studio, selecciona Qt > Importar desde archivo .pro para importar los archivos « .pro ».

Archivos de manifiesto de Visual Studio

Al implementar aplicaciones Qt compiladas con Visual Studio 2005 o versiones posteriores, asegúrate de que el archivo de manifiesto creado al vincular la aplicación se gestione correctamente. Esto se gestiona automáticamente en los proyectos que generan DLL.

La eliminación de la incrustación del manifiesto en los ejecutables de la aplicación se puede realizar mediante la siguiente asignación a la variable CONFIG:

CONFIG -= embed_manifest_exe

Asimismo, la incrustación del manifiesto en las DLL se puede eliminar mediante la siguiente asignación a la variable CONFIG:

CONFIG -= embed_manifest_dll

Esto se explica con más detalle en la guía de implementación para Windows.

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