Qt para macOS - Creación desde el código fuente
Requisitos
La compilación de Qt requiere que el SDK de la plataforma macOS y la cadena de herramientas correspondiente estén instalados en el sistema. Puedes conseguirlo instalando Xcode, como se describe en Entorno de compilación.
Deberías usar siempre exactamente la misma versión de Xcode y SDK que aparece en Configuraciones Soportadas, para asegurarte de que Qt ha sido probado en la configuración que estás construyendo.
Además de Xcode, necesitarás asegurarte de que tienes las siguientes dependencias en tu ruta PATH.
- CMake (>=3.22)
- Ninja
Si quieres compilar Qt WebEngine o Qt PDFnecesitarás las siguientes dependencias adicionales:
- Python html5lib
- Bison, Flex
- Gperf
- Node.js versión 8 o posterior (se recomienda la versión 12)
Dependencias de QDoc
QDoc utiliza Clang para analizar el código C++. Si deseas compilar QDoc manualmente, consulta Instalar Clang para QDoc para conocer los requisitos específicos de compilación.
Pasos para la compilación
Las siguientes instrucciones describen cómo compilar Qt desde el paquete fuente. Puede descargar las fuentes de Qt desde la página de descargas. Para obtener más información, visite la página Introducción a Qt.
Paso 1: Descomprimir el archivo
Descomprima el archivo si aún no lo ha hecho. Por ejemplo, si tiene el paquete qt-everywhere-src-6.11.0.tar.xz, escriba los siguientes comandos en una línea de comandos:
cd /tmp tar xf ~/Downloads/qt-everywhere-src-6.11.0.tar.xz
Esto crea el directorio /tmp/qt-everywhere-src-6.11.0 que contiene los ficheros del archivo.
Paso 2: Construir la librería Qt
Para configurar la librería Qt para su tipo de máquina, cree un directorio de construcción y cambie a él. Ejecute el script ./configure en este directorio.
mkdir -p ~/dev/qt-build cd ~/dev/qt-build /tmp/qt-everywhere-src-6.11.0/configure
Nota: configure siempre utiliza el generador Ninja y la herramienta de construcción si un ejecutable ninja está disponible. Ninja es multiplataforma, rico en funciones, eficaz y recomendado en todas las plataformas. El uso de otros generadores puede funcionar pero no está soportado oficialmente.
Por defecto, Qt está configurado para instalarse en el directorio /usr/local/6.11.0, pero esto puede cambiarse utilizando la opción -prefix.
Por defecto, Qt se construye como un framework, pero puedes construirlo como un conjunto de librerías dinámicas (dylibs) especificando la opción -no-framework.
Como se describe en Arquitecturas, Qt se construirá para la arquitectura de su máquina de desarrollo por defecto. Para configurar una compilación universal de Qt con soporte para Intel y Apple Silicon Macs, añada el siguiente argumento:
./configure -- -DCMAKE_OSX_ARCHITECTURES="x86_64;arm64"
Nota: Una compilación universal siempre necesita incluir la arquitectura de su máquina de desarrollo, ya que el proceso se basa en herramientas que se compilan y ejecutan en su máquina como parte de la compilación general.
Tenga cuidado de especificar primero la arquitectura Intel ("x86_64"), de lo contrario Qt podría no habilitar toda la funcionalidad x86.
Qt también puede ser configurado para ser construido con símbolos de depuración. Este proceso se describe en detalle en el documento Técnicas de depuración.
La página Configurar Opciones contiene más información sobre las opciones de configuración.
Para crear la biblioteca y compilar todos los ejemplos y herramientas, escriba:
cmake --build . --parallel
Si -prefix se encuentra fuera del directorio de compilación, deberá instalar la biblioteca, los ejemplos y las herramientas en el lugar adecuado. Para ello, escriba:
cmake --install .
Este comando requiere que tenga acceso de administrador en su máquina.
Paso 3: Configurar las variables de entorno
Para poder utilizar Qt, es necesario ampliar algunas variables de entorno.
PATH - to locate qmake, moc and other Qt tools
Esto se hace así:
En .profile (si tu shell es bash), o .zshenv (para zsh) añade las siguientes líneas:
PATH=/usr/local/Qt-%VERSION%/bin:$PATH export PATH
En .login (en caso de que tu shell sea csh o tcsh), añade la siguiente línea:
setenv PATH /usr/local/Qt-%VERSION%/bin:$PATH
Si utiliza un shell diferente, modifique sus variables de entorno en consecuencia.
Qt ya está instalado.
© 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.