Integración de CMake para QML
Qt ofrece una amplia integración con CMake para compilar módulos y aplicaciones Qml.
Comandos básicos de CMake
qt_add_qml_module
El comando qt_add_qml_module es la función principal para crear módulos QML en CMake. Se encarga del registro de tipos QML, la incrustación de recursos, la creación de complementos y la integración con el sistema de compilación de Qt, lo que proporciona una forma declarativa de definir todos los aspectos de un módulo QML.
qt_target_qml_sources
El comando qt_target_qml_sources añade archivos y recursos QML a un objetivo de módulo QML ya existente. Esto resulta útil para organizar módulos de gran tamaño o para incluir archivos QML de forma condicional en función de la configuración de compilación.
qt_add_qml_plugin
El comando qt_add_qml_plugin crea una biblioteca de complementos QML que el motor QML puede cargar dinámicamente. Aunque qt_add_qml_module suele encargarse automáticamente de la creación de complementos, esta función ofrece un control de más bajo nivel cuando es necesario.
Comandos de implementación
qt_deploy_qml_imports
El comando qt_deploy_qml_imports identifica e implementa todas las importaciones QML utilizadas por tu aplicación, incluidas sus dependencias. Esto garantiza que todos los módulos y complementos QML necesarios se incluyan en el paquete de tu aplicación.
qt_generate_deploy_qml_app_script
El comando qt_generate_deploy_qml_app_script genera un script de implementación específico para cada plataforma que se encarga de copiar los módulos QML, los complementos y otros recursos a las ubicaciones correctas dentro del paquete de la aplicación o del directorio de instalación.
qt_import_qml_plugins
El comando qt_import_qml_plugins garantiza que los complementos QML se enlacen correctamente en aplicaciones compiladas de forma estática, generando el código de inicialización necesario para registrar los complementos en el motor QML.
Comandos avanzados
qt_generate_foreign_qml_types
El comando qt_generate_foreign_qml_types crea registros de tipos QML para los tipos de C++ definidos en otras bibliotecas o módulos. Esto permite exponer tipos de terceros o de Qt a QML sin modificar su código fuente.
qt_query_qml_module
El comando qt_query_qml_module recupera información sobre un módulo QML, como su URI, versión, destino del complemento y rutas de los archivos de información de tipos. Esto resulta útil para la introspección del sistema de compilación y la integración de herramientas.
qt_target_compile_qml_to_cpp
El comando qt_target_compile_qml_to_cpp permite compilar archivos QML a C++ utilizando qmltc(el compilador de tipos QML). Esto ofrece una alternativa a la instanciación basada en componentes con un rendimiento mejorado para los tipos QML conocidos de forma estática.
qt_add_qml_preview
El comando qt_add_qml_preview configura la compatibilidad con la recarga en tiempo real de qmlpreview para un objetivo ejecutable que carga QML desde uno o más objetivos qt_add_qml_module, pero que no es en sí mismo un módulo QML. Crea un objetivo de compilación adicional « <target>_qmlpreview » que se puede utilizar para previsualizar los archivos QML del ejecutable.
Variables y propiedades de CMake
Qt Qml Ofrece varias variables y propiedades de CMake para configurar el comportamiento de los módulos QML:
Variables globales
Las variables globales de CMake en Qt6 QML controlan el comportamiento predeterminado de todos los módulos QML del proyecto. Entre ellas se incluyen variables para los directorios de salida, la generación de archivos de caché y la integración de herramientas, lo que permite configurar los ajustes de compilación de QML a nivel de todo el proyecto.
Propiedades globales
Las propiedades globales de CMake en Qt6 Qml influyen en cómo el sistema de compilación procesa los módulos QML y pueden utilizarse para personalizar aspectos como la organización de los objetivos del linter y la generación de código en tiempo de compilación.
Propiedades de los archivos fuente
Las propiedades de los archivos fuente de CMake en Qt6 QML permiten un control minucioso sobre archivos QML individuales dentro de un módulo. Puedes utilizar estas propiedades para marcar archivos como singletons, excluirlos de los pasos de compilación, especificar nombres de tipos personalizados o controlar otros comportamientos específicos de cada archivo en el sistema de tipos de QML.
Propiedades de los objetivos
Las propiedades de objetivos de CMake en Qt6 QML te permiten ajustar con precisión el comportamiento de objetivos individuales; por ejemplo, para excluir a un objetivo de un comportamiento que, de otro modo, estaría habilitado para él en todo el proyecto, como la creación automática del objetivo «qmlpreview ».
Políticas de CMake
Qt Qml Se definen varias políticas de CMake para controlar la compatibilidad con versiones anteriores y el comportamiento.
Políticas de CMake para QML
La página «Políticas de CMake para QML» ofrece una visión general de todas las políticas de CMake relacionadas con QML y de cómo afectan al comportamiento de los módulos. Las políticas te permiten activar nuevos comportamientos al tiempo que se mantiene la compatibilidad con los proyectos existentes.
Véase también Módulos QML, qt_add_qml_module y Cómo escribir módulos QML.
© 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.