En esta página

Compilación de proyectos desde la línea de comandos

Esta página explica cómo configurar y compilar proyectos existentes. Si quieres saber cómo crear un proyecto CMake basado en Qt, consulta la documentación sobre cómo empezar a utilizar CMake.

Para compilar un proyecto Qt, CMake necesita saber dónde se encuentra la instalación de Qt. Normalmente, esto se hace configurando la variable de CMake CMAKE_PREFIX_PATH con el prefijo de instalación de Qt. Si estás realizando una compilación cruzada, consulta «Compilación cruzada» para obtener más detalles sobre las variables adicionales que deberás configurar.

Si Qt se ha instalado mediante Qt Online Installer, elige una versión de Qt dentro del directorio de instalación de nivel superior. Por ejemplo, el siguiente comando muestra cómo se hace esto en Windows:

cmake -DCMAKE_PREFIX_PATH=C:\Qt\6.12.0\msvc2022_64 -S <source-dir> -B <build-dir>

Los marcadores de posición <source-dir> y <build-dir> representan los directorios de código fuente y de compilación de tu proyecto.

Generadores de CMake

CMake genera los archivos necesarios del sistema de compilación que permiten a herramientas como GNU Make o Ninja compilar tu proyecto.

El generador predeterminado de CMake depende de la plataforma y del entorno de compilación. Por ejemplo, en Windows, CMake genera archivos de proyecto de Visual Studio si se detecta un entorno de Visual Studio.

Para garantizar una experiencia de desarrollo coherente en todas las plataformas, utiliza el generador Ninja o Ninja Multi-Config.

Puede seleccionar el generador de CMake bien estableciendo la variable de entorno ` CMAKE_GENERATOR `, bien utilizando el argumento ` -G `:

cmake -G Ninja ...

qt-cmake

El script qt-cmake es una alternativa práctica para configurar su proyecto. Elimina la necesidad de especificar el argumento CMAKE_PREFIX_PATH. Lo encontrará en el directorio bin del prefijo de instalación de Qt. El script pasa todos los parámetros a CMake, por lo que puede utilizarlo igual que utilizaría cmake:

C:\Qt\6.12.0\msvc2022_64\bin\qt-cmake -G Ninja -S <source-dir> -B <build-dir>

Una vez generados los archivos del sistema de compilación, tu proyecto estará listo para compilarse:

cd <build-dir>
ninja

También puedes utilizar el comando CMake independiente del generador:

cmake --build <build-dir>

Compilación cruzada

Compilar tu proyecto para una plataforma diferente a tu máquina de desarrollo se denomina «compilación cruzada». Un ejemplo es compilar para Android (la plataforma de destino) en una máquina con Windows (la plataforma de host).

La compilación cruzada con CMake requiere un archivo de cadena de herramientas para la mayoría de las plataformas. También requiere una versión de Qt para el host de desarrollo, además de una versión de Qt para la plataforma de destino. Por ejemplo, necesitas tener instalados Qt para Windows y Qt para Android para realizar una compilación cruzada para Android en Windows.

Utiliza ` qt-cmake ` desde la instalación de Qt para la plataforma de destino, a fin de compilar de forma cruzada tu proyecto para esa plataforma:

<target-qt>/bin/qt-cmake -S <source-dir> -B <build-dir>

Esto configurará tu proyecto para la plataforma de destino. El archivo de la cadena de herramientas se pasa automáticamente y, posiblemente, se configuran otras variables específicas de la plataforma.

Especificar un archivo de cadena de herramientas personalizado

El script qt-cmake pasa un archivo de cadena de herramientas interno de Qt a CMake. Este archivo de cadena de herramientas establece varias variables específicas de la plataforma de destino de Qt.

Si utilizas una instalación de Qt que no se ha compilado en tu equipo, qt-cmake necesita conocer la ubicación del archivo de la cadena de herramientas de CMake para la plataforma de destino.

En tal caso, puede indicar a qt-cmake que cargue en cadena un archivo de cadena de herramientas personalizado configurando la variable ` QT_CHAINLOAD_TOOLCHAIN_FILE `:

~/Qt/6.12.0/android_armv7/bin/qt-cmake -DQT_CHAINLOAD_TOOLCHAIN_FILE=<file-path> -S <source-dir> -B <build-dir>

Esto indica al archivo de la cadena de herramientas interna de Qt que cargue también su archivo de cadena de herramientas personalizado.

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