Creación de proyectos en la línea de comandos

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

Para construir un proyecto Qt, CMake necesita saber dónde se encuentra la instalación de Qt. Normalmente esto se hace estableciendo la variable de CMake CMAKE_PREFIX_PATH al prefijo de instalación de Qt. Si está realizando una compilación cruzada, vea Compilación cruzada para más detalles sobre las variables adicionales que necesitará establecer.

Si Qt se instala usando Qt Online Installer, elija 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.11.0\msvc2022_64 -S <source-dir> -B <build-dir>

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

Generadores CMake

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

El generador por defecto 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 una experiencia consistente del desarrollador en todas las plataformas, utilice el generador Ninja o Ninja Multi-Config.

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

cmake -G Ninja ...

qt-cmake

El script qt-cmake es una cómoda alternativa para configurar tu proyecto. Elimina la necesidad de especificar el CMAKE_PREFIX_PATH. Puedes encontrarlo ubicado en el directorio bin de tu prefijo de instalación de Qt. El script pasa todos los parámetros a CMake, así que puedes usarlo igual que usarías cmake:

C:\Qt\6.11.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 ser compilado:

cd <build-dir>
ninja

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

cmake --build <build-dir>

Compilación cruzada

Construir tu proyecto para una plataforma que es diferente de tu máquina de desarrollo se llama compilación cruzada. Un ejemplo es la construcción para Android (la plataforma de destino) en una máquina Windows (la plataforma host).

La compilación cruzada con CMake requiere un archivo toolchain 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 Qt para Windows y Qt para Android instalados para realizar la compilación cruzada para Android en Windows.

Utilice qt-cmake desde la instalación de Qt para la plataforma de destino, para realizar la compilación cruzada de su 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 toolchain se pasa automáticamente, y posiblemente otras variables específicas de la plataforma se configuran.

Especificación de un archivo toolchain personalizado

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

Si estás usando una instalación de Qt que no ha sido construida en tu máquina, qt-cmake necesita saber la localización del archivo toolchain 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 estableciendo la variable QT_CHAINLOAD_TOOLCHAIN_FILE:

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

Esto instruye al archivo de cadena de herramientas interno de Qt para que cargue también tu archivo de cadena de herramientas personalizado.