En esta página

Uniéndolo todo con CMake

Al crear módulos QML, CMake proporciona la infraestructura necesaria para registrar correctamente los tipos QML, generar los metadatos necesarios y garantizar que el módulo se empaquete e implemente correctamente. Esta página describe el flujo de trabajo recomendado.

Uso de qt_add_qml_module

El comando qt_add_qml_module es la forma estándar y recomendada de crear módulos QML. Se encarga de todos los detalles complejos de la creación de módulos QML:

qt_add_qml_module(my_qml_module
    URI MyModule
    QML_FILES
        MyType.qml
        AnotherType.qml
    SOURCES
        mytype.cpp mytype.h
)

Este único comando

  • Crea el objetivo del módulo
  • Registra tipos QML a partir de archivos C++ y QML
  • Genera un archivo qmldir
  • Maneja el registro de tipos
  • Establece rutas de importación adecuadas
  • Habilita el soporte de herramientas QML(qmllint, qmlls, etc.)

Adición de otros archivos QML

Para los archivos QML añadidos después de la llamada inicial a qt_add_qml_module, utilice qt_target_qml_sources:

qt_target_qml_sources(my_qml_module
    QML_FILES
        DynamicallyAddedType.qml
)

Esto puede hacerse en función de la plataforma, la configuración u otros factores.

Referencia detallada de CMake

Para obtener detalles completos sobre todos los comandos, propiedades, variables y políticas de CMake, consulte Integración de CMake para QML.

Véase también Módulos QML y qt_add_qml_module.

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