Integración CMake para QML

Qt proporciona una amplia integración con CMake para crear módulos y aplicaciones QML.

Comandos CMake básicos

qt_add_qml_module

El comando qt_add_qml_module es la función principal para crear módulos QML en CMake. Maneja el registro de tipos QML, la incrustación de recursos, la creación de plugins y la integración con el sistema de compilación de Qt, proporcionando 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 existente. Resulta útil para organizar módulos de gran tamaño o 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 normalmente gestiona la creación de plugins de forma automática, esta función proporciona un control de nivel inferior cuando es necesario.

Comandos de despliegue

qt_deploy_qml_imports

El comando qt_deploy_qml_imports identifica y despliega todas las importaciones QML utilizadas por la aplicación, incluidas sus dependencias. Esto garantiza que todos los módulos y plugins QML necesarios se empaqueten con la aplicación.

qt_generate_deploy_qml_app_script

El comando qt_generate_deploy_qml_app_script genera una secuencia de comandos de implementación específica de la plataforma que se encarga de copiar los módulos QML, los plugins y otros recursos en las ubicaciones correctas 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 plugins QML se vinculen correctamente a las aplicaciones construidas estáticamente, generando el código de inicialización necesario para registrar los plugins con el motor QML.

Comandos avanzados

qt_generate_foreign_qml_types

El comando qt_generate_foreign_qml_types crea registros de tipos QML para tipos 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 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 la compilación de archivos QML a C++ utilizando qmltc(el compilador de tipos QML). Esto proporciona una alternativa a la instanciación basada en componentes con un rendimiento mejorado para los tipos QML conocidos estáticamente.

Variables y propiedades CMake

Qt Qml proporciona varias variables y propiedades CMake para configurar el comportamiento de los módulos QML:

Variables globales

Lasvariables globales de CMake en Qt6 Qml controlan el comportamiento predeterminado de todos los módulos QML del proyecto. 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 en todo el proyecto.

Propiedades globales

Laspropiedades globales de CMake en Qt6 Qml afectan a la forma en que el sistema de compilación procesa los módulos QML y se pueden utilizar para personalizar aspectos como la organización del destino del linter y la generación de código durante la compilación.

Propiedades del archivo fuente

CMake Source File Properties en Qt6 Qml permiten un control detallado sobre los archivos QML individuales dentro de un módulo. Puede utilizar estas propiedades para marcar archivos como singletons, excluirlos de los pasos de compilación, especificar nombres de tipo personalizados o controlar otros comportamientos por archivo en el sistema de tipos QML.

Políticas CMake

Qt Qml define varias políticas CMake para controlar la compatibilidad con versiones anteriores y el comportamiento.

Políticas de CMake para QML

La página Políticas CMake para QML proporciona una visión general de todas las políticas CMake relacionadas con QML y cómo afectan al comportamiento de los módulos. Las políticas le permiten optar por nuevos comportamientos manteniendo la compatibilidad con los proyectos existentes.