Referencia de comandos CMake Referencia de propiedades CMake

Referencia de variables CMake

Variables de compilación de Qt

Al compilar Qt puedes usar variables CMake para controlar el resultado de la compilación.

Variable	Descripción
QT_HOST_PATH	Ubicación de la instalación host de Qt desde la que se pueden usar las herramientas host durante otra compilación de Qt, ya sea una normal o una de compilación cruzada.
`QT_FORCE_BUILD_TOOLS`	Fuerza la construcción de herramientas incluso si las herramientas host ya han sido encontradas. Útil cuando se hace compilación cruzada de Qt para asegurar que el SDK tiene herramientas de compilación cruzada.
`QT_FORCE_FIND_TOOLS`	Utiliza las herramientas Qt del Qt precompilado en `QT_HOST_PATH` cuando no se hace compilación cruzada. La variable sólo tiene efecto si `QT_FORCE_BUILD_TOOLS` se establece en `ON`. En caso contrario `QT_FORCE_FIND_TOOLS` no afecta al comportamiento por defecto.

Variables de módulo

Los módulos Qt cargados con find_package establecen diversas variables.

Nota: Raramente necesitará acceder a estas variables directamente. Tareas comunes como enlazar contra un módulo deberían hacerse a través de los objetivos de biblioteca que cada módulo define.

Por ejemplo, find_package(Qt6 COMPONENTS Widgets), cuando tiene éxito, hace que las siguientes variables estén disponibles:

Variable	Descripción
`Qt6Widgets_COMPILE_DEFINITIONS`	Una lista de definiciones de compilación a utilizar cuando se construye contra la biblioteca.
`Qt6Widgets_DEFINITIONS`	Una lista de definiciones a utilizar cuando se compile con la biblioteca.
`Qt6Widgets_EXECUTABLE_COMPILE_FLAGS`	Una cadena de banderas a utilizar al compilar ejecutables con la biblioteca.
`Qt6Widgets_FOUND`	Un booleano que indica si el módulo se ha encontrado correctamente.
`Qt6Widgets_INCLUDE_DIRS`	Una lista de los directorios de inclusión que se utilizarán 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 para utilizar cuando se construye con la biblioteca y se utiliza 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, están disponibles los 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 en particular, sino a la propia instalación de Qt.

Variable	Descripción
`QT_DEFAULT_MAJOR_VERSION`	Un entero que controla la versión de Qt a la que los comandos de `qt_` reenvían en caso de proyectos mixtos Qt 5 y Qt 6. Debe establecerse en `5` o `6` antes de las respectivas llamadas a `find_package()`. Si se establece a `5`, los comandos que comienzan con `qt_` llamarán a su contraparte que comienza con `qt5_`. Si se establece a `6`, llamarán a su contraparte que comienza con `qt6_`. Si no se establece, la primera llamada a `find_package` define la versión por defecto.
`QT_LIBINFIX`	Una cadena que contiene el infijo utilizado en los nombres de las bibliotecas, cuando Qt está configurado con `-libinfix`.
`QT_NO_CREATE_VERSIONLESS_FUNCTIONS`	Oculta los comandos que empiezan por `qt_`, dejando sólo los versionados que empiezan por `qt6_`.
`QT_NO_CREATE_VERSIONLESS_TARGETS`	Oculta los objetivos importados que empiezan por `Qt::`. En su lugar, es necesario utilizar los objetivos que empiezan por `Qt6::`.
`QT_VISIBILITY_AVAILABLE`	En Unix, un booleano que describe si las librerías Qt y los plugins fueron compilados con `-fvisibility=hidden`. Esto significa que sólo se exportan los símbolos seleccionados.

Variables del proyecto

