QT5.15+Qmake环境下自定义QML模块无法导入问题求助

在QT5.15+Qmake环境中导入自定义QML模块时，触发module is not installed错误。目前仅能通过在main.cpp中调用qmlRegisterSingletonType函数解决问题，但希望通过qmldir配置实现模块导入。

项目结构 #

<ProjectRoot>
  |-- frontend/
      |-- AlphaQ/
          |-- Styles/
              |-- Style1.0.qml
              |-- qmldir
          |-- Themes/
              |-- Themes1.0.qml
              |-- qmldir
      |-- main.qml
      |-- Home.qml
      |-- Home.js
      |-- qtquickcontrols2.conf
  |-- src/
      |-- main.cpp
  |-- qml.qrc

配置文件内容 #

qml.qrc #

<RCC>
    <qresource prefix="/frontend">
        <file>main.qml</file>
        <file>Home.qml</file>
        <file>Home.js</file>
        <file alias="qtquickcontrols2.conf">qtquickcontrols2.conf</file>
        <file alias="icons/send40x40.png">icons/send40x40.png</file>
        <file>AlphaQ/Styles/Style1.0.qml</file>
        <file>AlphaQ/Themes/Themes1.0.qml</file>
        <file>AlphaQ/Themes/qmldir</file>
        <file>AlphaQ/Styles/qmldir</file>
    </qresource>
</RCC>

frontend/AlphaQ/Styles/qmldir #

module AlphaQ.Styles
singleton Style 1.0 Style1.0.qml

frontend/AlphaQ/Themes/qmldir #

module AlphaQ.Themes
singleton Themes 1.0 Themes1.0.qml

main.qml导入语句 #

import QtQuick 2.15
import QtQuick.Window 2.15

import AlphaQ.Styles 1.0

已尝试方案 #

• 在main.cpp中调用engine.addImportPath设置导入路径
• 在QRC中设置prefix为AlphaQ.Styles
• 在.pro文件中设置QML_IMPORT_PATH = $$PWD\frontend\

解决方案 #

1. 调整.pro文件配置
   在项目的.pro文件中添加以下配置，确保Qmake能识别模块目录：

   QML_IMPORT_PATH += $$PWD/frontend
   RESOURCES += qml.qrc
   

2. 修正QRC的prefix设置
   将QRC的prefix改为/frontend（如上述qrc示例），确保模块目录AlphaQ处于/frontend资源路径下，让QML引擎能正确遍历到qmldir文件。

3. 在main.cpp中添加资源导入路径
   在初始化QML引擎时，将资源中的frontend路径加入导入路径：

   #include <QGuiApplication>
   #include <QQmlApplicationEngine>
   
   int main(int argc, char *argv[])
   {
       QGuiApplication app(argc, argv);
   
       QQmlApplicationEngine engine;
       // 添加资源中的模块根路径
       engine.addImportPath("qrc:/frontend");
       const QUrl url(u"qrc:/frontend/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();
   }
   

4. 验证模块导入
   重新构建项目，此时QML引擎会通过qrc:/frontend/AlphaQ/Styles/qmldir识别AlphaQ.Styles模块，无需再调用qmlRegisterSingletonType即可正常导入。

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