如何在Visual Studio中使用wxWidgets创建带窗口的DLL程序？

前置准备 #

• 先编译对应VS版本的wxWidgets库，务必选择DLL模式，注意匹配Debug/Release、x86/x64架构
• 配置VS项目属性：
  • VC++目录 → 包含目录：添加wxWidgets的include和include\msvc路径
  • VC++目录 → 库目录：添加wxWidgets编译输出的lib\vc_x64_dll（对应你的架构和编译模式）路径
  • 链接器 → 输入 → 附加依赖项：Debug模式添加wxbase32ud.lib wxmsw32ud_core.lib，Release模式去掉后缀d

核心项目结构与代码示例 #

1. 创建空DLL项目 #

在VS中新建空DLL项目，添加以下文件：

wx_dll.h（导出头文件）

#ifndef WX_DLL_H
#define WX_DLL_H

#ifdef WX_DLL_EXPORTS
#define WX_DLL_API __declspec(dllexport)
#else
#define WX_DLL_API __declspec(dllimport)
#endif

WX_DLL_API void ShowWxWindow();

#endif // WX_DLL_H

wx_dll.cpp（实现文件）

#define WX_DLL_EXPORTS
#include "wx_dll.h"
#include <wx/wx.h>

class MyApp : public wxApp
{
public:
    virtual bool OnInit();
};

WX_DLL_API void ShowWxWindow()
{
    static wxAppConsole* app = wxApp::GetInstance();
    if (!app)
    {
        wxEntryStart(0, nullptr);
        new MyApp();
        wxTheApp->CallOnInit();
    }

    wxFrame* frame = new wxFrame(nullptr, wxID_ANY, L"wxWidgets DLL Window", wxDefaultPosition, wxSize(400, 300));
    frame->Show(true);
}

bool MyApp::OnInit()
{
    return true;
}

// DLL中禁用自动wxApp初始化，改用手动控制
wxIMPLEMENT_APP_NO_MAIN(MyApp);

2. 关键注意事项 #

• wxApp初始化：DLL中不能用wxIMPLEMENT_APP，必须用wxIMPLEMENT_APP_NO_MAIN，手动调用wxEntryStart和wxTheApp->CallOnInit()，避免与宿主程序的wxApp冲突
• 字符集设置：VS项目属性中设为Unicode字符集，与wxWidgets默认一致
• 运行时库：确保wxWidgets编译时的运行时库（MD/MDd）和VS项目的运行时库完全匹配，否则会出现链接或运行错误
• 资源处理：若DLL需使用wxWidgets资源（如图标），需在项目中添加资源文件，或初始化时指定资源路径

测试DLL #

新建VS控制台项目，添加DLL引用：

• 包含wx_dll.h的路径
• 链接器附加依赖项添加wx_dll.lib
• 将编译好的wx_dll.dll及wxWidgets配套DLL（如wxbase32u.dll、wxmsw32u_core.dll）放到控制台程序的输出目录

测试代码：

#include "wx_dll.h"

int main()
{
    ShowWxWindow();
    wxEventLoop loop;
    loop.Run();
    return 0;
}

常见问题排查 #

• LNK2019链接错误：检查库目录、附加依赖项是否匹配当前编译模式（Debug/Release、x86/x64）
• 运行时崩溃：确认运行时库一致，wxWidgets DLL与程序架构匹配
• 窗口不显示：检查是否正确初始化wxApp，以及窗口是否调用Show(true)

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