Qt Qml
El módulo « Qt Qml » proporciona un marco para desarrollar aplicaciones y bibliotecas con el lenguaje QML. Define e implementa el lenguaje y la infraestructura del motor, y ofrece una API que permite a los desarrolladores de aplicaciones registrar tipos y módulos QML personalizados e integrar código QML con JavaScript y C++. El módulo « Qt Qml » proporciona tanto un « QML API » como un « C++ API ».
Uso del módulo
API de QML
Los tipos QML del módulo están disponibles a través de la importación QtQml. Para utilizar los tipos, añade la siguiente instrucción de importación a tu archivo .qml:
import QtQmlEl módulo Qt Qml contiene el marco de trabajo de QML y los tipos QML importantes que se utilizan en las aplicaciones. Las construcciones de QML se describen en la Referencia de QML.
QML API La API de QML del módulo Qt Qml proporciona varios tipos de objetos QML, tipos de valores QML y espacios de nombres.
API de C++
Para utilizar la API de C++ de un módulo de Qt es necesario enlazar con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación ofrecen soporte específico para ello, entre ellas CMake y qmake.
La API de C++ contiene algunas clases importantes con las que deberías familiarizarte. También proporciona tipos para almacenar valores de JavaScript.
Compilación con CMake
Utiliza el comando « find_package() » para localizar el componente del módulo necesario en el paquete « Qt6 »:
find_package(Qt6 REQUIRED COMPONENTS Qml)
target_link_libraries(mytarget PRIVATE Qt6::Qml)Para obtener más detalles, consulta la descripción general de «Compilación con CMake ».
Para proporcionar compatibilidad con tipos QML externos para una biblioteca que no sea de QML, localice el módulo « QmlIntegration » de la siguiente manera:
find_package(Qt6 REQUIRED COMPONENTS QmlIntegration)
target_link_libraries(mytarget PRIVATE Qt6::QmlIntegration)Consulte qt_generate_foreign_qml_types() para obtener más detalles.
Compilación con qmake
Para configurar el módulo para la compilación con qmake, añada el módulo como valor de la variable QT en el archivo .pro del proyecto:
QT += qmlRegistro de tipos y módulos QML
Para registrar tipos para su uso con QML, primero debes definir un módulo QML, preferiblemente utilizando qt_add_qml_module() en CMake. A continuación, puedes añadir encabezados de C++ a tu nuevo módulo y definir en ellos los tipos que se van a exponer a QML.
Ajuste del motor
Existen varios parámetros que puedes ajustar para personalizar el comportamiento del motor QML. La página sobre la configuración del motor JavaScript enumera las variables de entorno que puedes utilizar para este fin. La descripción de la caché de disco de QML detalla las opciones relacionadas con la forma en que se compilan y cargan tus componentes QML.
Artículos y guías
Estos artículos contienen información sobre Qt Qml.
Referencia
Licencias y atribuciones
Qt Qml está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo licencias de software libre. Desde Qt 5.4, estas licencias de software libre son la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Consulta Licencias de Qt para obtener más detalles.
Por otra parte, Qt Qml en Qt 6.12.0 puede contener módulos de terceros bajo las siguientes licencias permisivas:
Licencia BSD «simplificada» de 2 cláusulas |
© 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.