如何重写WinUI 3.0桌面应用Start入口点以控制消息泵

核心原理说明 #

• 默认WinUI 3项目的程序入口确实是wWinMain，你在项目代码里找不到对应定义，是因为Windows App SDK的生成任务会在编译阶段自动注入默认入口代码，文件存放在项目的obj生成目录下。自动生成的入口内部会完成XAML运行时初始化、元数据注册、静态对象构造，之后调用框架基类的Application.Start方法进入默认消息循环。
• 你直接在Application子类中重写静态Start方法无效，是因为C++/WinRT的静态方法不支持虚分发，自动生成的入口代码是硬编码调用基类Microsoft::UI::Xaml::Application::Start，和你子类定义的同名静态方法不存在绑定关系，自然不会执行你的逻辑。
• 不要直接通过修改链接器选项替换入口点，相关资料的描述是准确的：直接替换链接器入口会跳过SDK生成流程中做的XAML元数据注册、线程单元初始化、静态依赖注入等预处理步骤，运行时会出现元数据查找失败、对象初始化崩溃等问题。

正确实现步骤 #

1. 禁用SDK自动生成的默认入口
   在项目预处理器定义中添加宏DISABLE_XAML_GENERATED_MAIN，或者在pch.h文件最顶部（所有WinUI相关头文件引入之前）定义该宏：

   #define DISABLE_XAML_GENERATED_MAIN
   

   该宏只会通知生成任务不要注入自动生成的wWinMain，不会跳过任何框架前置预处理流程，是官方支持的自定义入口方式。

2. 实现自定义入口与消息泵
   在项目中新增入口代码文件（或者直接写在App.xaml.cpp末尾），实现你自己的wWinMain函数，在其中保留框架必需的初始化逻辑，再插入自定义消息控制逻辑，参考实现：

   #include "pch.h"
   #include "App.xaml.h"
   
   using namespace winrt;
   using namespace winrt::Microsoft::UI::Xaml;
   
   int APIENTRY wWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, PWSTR lpCmdLine, int nCmdShow)
   {
       // 自定义前置初始化：全局异常注册、日志初始化、启动参数处理等
       init_apartment(apartment_type::single_threaded_a);
   
       // 初始化XAML框架核心，必须保留
       Application::Start([](auto&&)
       {
           // 创建自定义App子类实例，和默认逻辑一致
           make<implementation::App>();
       });
   
       // 自定义消息泵逻辑，可自由添加消息拦截、预处理、分发逻辑
       MSG msg;
       while (GetMessage(&msg, nullptr, 0, 0))
       {
           // 可在此处添加自定义消息过滤：全局快捷键、原生窗口消息转发、空闲任务处理等
           TranslateMessage(&msg);
           DispatchMessage(&msg);
       }
   
       return static_cast<int>(msg.wParam);
   }
   

注意事项 #

• 不要在调用Application.Start方法之前创建任何XAML类型的对象，否则会触发运行时异常。
• 自定义消息循环必须保证XAML相关消息正常分发，否则会出现UI不渲染、布局不更新、交互事件不触发的问题。如果需要托管Win32原生窗口、DirectX渲染窗口等内容，直接在消息循环中增加对应窗口的消息分支处理即可，不需要修改框架初始化流程。
• MSIX打包场景下不需要额外修改配置，定义上述宏并实现自定义wWinMain后，生成系统会自动识别你的入口。

该实现方式完全兼容WinUI 3官方的应用生命周期机制，不会破坏框架的激活、挂起、恢复等系统回调逻辑。

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