En esta página

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.

VariableDescripción
QT_HOST_PATHUbicació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_TOOLSFuerza 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_TOOLSUtiliza 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:

VariableDescripción
Qt6Widgets_COMPILE_DEFINITIONSUna lista de definiciones de compilación que se deben utilizar al compilar con la biblioteca.
Qt6Widgets_DEFINITIONSUna lista de definiciones que se deben utilizar al compilar contra la biblioteca.
Qt6Widgets_EXECUTABLE_COMPILE_FLAGSUna cadena de opciones que se deben utilizar al compilar ejecutables con la biblioteca.
Qt6Widgets_FOUNDUn valor booleano que indica si se ha encontrado el módulo correctamente.
Qt6Widgets_INCLUDE_DIRSUna lista de directorios de inclusión que se deben utilizar al compilar con la biblioteca.
Qt6Widgets_LIBRARIESEl nombre del objetivo importado para el módulo: Qt6::Widgets
Qt6Widgets_PRIVATE_INCLUDE_DIRSUna 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_VERSIONUna 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.

VariableDescripción

QT_DEFAULT_MAJOR_VERSION

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 5, los comandos que comienzan por qt_ llamarán a su equivalente que comienza por qt5_. Si se establece en 6, llamarán a su equivalente que comienza por qt6_.

Si no se configura, la primera llamada a find_package define la versión por defecto.

QT_LIBINFIXUna cadena que contiene el prefijo utilizado en los nombres de las bibliotecas, cuando Qt se configura con -libinfix.

QT_NO_CREATE_VERSIONLESS_FUNCTIONS

Oculta los comandos que comienzan por qt_, dejando solo los que tienen versión y comienzan por qt6_.

QT_NO_CREATE_VERSIONLESS_TARGETS

Oculta los objetivos importados que empiezan por Qt::. En su lugar, debes utilizar los objetivos que empiezan por Qt6::.
QT_VISIBILITY_AVAILABLEEn 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

ANDROID_NDK_HOST_SYSTEM_NAME

Arquitectura específica de Android del sistema anfitrión

ANDROID_SDK_ROOT

Ubicación del SDK de Android

QT_ANDROID_ABIS

Lista de ABI para las que se compilan los paquetes del proyecto

QT_ANDROID_APPLICATION_ARGUMENTS

Lista de argumentos que se deben pasar a las aplicaciones de Android

QT_ANDROID_BUILD_ALL_ABIS

Permite compilar paquetes con múltiples ABI utilizando la lista de SDK de Qt para Android detectada automáticamente

QT_ANDROID_CREATE_SYMLINKS_ONLY

Crea únicamente enlaces simbólicos para las dependencias en el directorio del proyecto Gradle

QT_ANDROID_DEPLOYMENT_TYPE

Fuerza o desactiva la firma de paquetes de lanzamiento independientemente del tipo de compilación

QT_ANDROID_GENERATE_JAVA_QTQUICKVIEW_CONTENTS

Habilita la generación de clases basadas en QtQuickViewContent

QT_ANDROID_GRADLE_MULTI_MODULE

Compila el paquete de Android a partir de un proyecto Gradle multimódulo

QT_ANDROID_MULTI_ABI_FORWARD_VARS

Permite compartir variables de CMake en compilaciones con múltiples ABI

QT_ANDROID_POST_BUILD_GRADLE_CLEANUP

Realiza una limpieza de Gradle tras la creación del paquete de Android

QT_ANDROID_SIGN_AAB

Firma el paquete .aab con el almacén de claves, el alias y la contraseña del almacén especificados

QT_ANDROID_SIGN_APK

Firma el paquete con el almacén de claves, el alias y la contraseña del almacén especificados

QT_DEPLOY_BIN_DIR

Subdirectorio relativo al prefijo para desplegar binarios en tiempo de ejecución en algunas plataformas de destino

QT_DEPLOY_IGNORED_LIB_DIRS

Directorios excluidos de la búsqueda de dependencias de tiempo de ejecución

