En esta página

Qt para macOS: compilación a partir del código fuente

Requisitos

Para compilar Qt es necesario tener instalado en el sistema un SDK de la plataforma macOS y la cadena de herramientas correspondiente. Puedes obtenerlo instalando Xcode, tal y como se describe en «Entorno de compilación».

Debes utilizar siempre exactamente la misma versión de Xcode y del SDK que se indican en las «Configuraciones compatibles», para garantizar que Qt se haya probado en la configuración en la que estás compilando.

Además de Xcode, deberá asegurarse de que dispone de las siguientes dependencias en su ruta de acceso PATH.

Si quieres compilar Qt WebEngine o Qt PDF, necesitará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 «Instalación de 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 a partir del paquete fuente. Puedes descargar los fuentes de Qt desde la página de descargas. Para obtener más información, visita la página «Introducción a Qt ».

Paso 1: Descomprimir el archivo

Descomprime el archivo si aún no lo has hecho. Por ejemplo, si tienes el paquete qt-everywhere-src-6.12.0.tar.xz, escribe los siguientes comandos en la línea de comandos:

cd /tmp
tar xf ~/Downloads/qt-everywhere-src-6.12.0.tar.xz

Esto crea el directorio /tmp/qt-everywhere-src-6.12.0, que contiene los archivos del archivo comprimido.

Paso 2: Compilar la biblioteca Qt

Para configurar la biblioteca Qt para tu tipo de máquina, crea un directorio de compilación y accede a él. Ejecuta el script ./configure en este directorio.

mkdir -p ~/dev/qt-build
cd ~/dev/qt-build
/tmp/qt-everywhere-src-6.12.0/configure

Nota: configure siempre utiliza el generador y la herramienta de compilación Ninja si hay un ejecutable ninja disponible. Ninja es multiplataforma, cuenta con numerosas funciones, ofrece un alto rendimiento y se recomienda en todas las plataformas. El uso de otros generadores podría funcionar, pero no cuenta con soporte oficial.

De forma predeterminada, Qt está configurado para instalarse en el directorio « /usr/local/6.12.0 », pero esto se puede cambiar utilizando la opción « -prefix ».

Por defecto, Qt se compila como un marco de trabajo, pero puedes compilarlo como un conjunto de bibliotecas dinámicas (dylibs) especificando la opción -no-framework.

Tal y como se describe en «Arquitecturas», Qt se compilará de forma predeterminada para la arquitectura de tu máquina de desarrollo. Para configurar una compilación universal de Qt compatible tanto con Macs con procesadores Intel como con Apple Silicon, añade el siguiente argumento:

./configure -- -DCMAKE_OSX_ARCHITECTURES="x86_64;arm64"

Nota: Una compilación universal siempre debe incluir la arquitectura de tu máquina de desarrollo, ya que el proceso depende de herramientas que se compilan y se ejecutan en tu máquina como parte de la compilación global.

Asegúrate de especificar primero la arquitectura Intel («x86_64»); de lo contrario, es posible que Qt no habilite todas las funcionalidades x86.

Qt también se puede configurar para que se compile con símbolos de depuración. Este proceso se describe detalladamente en el documento «Técnicas de depuración ».

La página Opciones de configuración contiene más información sobre las opciones de configuración.

Para crear la biblioteca y compilar todos los ejemplos y herramientas, escribe:

cmake --build . --parallel

Si « -prefix » se encuentra fuera del directorio de compilación, deberá instalar la biblioteca, los ejemplos y las herramientas en la ubicación adecuada. Para ello, escriba:

cmake --install .

Este comando requiere que tengas acceso de administrador en tu equipo.

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 de la siguiente manera:

En ` .profile ` (si tu shell es bash) o en ` .zshenv ` (si es zsh), añade las siguientes líneas:

PATH=/usr/local/Qt-%VERSION%/bin:$PATH
export PATH

En .login (si tu shell es csh o tcsh), añade la siguiente línea:

setenv PATH /usr/local/Qt-%VERSION%/bin:$PATH

Si utilizas otro shell, modifica tus variables de entorno según corresponda.

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.