如何在不设为子项目的情况下接入静态Qt模块？

问题背景 #

在无QML模块源码访问权限的前提下，将静态构建的Quick2ExtensionPlugin（TestP）链接到Qt6应用TestApp时，仅能正常使用插件中的C++类MyItem，但QML组件MyItemControls始终加载失败，报错qrc:/TestP/MyItemControls.qml: no such file or directory或MyItemControls is not an item。已尝试复制库文件、链接静态库、导入插件、设置QML输出目录等操作，均未解决QML组件加载问题。

核心原因 #

静态构建的QML模块中，QML组件文件不会自动嵌入主程序资源系统，且静态构建模式下QML引擎优先从资源路径查找模块，无法通过普通文件路径直接加载。

解决步骤 #

1. 准备插件资源文件 #

从TestP的构建产物中，完整复制包含qmldir、MyItemControls.qml的TestP文件夹，放置到TestApp项目根目录的3rdparty/qml/TestP路径下。

2. 嵌入插件QML资源到主程序 #

• 在TestApp中新建资源文件qml_plugins.qrc，内容如下：

<RCC>
    <qresource prefix="/">
        <file>3rdparty/qml/TestP/qmldir</file>
        <file>3rdparty/qml/TestP/MyItemControls.qml</file>
    </qresource>
</RCC>

• 在TestApp的CMakeLists.txt中添加该资源文件到编译目标：

qt_add_resources(TestApp "qml_plugins"
    PREFIX "/"
    FILES
        qml_plugins.qrc
)

3. 确保静态插件的链接与导入 #

• 保留原有链接配置，在CMakeLists.txt中指定TestP静态库的路径并链接：

# 指定静态库所在目录
target_link_directories(TestApp PRIVATE ${PATH_TO_TESTP_LIBS})
# 链接静态库
target_link_libraries(TestApp PRIVATE TestP.lib TestPplugin.lib)

• 保留main.cpp中的插件导入代码：

Q_IMPORT_QML_PLUGIN(TestPPlugin)

注意：需要将TestP插件的头文件（如TestP_plugin.h）复制到TestApp的头文件搜索路径中，或在CMake中通过target_include_directories指定路径。

4. 配置QML引擎导入路径（可选） #

若仍加载失败，在main.cpp中手动添加QML模块查找路径，确保引擎能定位到TestP模块：

#include <QGuiApplication>
#include <QQmlApplicationEngine>

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

    QQmlApplicationEngine engine;
    // 添加资源路径作为QML导入路径
    engine.addImportPath("qrc:/");
    // 若同时将TestP文件夹复制到输出目录，可添加本地路径
    engine.addImportPath(QCoreApplication::applicationDirPath() + "/qml");

    Q_IMPORT_QML_PLUGIN(TestPPlugin);

    const QUrl url(u"qrc:/TestApp/Main.qml"_qs);
    QObject::connect(&engine, &QQmlApplicationEngine::objectCreated,
                     &app, [url](QObject *obj, const QUrl &objUrl) {
        if (!obj && url == objUrl)
            QCoreApplication::exit(-1);
    }, Qt::QueuedConnection);
    engine.load(url);

    return app.exec();
}

5. 验证qmldir文件有效性 #

确认TestP的qmldir文件包含正确的组件声明：

module TestP
plugin TestPplugin
MyItemControls 1.0 MyItemControls.qml

关键注意事项 #

• 静态构建模式下，QML引擎不会自动扫描文件系统中的模块，必须通过资源嵌入或手动添加导入路径让引擎识别
• 确保TestP的静态库、头文件、QML资源文件与TestApp使用的Qt版本完全一致，避免兼容性问题
• 无需将TestP作为子项目导入（无需add_subdirectory），仅需获取对应构建产物即可完成配置

内容的提问来源于stack exchange，提问作者Mars