Windows平台下Qt RemoteObjects自动生成类的静态常量成员字段未定义引用问题

我之前也踩过一模一样的坑——Qt RemoteObjects自动生成的SOURCE/REPLICA类放到Windows共享库（DLL）后，外部程序使用信号槽时总会报staticMetaObject这类静态符号找不到的错误。WINDOWS_EXPORT_ALL_SYMBOLS和GenerateExportHeader对自动生成的代码基本没用，毕竟它们只能处理我们自己写的代码。下面是我摸索出来的两个亲测有效的解决方案：

方案1：给REPC类添加自定义导出宏（推荐） #

这个方法直接在REPC定义中注入导出宏，通过CMake控制编译时的宏值，让生成的类自动带上__declspec(dllexport)/dllimport修饰：

步骤1：修改REPC文件，添加导出宏 #

打开你的PanelInterface.rep，给类加上自定义导出宏（比如PANEL_INTERFACE_EXPORT）：

#include <QtCore>
#include <QString>
class PANEL_INTERFACE_EXPORT PanelInterface {
PROP(QString foo);
};

步骤2：在CMake中给共享库的REPC代码设置导出宏 #

生成REPC文件后，给它添加编译定义，把PANEL_INTERFACE_EXPORT指定为__declspec(dllexport)，这样编译共享库时会导出所有相关符号：

qt5_generate_repc(GENERATED PanelInterface.rep SOURCE)
set_source_files_properties(${GENERATED} PROPERTIES 
    GENERATED TRUE 
    SKIP_AUTOMOC TRUE
    COMPILE_DEFINITIONS "PANEL_INTERFACE_EXPORT=__declspec(dllexport)"
)

步骤3：给主程序设置导入宏 #

主程序编译时，把同一个宏指定为__declspec(dllimport)，让编译器知道要从DLL中导入符号：

add_executable(main main.cpp)
target_compile_definitions(main PRIVATE PANEL_INTERFACE_EXPORT=__declspec(dllimport))
target_link_libraries(main PUBLIC SampleProcedure)

这样处理后，Qt生成的PanelInterfaceSimpleSource类及其静态成员staticMetaObject就会被正确导出到DLL中，主程序链接时就能找到符号，信号槽连接也能正常工作了。

方案2：利用Qt预定义宏简化处理 #

如果你不想自己写宏名称，可以直接用Qt的Q_DECL_EXPORT和Q_DECL_IMPORT预定义宏：

1. 修改PanelInterface.rep：

#include <QtCore>
#include <QString>
class Q_DECL_EXPORT PanelInterface {
PROP(QString foo);
};

2. 在CMakeLists.txt中，给共享库target添加编译定义，让Q_DECL_EXPORT生效：

target_compile_definitions(SampleProcedure PRIVATE QT_SHARED)

主程序这边不需要额外定义，因为Qt在非DLL编译环境下会自动把Q_DECL_EXPORT解析为Q_DECL_IMPORT。

注意事项 #

• 确保REPC生成时宏定义已经生效，否则生成的代码会缺少导出修饰。
• 如果同时使用SOURCE和REPLICA类，只需要在rep文件中加一次宏，两边的生成代码都会自动继承导出/导入逻辑。

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