En esta página

Inicialización de la QML Runtime

Los documentos QML son cargados y ejecutados por el QML Runtime. Este Runtime también proporciona acceso a otros módulos y tipos Qml de Qt o de terceros.

Además, el marco Qt proporciona la herramienta « qml », que carga archivos « .qml ». Esta herramienta resulta útil para desarrollar y probar código QML sin tener que escribir una aplicación en C++ para cargar el QML Runtime.

Para ejecutar una aplicación que utilice QML, esta debe invocar el QML Runtime. Para invocar el QML Runtime:

  • Crea una aplicación Qt en C++.

    La aplicación debe cargar el « QQmlEngine » de una de las siguientes formas:

  • Crea una aplicación de Qt Bridge.

    Para más detalles, consulta la documentación de Qt Bridge:

  • Utilice la herramienta « qml » para cargar y ejecutar archivos QML directamente.

    Esta herramienta resulta útil para desarrollar y probar código QML sin tener que escribir una aplicación que cargue el QML Runtime. Para obtener más información, consulta «Creación de prototipos con la herramienta QML Runtime ».

Inicialización de « QML Runtime » en aplicaciones C++

Inicialización con QQuickView

QQuickView es una clase basada en « QWindow » que puede cargar archivos QML. Por ejemplo, si hay un archivo QML, application.qml, tendrá este aspecto:

import QtQuick

Rectangle { width: 100; height: 100; color: "red" }

Se puede cargar en un archivo ` main.cpp ` de una aplicación Qt de la siguiente manera:

#include <QGuiApplication>
#include <QQuickView>

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    QQuickView view;
    view.setSource(QUrl::fromLocalFile("application.qml"));
    view.show();

    return app.exec();
}

Esto crea una vista basada en ` QWindow` que muestra el contenido de application.qml.

Archivos de compilación

Utiliza el comando « find_package() » para localizar el componente del módulo que necesitas en el paquete « Qt6 »:

find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)

Para obtener más información, consulta la descripción general de «Compilar con CMake ».

Para configurar el módulo para su compilación con qmake, añada el módulo como valor de la variable QT en el archivo .pro del proyecto:

QT += quick

Para obtener más información, consulta Creación de archivos de proyecto.

Creación directa de un QQmlEngine

Si application.qml no contiene ningún componente gráfico, o si se prefiere evitar QQuickView por otros motivos, se puede crear directamente el QQmlEngine. En este caso, application.qml se carga como una instancia de QQmlComponent en lugar de colocarse en una vista:

#include <QGuiApplication>
#include <QQmlEngine>
#include <QQmlContext>
#include <QQmlComponent>

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    QQmlEngine engine;
    QQmlContext *objectContext = new QQmlContext(engine.rootContext());

    QQmlComponent component(&engine, "application.qml");
    QObject *object = component.create(objectContext);

    // ... delete object and objectContext when necessary

    return app.exec();
}

Si no utilizas ningún elemento gráfico de Qt Quick, puedes sustituir QGuiApplication por QCoreApplication en el código anterior. De esta forma, podrás utilizar QML como lenguaje sin ninguna dependencia del Qt GUI módulo.

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