En esta página

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 QtQml

El 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 += qml

Registro 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:

JavaScriptCore Macro Assembler

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.