【QT Quick】C++交互：加载QML代码

Qt 提供了多种方法来加载 QML 代码，可以根据需求选择文件路径、资源路径或网络路径等不同方式来加载 QML。下面我们来详细讲解这些方法及其适用场景。

路径支持

文件路径加载 QML

通过直接指定本地文件路径加载 QML 文件是最简单的方法之一。下面的代码演示了如何使用文件路径加载 QML：

QQmlApplicationEngine engine("qml/main.qml");

这种方式非常适合在开发过程中进行调试，因为您可以快速对 QML 文件进行修改和加载。但在发布应用程序时，文件路径可能不是最安全的选择，因为用户可能会轻易访问或修改这些文件。

资源路径加载 QML

将 QML 文件添加到 Qt 资源文件（.qrc）中并使用资源路径来加载，可以确保 QML 文件在应用程序发布时内嵌在应用中，防止被用户直接访问或修改。

QQmlApplicationEngine engine(QUrl(QStringLiteral("qrc:/main.qml")));

这种方法在应用程序的发布和分发中很常见，因为它确保了所有相关的 UI 文件都集成到一个应用程序包中，提供了更好的安全性和管理性。

网络路径加载 QML

如果您希望动态地从远程服务器加载 QML 文件，则可以使用网络路径的方式：

QQmlComponent component(&engine, QUrl("http://www.cpp.show/main.qml"));

这种方法适用于远程管理或动态更新 UI 场景，例如在线游戏或使用远程配置管理 UI 的应用程序。但这种方式需要保证网络的稳定性，并且可能需要处理网络延迟和加载失败的问题。

使用 QQmlComponent

QQmlComponent 是一个更底层的类，可以让您手动管理加载 QML 的过程，适合需要更灵活控制的场景。下面是一个基本示例：

QQmlEngine engine;
QQmlComponent component(&engine, QUrl(QStringLiteral("qrc:/main.qml")));
std::unique_ptr<QObject> ct(component.create());
ct->dumpObjectInfo();

在上述代码中，通过 QQmlComponent 来加载 QML 文件，并创建对象。与 QQmlApplicationEngine 相比，QQmlComponent 可以让开发者更精确地控制 QML 的加载和创建流程。

还可以手动设置 QML 数据，并在创建对象时动态生成 QML 代码：

QQmlEngine engine;
QQmlComponent component(&engine);
component.setData("import QtQuick 2.0\nText { text: \"Hello world!\" }", QUrl());
QQuickItem *item = qobject_cast<QQuickItem *>(component.create());

通过这种方式，可以在程序运行时动态创建 QML 对象。

手动控制对象生命周期

有时候，需要手动控制 QML 对象的加载和卸载。例如，在网络路径加载中，我们可能需要等待组件加载完成，并在加载成功后继续创建对象。

MyApplication::MyApplication()
{
    component = new QQmlComponent(engine, QUrl("http://www.cpp.show/main.qml"));
    if (component->isLoading()) {
        QObject::connect(component, &QQmlComponent::statusChanged, this, &MyApplication::continueLoading);
    } else {
        continueLoading();
    }
}

void MyApplication::continueLoading()
{
    if (component->isError()) {
        qWarning() << component->errors();
    } else {
        QObject *myObject = component->create();
    }
}

在这个例子中，通过监听 statusChanged 信号，确保在组件完成加载后执行后续操作。这样可以避免加载失败导致的空指针异常。

使用 QQuickView 加载 QML

QQuickView 提供了一种简单的方法来加载 QML，并且可以直接显示界面。它自动创建一个窗口，因此根对象通常不能是 Window 类型（会导致多个根窗口的错误）。

#include <QGuiApplication>
#include <QQuickView>

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

    QQuickView view;
    view.setSource(QUrl(QStringLiteral("qrc:/MyItem.qml")));
    view.show();

    return app.exec();
}

使用 QQuickView 时，开发者可以很方便地设置窗口大小、属性等，但需要注意它对根 QML 类型的要求。

使用QQmlApplicationEngine

QQmlApplicationEngine 是结合了 QQmlEngine 和 QQmlComponent 的功能，为开发者提供了更为简单的 API 来加载 QML 文件，并可以处理应用程序级别的 QML。

#include <QGuiApplication>
#include <QQmlApplicationEngine>

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

    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));

    if (engine.rootObjects().isEmpty())
        return -1;

    return app.exec();
}

接口及加载方法

• void load(const QUrl &url)：加载指定路径的 QML 文件。
• void load(const QString &filePath)：加载指定文件路径的 QML 文件。
• void loadData(const QByteArray &data, const QUrl &url = QUrl())：加载数据流中的 QML 文件内容。
• void loadFromModule(QAnyStringView uri, QAnyStringView typeName)：从模块中加载 QML。
• void setExtraFileSelectors(const QStringList &extraFileSelectors)：设置额外的文件选择器。
• void setInitialProperties(const QVariantMap &initialProperties)：设置 QML 对象的初始属性。

QQmlApplicationEngine 通常用于需要加载多个 QML 文件的场景，例如主界面和对话框分开存放的复杂应用程序。

总结

• 文件路径加载适合开发阶段快速调试。
• 资源路径加载适合发布应用时保护 QML 文件不被修改。
• 网络路径加载则为需要动态更新的场景提供了灵活性。
• QQmlComponent 可以用于更细粒度地控制加载和创建过程。
• QQuickView 适合快速搭建 UI 界面。
• QQmlApplicationEngine 则为应用程序级别的 QML 管理提供了简化的接口。