无IDE用CMake构建QML应用时QQmlApplicationEngine加载失败问题

1. 问题解决方法及原因 #

原因分析 #

从错误日志可见，QML引擎尝试加载UI模块的UIplugin插件，但该插件不存在。尽管你在UI模块中添加了NO_PLUGIN选项，但依赖的OtherQML1~4子模块默认会生成插件（未添加NO_PLUGIN），导致QML引擎判定整个UI模块体系需要插件支持，进而触发找不到插件的错误。此外，当前路径映射配置虽生成了资源别名，但因插件依赖的误解，引擎无法正确解析纯QML模块。

解决步骤 #

• 给所有纯QML子模块添加NO_PLUGIN：在OtherQML1~4每个目录的CMakeLists.txt中，修改qt_add_qml_module指令，添加NO_PLUGIN选项，示例：

  qt_add_qml_module(OtherQML1
      URI OtherQML1
      NO_PLUGIN
      VERSION 1.0
      QML_FILES
          # 你的QML文件列表
  )
  

  这会告知Qt这些模块仅包含QML文件，无C++插件。

• 验证模块资源链接：确保主程序App通过target_link_libraries(App PRIVATE UI)正确链接UI模块，这样UI及其依赖子模块的QML资源会自动嵌入可执行文件（或通过资源路径映射被引擎找到）。

• 清理并重新构建：删除build目录，重新运行CMake配置和构建命令，确保所有模块配置生效。

完成以上步骤后，QML引擎会正确识别纯QML模块，不再尝试加载不存在的插件，从而成功加载Main.qml。

2. Qt资源系统（qrc）相关说明 #

• qrc:/qt/qml路径：这是Qt内置的资源路径，专门存放Qt官方提供的QML模块（如QtQuick、QtQuick.Controls等），属于Qt安装包自带内容，无需用户手动维护。

• 将自定义模块放入qrc:/qt/qml：使用qt_add_qml_module时，添加RESOURCE_PREFIX "/qt/qml"参数，CMake会自动将模块的QML文件和资源打包到qrc:/qt/qml/[模块URI]路径下。例如：

  qt_add_qml_module(UI
      URI UI
      NO_PLUGIN
      VERSION 1.0
      RESOURCE_PREFIX "/qt/qml"
      QML_FILES
          Main.qml
  )
  

  这样QML引擎会自动从该路径查找你的模块，无需额外设置导入路径。

• 路径选择建议：

  • 开发阶段：依赖Qt CMake工具自动生成的路径映射（如UI_qml_module_dir_map.qrc）即可，无需手动创建自定义路径。
  • 安装部署：qt_generate_deploy_qml_app_script会自动处理模块部署，要么将模块文件复制到可执行文件附近的标准路径，要么嵌入到资源中，确保运行时可被找到。无需手动创建相对于构建/安装目录的自定义路径，除非有特殊需求。

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