Qt para macOS
Qt para macOS permite compilar aplicaciones para la gama de ordenadores Mac de Apple.
Para desarrollar con Qt para macOS, sigue la guía de introducción; a continuación, explora los ejemplos de Qt y los temas relacionados.
Configuraciones compatibles
Qt 6.12 es compatible con las siguientes versiones del entorno de compilación y de la plataforma de ejecución de destino.
| Entorno de compilación | Plataforma de destino | Arquitectura |
|---|---|---|
| Xcode 16 (SDK de macOS 15) o superior | macOS 14.4 o superior (incluido macOS 26) | x86_64, x86_64h, arm64 |
Nota: La promesa de compatibilidad con futuras versiones de macOSpor parte de Apple garantiza, en general, que las aplicaciones Qt sigan funcionando correctamente en las nuevas versiones del sistema operativo. Los problemas que puedan surgir se priorizan y se programan de acuerdo con las políticas de ramificación y soporte de Qt. El soporte para las nuevas funciones del sistema operativo no suele incluirse en las versiones de parches.
Entorno de compilación
El entorno de compilación para macOS lo proporciona la aplicación Xcode de Apple, que incluye tanto la cadena de herramientas (compilador, enlazador y otras herramientas) como el SDK de la plataforma macOS (cabeceras y bibliotecas) con el que se compila y se enlaza. En conjunto, estos elementos definen cómo se compila la aplicación.
Apple suele recomendar (y, en el caso de la App Store, exige) que las aplicaciones se compilen con el SDK más reciente disponible, por lo que siempre debes utilizar la última versión de Xcode de Apple. Esto puede requerir actualizar la versión de macOS de tu sistema, ya que es posible que las nuevas versiones de Xcode no funcionen en versiones anteriores de macOS.
Nota: El entorno de compilación de macOS viene definido siempre en su totalidad por la versión de Xcode (su cadena de herramientas y sus SDK) que estés utilizando, yno por la versión de macOS en la que ejecutes Xcode.
Excluirse de los cambios de comportamiento
Una salvedad a la hora de utilizar la última versión de Xcode y el SDK para compilar tu aplicación es que los marcos del sistema de macOS a veces decidirán si habilitan o no los cambios de comportamiento en función del SDK con el que hayas compilado tu aplicación.
Esta técnica permite a Apple garantizar que los binarios compilados con SDK más antiguos sigan ejecutándose sin regresiones en las versiones más recientes de macOS.
Por ejemplo, cuando se introdujo el modo oscuro en macOS 10.14 Mojave, macOS solo consideraba que las aplicaciones compiladas con el SDK 10.14 eran compatibles con el modo oscuro, mientras que las aplicaciones compiladas con SDK anteriores conservaban el aspecto predeterminado del modo claro.
Compilar con una versión anterior de Xcode, utilizando un SDK anterior, es una forma de evitar estos cambios de comportamiento, pero es una solución de último recurso y solo debe aplicarse si tu aplicación no tiene otras formas de solucionar el problema.
Plataformas de destino
La compilación para macOS utiliza una técnica denominada «enlaces débiles» que permite compilar la aplicación utilizando los encabezados y las bibliotecas del SDK más reciente de la plataforma, al tiempo que permite que la aplicación se implemente en versiones de macOS anteriores a la versión del SDK. Cuando el binario se ejecuta en una versión de macOS anterior a la del SDK con el que se compiló, Qt comprueba en tiempo de ejecución si una función de la plataforma está disponible antes de utilizarla.
En teoría, esto permitiría ejecutar la aplicación en todas y cada una de las versiones de macOS lanzadas, pero por razones prácticas (y técnicas) existe un límite mínimo en este rango, conocido como «objetivo de implementación » de la aplicación. Si el binario se ejecuta en una versión de macOS inferior al objetivo de implementación, Qt mostrará un mensaje de error y la aplicación no se ejecutará.
Qt expresa el objetivo de implementación mediante las variables CMAKE_OSX_DEPLOYMENT_TARGET o QMAKE_MACOSX_DEPLOYMENT_TARGET, que por defecto está establecido en el objetivo de implementación mínimo compatible con Qt.
Solo es necesario aumentar el objetivo de implementación si tu propio código utiliza API que se añadieron en una versión de macOS superior a la que Qt utiliza por defecto, y no estás utilizando comprobaciones « @available » para proteger su uso en tiempo de ejecución.
Para aumentar el objetivo de implementación con CMake:
set(CMAKE_OSX_DEPLOYMENT_TARGET "42.0")o con qmake:
QMAKE_MACOSX_DEPLOYMENT_TARGET = 42.0Nota: Nodebes reducir el objetivo de implementación por debajo del valor predeterminado establecido por Qt. Si lo haces, es probable que se produzcan fallos en tiempo de ejecución si el binario se implementa en una versión de macOS inferior a la que Qt esperaba que se ejecutara.
Para obtener más información sobre el desarrollo basado en SDK en plataformas de Apple, consulta la documentación para desarrolladores de Apple.
Arquitecturas
De forma predeterminada, Qt se compilará para la arquitectura de tu equipo de desarrollo: x86_64 si utilizas un Mac con procesador Intel, o arm64 si utilizas un Mac con Apple Silicon.
Para compilar para otras arquitecturas, puedes utilizar las variables CMAKE_OSX_ARCHITECTURESQMAKE_APPLE_DEVICE_ARCHS y x86_64 en los archivos de tu proyecto o en la línea de comandos. Esto te permite tanto compilar de forma cruzada para una arquitectura diferente como generar binarios universales (multiarquitectura). Por ejemplo, para compilar tu aplicación tanto para como para arm64 con CMake:
cmake ~/src/myapp -DCMAKE_OSX_ARCHITECTURES="x86_64;arm64"o con qmake:
qmake ~/src/myapp QMAKE_APPLE_DEVICE_ARCHS="x86_64 arm64"Al especificar las arquitecturas en un archivo de proyecto, no deben ir entre comillas, por ejemplo:
TEMPLATE = app
SOURCES = main.cpp
QMAKE_APPLE_DEVICE_ARCHS = x86_64 arm64Compatibilidad con subarquitecturas en Macs con procesador Intel
Además de la arquitectura de referencia x86_64, Qt también es compatible con la subarquitectura x86_64h («Haswell»), que mejora el rendimiento en los Mac con procesador Intel.
Primeros pasos
Instalación de Xcode
Xcode es un requisito imprescindible para desarrollar con Qt para macOS. Se puede instalar desde la App Store o descargar desde la página web para desarrolladores de Apple.
Una vez instalado, ejecuta Xcode una vez para que instale las dependencias necesarias.
A continuación, comprueba que el sistema está utilizando la instalación correcta de Xcode mediante la herramienta « xcode-select ».
$ xcode-select -print-path
/Applications/Xcode.app/Contents/DeveloperSi el resultado no coincide con lo esperado, selecciona explícitamente la instalación de Xcode.
$ sudo xcode-select --switch /Applications/Xcode.appInstalación o compilación de Qt
Para instalar o compilar Qt, sigue la guía general de introducción a Qt.
También puedes consultar «Formas alternativas de instalar Qt en macOS» para obtener información sobre cómo instalar Qt desde Homebrew.
Generación de archivos de proyecto de Xcode
Por defecto, CMake y qmake generan archivos de proyecto en formato Makefile. Si prefieres compilar y depurar tu aplicación desde Xcode, puedes solicitar que se genere un proyecto de Xcode en su lugar:
cmake ~/src/myapp -GXcodeo con qmake:
qmake ~/src/myapp -spec macx-xcodeImplementación de aplicaciones en macOS
Las aplicaciones de macOS suelen implementarse como paquetes de aplicación autónomos. El paquete de aplicación contiene el ejecutable de la aplicación, así como las dependencias, como las bibliotecas Qt, los complementos, las traducciones y otros recursos que puedas necesitar. Las bibliotecas de terceros, como Qt, no suelen instalarse en todo el sistema; cada aplicación proporciona su propia copia.
Para compilar tu aplicación como un paquete de aplicación con CMake, configura la MACOSX_BUNDLE propiedad en tu objetivo ejecutable, de la siguiente manera:
qt_add_executable(MyApp)
if(APPLE)
set_target_properties(MyApp PROPERTIES MACOSX_BUNDLE TRUE)
endif()Con qmake, los paquetes son la opción predeterminada. Establece « CONFIG -= app_bundle » en tu archivo de proyecto (.pro) para desactivarlos.
Una forma habitual de distribuir aplicaciones es proporcionar una imagen de disco comprimida (archivo .dmg) que el usuario pueda montar en el Finder. La herramienta de implementación, macdeployqt (disponible en los instaladores de macOS), se puede utilizar para crear paquetes autónomos y, opcionalmente, también para crear un archivo .dmg.
Las aplicaciones también se pueden distribuir a través de la Mac App Store. Se puede utilizar «macdeployqt» (bin/macdeployqt) como punto de partida para la implementación en la App Store. Para garantizar que Qt cumpla con las normas del entorno aislado de la App Store, Qt debe configurarse con el argumento « -feature-appstore-compliant ».
Para obtener más información sobre la implementación en macOS, consulta Qt para macOS: Implementación.
Nota: Para vender aplicaciones en la App Store de macOS, se aplican normas especiales. Para superar la validación, la aplicación debe verificar la existencia de un recibo válido antes de ejecutar cualquier código. Dado que se trata de un mecanismo de protección contra copias, se deben tomar medidas para evitar patrones comunes y ofuscar el código que valida el recibo en la medida de lo posible. Por lo tanto, esto no puede automatizarse mediante Qt, sino que requiere código específico de la plataforma escrito expresamente para la propia aplicación. Se puede encontrar más información en la documentación de Apple.
Temas relacionados
Los siguientes temas ofrecen más detalles sobre Qt para macOS:
- Qt para macOS: compilación a partir del código fuente
- Qt para macOS: implementación
- Qt para macOS: problemas específicos
Uso de código Objective-C en aplicaciones Qt
Clang, el compilador utilizado para aplicaciones en plataformas de Apple, permite mezclar código C++ y Objective-C. Para habilitar este modo, utiliza la extensión « .mm » en los archivos fuente correspondientes y añádelos a tu proyecto como de costumbre.
Con CMake:
target_sources(myapp PRIVATE objc_code.mm)Con qmake:
SOURCES += objc_code.mmDe este modo, podrás utilizar los marcos de trabajo de Objective-C de la biblioteca para desarrolladores de Apple en tus aplicaciones Qt.
Para hacer que la funcionalidad esté disponible para el resto de tu aplicación, sin tener que renombrar todos tus archivos fuente, declara funciones auxiliares en un archivo de cabecera e implementa la funcionalidad en un archivo fuente de Objective-C++:
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.