Compilación de un módulo QML reutilizable
El ejemplo siguiente muestra cómo crear una biblioteca que exponga C++ a QML. La estructura de directorios del ejemplo es la siguiente:
├── CMakeLists.txt
└── example
└── mylib
├── CMakeLists.txt
├── mytype.cpp
├── mytype.hEl archivo de nivel superior CMakeLists.txt realiza una configuración básica mediante qt_standard_project_setup() y, a continuación, utiliza add_subdirectory para incluir el de mylib:
cmake_minimum_required(VERSION 3.16)
project(qmlmodule VERSION 1.0.0 LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
find_package(Qt6 REQUIRED COMPONENTS Qml)
qt_standard_project_setup(REQUIRES 6.5)
add_subdirectory(example/mylib)Los subdirectorios están estructurados de forma que se correspondan con el URI del módulo QML, pero sustituyendo los puntos por barras. Esa es la misma lógica que utiliza el motor cuando busca un módulo en las rutas de importación. Seguir esta estructura de subdirectorios facilita el uso de las herramientas.
mytype.h Declara una clase y utiliza las macros de registro declarativo para exponerla al motor.
En el archivo ` CMakeLists.txt ` del subdirectorio llamamos a ` qt_add_qml_module()`. En comparación con «Compilación de una aplicación QML», la llamada es ligeramente diferente:
qt_add_qml_module(mylib
URI example.mylib
VERSION 1.0
SOURCES
mytype.h mytype.cpp
QML_FILES
MyQmlType.qml
)El objetivo de « mylib » no se ha creado previamente. Cuando el objetivo pasado a ` qt6_add_qml_module ` no existe, se crea automáticamente un objetivo de biblioteca. Esto evita una llamada separada a `qt_add_library()`. Para registrar tipos QML definidos en C++, añade sus archivos de cabecera y fuente como argumentos al parámetro `SOURCES`.
Al compilar el proyecto, además de la biblioteca, también se compila un complemento QML. La clase generada automáticamente por el complemento hereda de ` QQmlEngineExtensionPlugin`. La propia biblioteca `mylib` ya contiene el código para registrar los tipos en el motor. Sin embargo, esto solo resulta útil en los casos en los que podemos vincular con la biblioteca. Para que el módulo se pueda utilizar en un archivo QML cargado por qml, la herramienta «QML Runtime », se necesita un complemento que se pueda cargar. El complemento se encarga entonces de vincularse realmente a la biblioteca y de garantizar que los tipos queden registrados.
Ten en cuenta que la generación automática del complemento solo es posible si el módulo no hace nada más que registrar los tipos. Si necesita realizar alguna tarea más avanzada, como registrar un proveedor de imágenes en initializeEngine, tendrás que escribir el complemento manualmente. qt_add_qml_module() admite esta función con NO_GENERATE_PLUGIN_SOURCE.
Además, seguir la convención de estructura de directorios facilita el uso de las herramientas. Esa estructura se refleja en el directorio de compilación. Esto significa que puedes pasar la ruta a tu directorio de compilación a la herramienta QML (mediante el indicador -I ), y esta encontrará el complemento.
© 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.