Referencia de variables de CMake
Variables de compilación de Qt
Al compilar Qt, puedes utilizar variables de CMake para controlar el resultado de la compilación.
| Variable | Descripción |
|---|---|
| QT_HOST_PATH | Ubicación de la instalación de Qt en el sistema anfitrión, desde la cual se pueden utilizar las herramientas del sistema anfitrión durante otra compilación de Qt, ya sea una compilación normal o una compilación cruzada. |
QT_FORCE_BUILD_TOOLS | Fuerza el uso de las herramientas de compilación incluso si ya se han encontrado las herramientas del sistema host. Resulta útil al realizar una compilación cruzada de Qt para garantizar que el SDK disponga de herramientas compiladas de forma cruzada. |
QT_FORCE_FIND_TOOLS | Utiliza las herramientas de Qt del Qt precompilado en QT_HOST_PATH cuando no se realiza una compilación cruzada. La variable solo surte efecto si QT_FORCE_BUILD_TOOLS está configurada en ON. De lo contrario, QT_FORCE_FIND_TOOLS no afecta al comportamiento predeterminado. |
Variables de módulo
Los módulos de Qt cargados con find_package establecen diversas variables.
Nota: Raravez es necesario acceder directamente a estas variables. Las tareas habituales, como la vinculación con un módulo, deben realizarse a través de los objetivos de biblioteca que define cada módulo.
Por ejemplo, al ejecutar « find_package(Qt6 COMPONENTS Widgets) » con éxito, se habilitan las siguientes variables:
| Variable | Descripción |
|---|---|
Qt6Widgets_COMPILE_DEFINITIONS | Una lista de definiciones de compilación que se deben utilizar al compilar con la biblioteca. |
Qt6Widgets_DEFINITIONS | Una lista de definiciones que se deben utilizar al compilar contra la biblioteca. |
Qt6Widgets_EXECUTABLE_COMPILE_FLAGS | Una cadena de opciones que se deben utilizar al compilar ejecutables con la biblioteca. |
Qt6Widgets_FOUND | Un valor booleano que indica si se ha encontrado el módulo correctamente. |
Qt6Widgets_INCLUDE_DIRS | Una lista de directorios de inclusión que se deben utilizar al compilar con la biblioteca. |
Qt6Widgets_LIBRARIES | El nombre del objetivo importado para el módulo: Qt6::Widgets |
Qt6Widgets_PRIVATE_INCLUDE_DIRS | Una lista de directorios de inclusión privados que se deben utilizar al compilar con la biblioteca y al utilizar la API privada de Qt. |
Qt6Widgets_VERSION | Una cadena que contiene la versión del módulo. |
Para todos los paquetes encontrados con ` find_package`, hay disponibles equivalentes de estas variables; distinguen entre mayúsculas y minúsculas.
Variables de instalación
Además, también hay variables que no se refieren a un paquete concreto, sino a la propia instalación de Qt.
| Variable | Descripción |
|---|---|
| Un número entero que controla la versión de Qt a la que se dirigen los comandos de qt_ en caso de proyectos mixtos de Qt 5 y Qt 6. Debe establecerse en 5 o 6 antes de las respectivas llamadas a find_package().Si se establece en Si no se configura, la primera llamada a |
QT_LIBINFIX | Una cadena que contiene el prefijo utilizado en los nombres de las bibliotecas, cuando Qt se configura con -libinfix. |
| Oculta los comandos que comienzan por qt_, dejando solo los que tienen versión y comienzan por qt6_. |
| Oculta los objetivos importados que empiezan por Qt::. En su lugar, debes utilizar los objetivos que empiezan por Qt6::. |
QT_VISIBILITY_AVAILABLE | En Unix, un valor booleano que indica si las bibliotecas y los complementos de Qt se han compilado con -fvisibility=hidden. Esto significa que solo se exportan los símbolos seleccionados. |
Variables del proyecto
Estas variables pueden influir en los comandos de CMake proporcionados por Qt. Pueden ser configuradas por el proyecto, un archivo de cadena de herramientas u otros paquetes de terceros.
Qt6::Core
Arquitectura específica de Android del sistema anfitrión | |
Ubicación del SDK de Android | |
Lista de ABI para las que se compilan los paquetes del proyecto | |
Lista de argumentos que se deben pasar a las aplicaciones de Android | |
Permite compilar paquetes con múltiples ABI utilizando la lista de SDK de Qt para Android detectada automáticamente | |
Crea únicamente enlaces simbólicos para las dependencias en el directorio del proyecto Gradle | |
Fuerza o desactiva la firma de paquetes de lanzamiento independientemente del tipo de compilación | |
Habilita la generación de clases basadas en QtQuickViewContent | |
Compila el paquete de Android a partir de un proyecto Gradle multimódulo | |
Permite compartir variables de CMake en compilaciones con múltiples ABI | |
Realiza una limpieza de Gradle tras la creación del paquete de Android | |
Firma el paquete .aab con el almacén de claves, el alias y la contraseña del almacén especificados | |
Firma el paquete con el almacén de claves, el alias y la contraseña del almacén especificados | |
Subdirectorio relativo al prefijo para desplegar binarios en tiempo de ejecución en algunas plataformas de destino | |
Directorios excluidos de la búsqueda de dependencias de tiempo de ejecución | |
Subdirectorio relativo al prefijo para implementar ejecutables de programa en algunas plataformas de destino | |
Subdirectorio relativo al prefijo para implementar bibliotecas en algunas plataformas de destino | |
Subdirectorio relativo al prefijo para implementar complementos de Qt en algunas plataformas de destino | |
Ubicación base para una implementación | |
Subdirectorio relativo al prefijo para la implementación de complementos QML en algunas plataformas de destino | |
Nombre del archivo que hay que incluir para configurar la compatibilidad con la implementación | |
Subdirectorio relativo al prefijo para implementar traducciones de Qt en algunas plataformas de destino | |
Activa el modo detallado de las herramientas de implementación | |
Ubicación de la instalación de Qt del host durante la compilación cruzada | |
Especifica el idioma de las cadenas traducibles | |
Lista de idiomas que se utilizarán para la internacionalización del proyecto | |
Ruta al storyboard de la pantalla de inicio de iOS utilizado por todos los destinos | |
Impide la recopilación de destinos de bibliotecas compartidas generadas por el proyecto durante la implementación en Android | |
Impide la recopilación de objetivos importados durante el despliegue en Android | |
Desactiva el suministro de un ID de paquete de aplicación de reserva durante la finalización del objetivo en iOS | |
Desactiva la provisión de un identificador de equipo de reserva durante la finalización del objetivo en iOS | |
Evita que las llamadas posteriores a qt_standard_project_setup() realicen cambios | |
Conjunto de variables para especificar la ruta a Qt para Android para la ABI correspondiente | |
Habilita el uso de directorios de compilación de Android específicos para cada objetivo |
Qt6::InterfaceFramework
Activa el registro detallado para todas las funciones de ifcodegen | |
Ruta de búsqueda para las plantillas de ifcodegen |
Qt6::Multimedia
Desactiva la firma de código de FFmpeg en iOS |
Qt6::Qml
Habilita el volcado de propiedades de contexto en los objetivos de lint | |
Controla si está habilitada la recopilación de estadísticas del compilador QML | |
Activa la generación automática de archivos .qmlls.ini para QML Language Server | |
Personaliza el valor de «no-cmake-calls» en los archivos .qmlls.ini para QML Language Server | |
Desactiva la compilación de archivos QML en bytecode o código C++ | |
Controla si la compatibilidad con qmlpreview se configura automáticamente para los ejecutables que se enlazan con Qt6::Qml | |
Directorio de salida base en el que se crearán por defecto los módulos QML |
Variables estándar de CMake
| CMAKE_AUTOGEN_BETTER_GRAPH_MULTI_CONFIG | Mejora el gráfico de dependencias para los generadores de configuraciones múltiples |
© 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.