使用QML_ELEMENT/QML_SINGLETON时QML无法识别库中C++自定义类型

问题核心在于静态库中Qt自动生成的QML类型注册代码未被链接到主程序。链接器会默认剔除静态库中未被显式引用的符号，而Qt为QML_ELEMENT/QML_SINGLETON自动生成的qml_register_types_*函数属于这类未被引用的符号，最终导致QML引擎无法识别自定义类型。

以下是两种可靠的修复方案：

方案一：显式触发类型注册 #

通过在静态库中添加初始化函数，强制引用注册代码，确保链接器保留相关符号：

1. 在logicmodule目录下创建logicmodule_init.h：

#pragma once

void init_logicmodule();

2. 同目录创建logicmodule_init.cpp：

#include "logicmodule_init.h"
// 引用Qt自动生成的模块注册函数（命名规则：qml_register_types_<URI>）
extern void qml_register_types_Main();

void init_logicmodule() {
    qml_register_types_Main();
}

3. 修改logicmodule/CMakeLists.txt，将新文件加入编译：

qt6_add_qml_module(${PROJECT_NAME}
    URI Main
    VERSION 1.0
    NO_PLUGIN
    RESOURCE_PREFIX "/qt/qml"
    QML_FILES
        Main.qml
    SOURCES
        MySingleton.h
        Message.h
        logicmodule_init.h  # 添加此行
        logicmodule_init.cpp # 添加此行
)

4. 在主程序main.cpp中，加载QML前调用初始化函数：

#include "logicmodule_init.h"

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

    // ...（原有连接信号代码不变）

    engine.addImportPath(QCoreApplication::applicationDirPath() + "/qml");
    engine.addImportPath(":/");

    // 新增：初始化静态库的QML类型注册
    init_logicmodule();

    engine.load(url);

    // ...（原有错误检查代码不变）
    return app.exec();
}

方案二：强制链接静态库所有符号 #

通过CMake配置，让链接器保留静态库的全部符号（无需修改代码，适合快速修复）：

修改根目录CMakeLists.txt中的target_link_libraries部分，针对不同编译器添加强制链接参数：

针对GCC/Clang： #

target_link_libraries(apptypetest PUBLIC
    $<$<STREQUAL:$<TARGET_PROPERTY:logicmodule,TYPE>,STATIC_LIBRARY>:-Wl,--whole-archive>
    logicmodule
    $<$<STREQUAL:$<TARGET_PROPERTY:logicmodule,TYPE>,STATIC_LIBRARY>:-Wl,--no-whole-archive>
)

针对MSVC： #

target_link_libraries(apptypetest PUBLIC
    $<$<STREQUAL:$<TARGET_PROPERTY:logicmodule,TYPE>,STATIC_LIBRARY>:/WHOLEARCHIVE:logicmodule>
    $<$<NOT:$<STREQUAL:$<TARGET_PROPERTY:logicmodule,TYPE>,STATIC_LIBRARY>>:logicmodule>
)

补充说明 #

• 当所有文件放在根目录时，注册代码属于可执行程序的一部分，链接器不会剔除，因此可以正常工作；而静态库中无显式引用时，注册代码会被优化丢弃。
• 你的qt6_add_qml_module配置中NO_PLUGIN和RESOURCE_PREFIX的设置是正确的，符合静态库场景的要求。

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