QT_DEPLOY_LIBEXEC_DIR

Subdirectorio relativo al prefijo para implementar ejecutables de programa en algunas plataformas de destino

QT_DEPLOY_LIB_DIR

Subdirectorio relativo al prefijo para implementar bibliotecas en algunas plataformas de destino

QT_DEPLOY_PLUGINS_DIR

Subdirectorio relativo al prefijo para implementar complementos de Qt en algunas plataformas de destino

QT_DEPLOY_PREFIX

Ubicación base para una implementación

QT_DEPLOY_QML_DIR

Subdirectorio relativo al prefijo para la implementación de complementos QML en algunas plataformas de destino

QT_DEPLOY_SUPPORT

Nombre del archivo que hay que incluir para configurar la compatibilidad con la implementación

QT_DEPLOY_TRANSLATIONS_DIR

Subdirectorio relativo al prefijo para implementar traducciones de Qt en algunas plataformas de destino

QT_ENABLE_VERBOSE_DEPLOYMENT

Activa el modo detallado de las herramientas de implementación

QT_HOST_PATH

Ubicación de la instalación de Qt del host durante la compilación cruzada

QT_I18N_SOURCE_LANGUAGE

Especifica el idioma de las cadenas traducibles

QT_I18N_TRANSLATED_LANGUAGES

Lista de idiomas que se utilizarán para la internacionalización del proyecto

QT_IOS_LAUNCH_SCREEN

Ruta al storyboard de la pantalla de inicio de iOS utilizado por todos los destinos

QT_NO_COLLECT_BUILD_TREE_APK_DEPS

Impide la recopilación de destinos de bibliotecas compartidas generadas por el proyecto durante la implementación en Android

QT_NO_COLLECT_IMPORTED_TARGET_APK_DEPS

Impide la recopilación de objetivos importados durante el despliegue en Android

QT_NO_SET_XCODE_BUNDLE_IDENTIFIER

Desactiva el suministro de un ID de paquete de aplicación de reserva durante la finalización del objetivo en iOS

QT_NO_SET_XCODE_DEVELOPMENT_TEAM_ID

Desactiva la provisión de un identificador de equipo de reserva durante la finalización del objetivo en iOS

QT_NO_STANDARD_PROJECT_SETUP

Evita que las llamadas posteriores a qt_standard_project_setup() realicen cambios

QT_PATH_ANDROID_ABI_<ABI>

Conjunto de variables para especificar la ruta a Qt para Android para la ABI correspondiente

QT_USE_TARGET_ANDROID_BUILD_DIR

Habilita el uso de directorios de compilación de Android específicos para cada objetivo

Qt6::InterfaceFramework

IFCODEGEN_VERBOSE

Activa el registro detallado para todas las funciones de ifcodegen

QT_IFCODEGEN_TEMPLATE_SEARCH_PATH

Ruta de búsqueda para las plantillas de ifcodegen

Qt6::Multimedia

QT_NO_FFMPEG_XCODE_EMBED_FRAMEWORKS_CODE_SIGN_ON_COPY

Desactiva la firma de código de FFmpeg en iOS

Qt6::Qml

QT_QMLLINT_CONTEXT_PROPERTY_DUMP

Habilita el volcado de propiedades de contexto en los objetivos de lint

QT_QML_GENERATE_AOTSTATS

Controla si está habilitada la recopilación de estadísticas del compilador QML

QT_QML_GENERATE_QMLLS_INI

Activa la generación automática de archivos .qmlls.ini para QML Language Server

QT_QML_GENERATE_QMLLS_INI_NO_CMAKE_CALLS

Personaliza el valor de «no-cmake-calls» en los archivos .qmlls.ini para QML Language Server

QT_QML_NO_CACHEGEN

Desactiva la compilación de archivos QML en bytecode o código C++

QT_QML_NO_QML_PREVIEW (global property)

Controla si la compatibilidad con qmlpreview se configura automáticamente para los ejecutables que se enlazan con Qt6::Qml

QT_QML_OUTPUT_DIRECTORY

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