Estas variables pueden influir en los comandos CMake proporcionados por Qt. Pueden ser establecidas por el proyecto, un archivo toolchain 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 ABIs para las que se construyen los paquetes del proyecto
QT_ANDROID_APPLICATION_ARGUMENTS	Lista de argumentos a pasar a las aplicaciones Android
QT_ANDROID_BUILD_ALL_ABIS	Permite construir paquetes multi-ABI usando la lista autodetectada de Qt para Android SDK
QT_ANDROID_CREATE_SYMLINKS_ONLY	Sólo crea enlaces simbólicos para dependencias bajo el directorio del proyecto Gradle
QT_ANDROID_DEPLOYMENT_TYPE	Fuerza o deshabilita la firma de paquetes de lanzamiento independientemente del tipo de compilación
QT_ANDROID_GENERATE_JAVA_QTQUICKVIEW_CONTENTS	Permite la generación de clases basadas en QtQuickViewContent
QT_ANDROID_MULTI_ABI_FORWARD_VARS	Permite compartir variables CMake en construcciones multi-ABI
QT_ANDROID_POST_BUILD_GRADLE_CLEANUP	Realiza una limpieza Gradle después de crear el paquete Android
QT_ANDROID_SIGN_AAB	Firma el paquete .aab con el almacén de claves, el alias y la contraseña de almacén especificados.
QT_ANDROID_SIGN_APK	Firma el paquete con el almacén de claves, el alias y la contraseña de almacenamiento especificados.
QT_DEPLOY_BIN_DIR	Subdirectorio relativo al prefijo para implantar binarios de 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 distribuir ejecutables de programa en algunas plataformas de destino
QT_DEPLOY_LIB_DIR	Subdirectorio relativo al prefijo para desplegar bibliotecas en algunas plataformas de destino
QT_DEPLOY_PLUGINS_DIR	Subdirectorio relativo al prefijo para instalar plugins de Qt en algunas plataformas de destino
QT_DEPLOY_PREFIX	Ubicación base para un despliegue
QT_DEPLOY_QML_DIR	Subdirectorio relativo al prefijo para la implantación de plugins QML en algunas plataformas de destino
QT_DEPLOY_SUPPORT	Nombre del archivo que debe incluirse para configurar la compatibilidad con la implantación
QT_DEPLOY_TRANSLATIONS_DIR	Subdirectorio relativo al prefijo para la implantación de traducciones de Qt en algunas plataformas de destino
QT_ENABLE_VERBOSE_DEPLOYMENT	Habilita el modo detallado de las herramientas de implantación
QT_HOST_PATH	Ubicación de la instalación anfitriona de Qt al realizar 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 guión gráfico de la pantalla de inicio de iOS utilizado por todos los destinos
QT_NO_COLLECT_BUILD_TREE_APK_DEPS	Evita la recopilación de objetivos de bibliotecas compartidas creados por el proyecto durante la implementación de Android
QT_NO_COLLECT_IMPORTED_TARGET_APK_DEPS	Evita la recopilación de objetivos importados durante la implantación de Android
QT_NO_SET_XCODE_BUNDLE_IDENTIFIER	Desactiva la provisión de un ID de paquete de aplicaciones de reserva durante la finalización de objetivos en iOS.
QT_NO_SET_XCODE_DEVELOPMENT_TEAM_ID	Desactiva la provisión de un ID 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 por objetivo

`Qt6::InterfaceFramework`

IFCODEGEN_VERBOSE	Habilitar el registro detallado para todas las funciones de ifcodegen
QT_IFCODEGEN_TEMPLATE_SEARCH_PATH	Ruta de búsqueda de plantillas ifcodegen

`Qt6::Multimedia`

QT_NO_FFMPEG_XCODE_EMBED_FRAMEWORKS_CODE_SIGN_ON_COPY

Desactiva la firma de código FFmpeg en iOS

`Qt6::Qml`

QT_QMLLINT_CONTEXT_PROPERTY_DUMP	Habilita el volcado de propiedades de contexto en objetivos lint
QT_QML_GENERATE_AOTSTATS	Controla si está activada la recopilación de estadísticas del compilador QML
QT_QML_GENERATE_QMLLS_INI	Activa la autogeneración 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_OUTPUT_DIRECTORY	Directorio de salida base bajo el que se crearán los módulos QML por defecto

Variables CMake estándar

CMAKE_AUTOGEN_BETTER_GRAPH_MULTI_CONFIG

Mejora el gráfico de dependencias para generadores multi-configuración

Referencia de comandos CMake Referencia de propiedades CMake

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