自定义QQmlExtensionPlugin：示例项目提示模块未安装

1. 修正qmldir文件内容 #

你的qmldir缺少版本声明与QML组件的类型映射，修改为：

module Clock 1.0
plugin clockplugin
type Clock 1.0 Clock.qml
type ClockBackground 1.0 ClockBackground.qml
type GenericClockHand 1.0 GenericClockHand.qml
type HourClockHand 1.0 HourClockHand.qml
type MinuteClockHand 1.0 MinuteClockHand.qml
type SecondClockHand 1.0 SecondClockHand.qml

说明：module Clock 1.0明确模块版本，与QML中的import Clock 1.0对应；type声明将QML文件映射为模块内可直接使用的类型。

2. 完善Plugin.cpp的实现 #

registerTypes函数缺少实现，即使无需注册C++类型，也需要空实现保证插件正常加载：

#include "ClockPlugin.h"
#include <QtQml>

void ClockPlugin::registerTypes(const char* uri)
{
    Q_ASSERT(QLatin1String(uri) == QLatin1String("Clock"));
    // 无需注册C++类型时，此处留空即可
}

3. 调整插件目录结构与部署路径 #

Qt加载QML模块要求目录结构规范：

• 示例项目build目录下需存在Clock子目录，目录内包含：
  • qmldir文件
  • clockplugin.dll插件二进制文件
  • 所有相关QML文件（Clock.qml、ClockBackground.qml等）
• 确保整个Clock目录被完整复制到示例项目可执行文件（.exe）的同级目录下。

4. 正确配置示例项目的QML导入路径 #

在示例项目的.pro文件中添加：

QML2_IMPORT_PATH += $$OUT_PWD/Clock

说明：$$OUT_PWD指向编译输出目录，若Clock目录在项目根目录下，可替换为$$PWD/Clock。

也可以在运行示例项目前设置系统环境变量：

set QML2_IMPORT_PATH=路径\到\Clock目录的父目录

注意：环境变量需指向Clock目录的父目录，而非Clock目录本身。

5. 优化插件编译配置 #

修改插件项目的.pro文件，简化部署逻辑，避免资源冲突：

TEMPLATE = lib
CONFIG += plugin
QT += quick qml

DESTDIR = ../Clock
TARGET = clockplugin

SOURCES += \
        src/ClockPlugin.cpp

# 插件项目无需main.cpp，移除冗余编译项
# SOURCES += src/main.cpp

HEADERS += \
    src/ClockPlugin.h

# 若通过qmldir直接加载QML文件，可移除qml.qrc避免资源重复
# RESOURCES += qml/qml.qrc

DISTFILES += \
    qml/Clock/qmldir

# 直接将QML文件和qmldir复制到输出目录
QML_FILES = qml/Clock/*.qml
COPIES += qml_files
qml_files.files = $$QML_FILES qml/Clock/qmldir
qml_files.path = $$DESTDIR

6. 验证插件加载状态 #

在示例项目中添加调试代码，查看QML模块搜索路径：

import QtQuick 2.15
import QtQuick.Window 2.15
import QtQml 2.15
import Clock 1.0

Window {
    width: 640
    height: 480
    visible: true
    title: qsTr("Hello World")

    Component.onCompleted: {
        console.log("QML Import Paths:", Qt.qmlEngine(this).importPathList());
    }

    Clock {
        id: clock
        anchors.centerIn: parent
    }
}

运行后查看控制台输出，确认Clock目录的父目录是否在导入路径列表中。

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