窗口、消息循环、输入法——C++ 桌面界面最贵的三层,我收进了一个 .lib

0 阅读10分钟

一个 .lib + 一个 include 目录,就能在 Windows / Linux 上跑起一个 GPU 渲染、支持中文输入法、主题可定制的 C++ 桌面界面。

这篇讲讲 Zekit 到底做了什么、替你省掉了什么,以及我刻意定下的那几条设计纪律。

视频版:【C++ 桌面 GUI Zekit:单静态库,内置 D3D12 / Vulkan / OpenGL 渲染后端】

源码:GitHub | Gitee


一、先说结论:什么叫"即用型"

Zekit 是一个 C++20 的即用型 GUI 控件库。

它不是"给你一套抽象、然后让你自己实现平台层"的那种库。它自带窗口、自带渲染管线、自带整套控件体系,最后编译成一个静态库。

所谓即用型,意思是:你只需要 include 一个头文件、链接一个 lib,就能得到一个跑在 GPU 上、支持中文输入法、主题可定制的现代界面。打开控件画廊(Control Gallery)看到的第一眼,就是一个完整可交互的界面,而不是一个空白窗口。

写 C++ 桌面界面最消耗人的从来不是"怎么摆一个按钮",而是按钮背后那一整套基础工程——交换链、消息循环、字体度量、输入法候选窗定位。这些活儿每一件都不难,但一件也不能少,而且每一件都要在 Windows 和 Linux 上各做一遍。

Zekit 的存在意义,就是把这堆活儿固定下来一次,然后你只管写界面。


二、它替你省掉的平台层代码

先说最枯燥、也最容易劝退的那一层。

平台层的事传统做法Zekit
窗口创建与消息循环手写 WinMain / WndProc / X11 事件循环库内完成
鼠标键盘派发自己维护路由、自己算坐标库内完成,直接给值语义事件
剪贴板各平台 API 各写一遍库内统一接口
输入法 / 候选窗跟随WM_IME_* 一整套,还得算候选窗位置库内完成
渲染后端与交换链学 WGL / Vulkan / D3D12 三套初始化库内完成,可切
字体光栅化、图片解码拖 FreeType / stb,自己拼编在同一个 lib 里

窗口创建、消息循环、鼠标键盘派发、剪贴板、输入法候选窗跟随——这些平台层的事,Zekit 全包了。你不需要写任何一行平台代码。

这里我想单独强调"输入法"这一项,因为它是最容易被低估的。中文输入法不是"能打字"就完了:候选窗要跟着光标走、合成串要能被正确回显、失焦要能正常收尾。很多自研 GUI 项目前期都跳过这块,等真的要输入中文时才发现要重构整条文本输入链路。

渲染层也一样。OpenGL、Vulkan、D3D12 三套后端的上下文创建、函数加载器、渲染器,全在库里面。字体光栅化、图片解码,同样编在同一个 lib 里。

你不需要为了显示一个界面,先去学一遍交换链怎么建。


三、作用一:上手成本极低

一个窗口、一个按钮、一个点击回调,十几行代码就能跑起来。

#include <Zekit.h>

int main() {
    Kit::Window win;
    win.UseRenderer(Rhi::Api::Vulkan);

    Kit::Button btn("确定");
    btn.SetPosition(50, 50);
    btn.SetSize(220, 60);
    win.AddWidget(btn);          // 交出去就完事

    win.Show();
    return win.exec();
}

这段代码里没有一处需要解释的语法。但有几件事值得单独点出来,因为它们不是"少写了几行",而是设计取向:

控件是普通值。 Kit::Button 就是一个栈上的对象,AddWidget 把它的所有权接过去,交出去之后就不用再管了。

不需要 new,不需要 delete。 也不用把按钮存成成员变量来保活——没有生命周期负担,也就没有析构顺序的问题:窗口和控件谁先谁后退出,不会变成一个需要你操心的话题。

不需要成员变量保活。 这一点在真实项目里比想象中重要。很多 GUI 框架要求你把控件指针挂在窗口类的成员上,于是业务逻辑和界面结构就被这张"成员变量清单"绑死了;Zekit 里界面描述是线性的,写完就过去了。

回调同理,它就是挂在这个值上的一个 std::function:按钮 AddWidget 之后依然能拿回来改,但你不必为了回调而提前存指针。


四、作用二:换后端不用改界面

想换渲染后端,一行:

win.UseRenderer(Rhi::Api::D3D12);   // 或 Rhi::Api::Vulkan、Rhi::Api::OpenGL

D3D12、Vulkan、OpenGL 随便切,界面代码一个字都不用改。

后端适用场景
OpenGL兼容性兜底:老集成环境、虚拟机、远程桌面
Vulkan需要自己控制命令与内存的场合,Linux 上更自然
D3D12Windows 上跟已有 D3D 管线共存

这句话听起来像宣传语,但它是可以被验证的:同一个界面在三个后端上的输出是一致的,不是"差不多"。下一节解释它为什么能做到。


五、为什么换后端这么容易

因为控件不碰 GPU。

控件只负责描述这一帧画什么——这里一个圆角矩形、那里一行文字、再叠一张图。顶点和纹理的生成、排序、上传,全部由窗口侧统一处理。

控件(不知道 GPU 的存在)
        │  只描述这一帧画什么
        ▼
窗口侧统一收集 · ZeFrameCollector
        │  顶点 / 纹理 / 绘制序
        ▼
提交给 D3D12 / Vulkan / OpenGL

这是整个库最关键的纪律。

一旦某个控件自己持有 GL 句柄,或者自己起一条命令缓冲,那么"换后端不改界面"就会立刻变成空话——因为你得去改那个控件。所以这条纪律不是风格偏好,而是所有其他承诺的前提。

也正因为这条纪律,同一份界面代码在三个后端上的输出才是一致的。一致性靠纪律守住,不靠自觉。


六、作用三:能长大

小 demo 和真项目的区别在于:真项目里控件之间要互相说话。

Zekit 给出的三件事:

按值构建。 界面代码是平铺直叙的,写起来像文档。

按名字找回。 FindWidget / FindWidgetDeep 可以在任意深度上按名字取到控件;VisitTree 能把整棵树遍历一遍。

互相访问。 在按钮的回调里改标签文字,在键盘事件里读别的控件的几何,把整棵树的布局状态存下来、下次启动时还原。

// 按名字找回,不管它埋在第几层
auto* label = win.FindWidgetDeep("title");
// 面板上改一行字,不必事先把指针存成成员

// 遍历整棵树:存几何、批量改样式、做二次启动还原
win.VisitTree([](Kit::Widget& w) {
    // 每个节点都会走到这里
});

想写自己的控件,选对基类就行,不必从零实现几何、命中、焦点这一套公共逻辑。

这一块的设计取舍是:不引入脚本层、不引入数据绑定框架、不引入声明式 DSL。界面就是 C++,回调就是 std::function,想怎么组织由你决定,库只保证"你能找回来"。


七、跨平台:一个宏收掉入口差异

同一份应用代码,Windows 和 Linux 都能编过去。

入口的差异(WinMain 与 main、控制台子系统的差别)用一个宏收掉,不需要你自己维护两套启动代码。

平台之间能力不对等的地方,用能力位查询去判断,而不是一堆 #ifdef:

// 问的是「这个平台支不支持」,而不是「这个平台是谁」
if (Kit::Cap::NativeFileDialog) {
    // 交给系统对话框
} else {
    // 走库内自带的那一个
}

这两者看上去结果差不多,但对代码的长期成本完全不同:#ifdef 会把平台判断散落到业务逻辑里,能力查询则让它收敛在一处。


八、性能:只讲机制,不报毫秒数

关于性能,我只讲机制,不报数字。

原因很直接:帧率和控件数量的数字换个机器、换个场景就不成立,说出来就是给自己挖坑。别人的旗舰卡上跑出来的数字,跑到一台核显轻薄本上会变成完全不同的故事。

能确定的是三条机制:

一、屏幕外的控件不进绘制。 裁剪域之外的控件根本不进入这一帧的图元收集,不是"画了但看不见"。

二、没变化的控件复用上一帧的顶点。 一个控件的顶点集合会被缓存起来,只要它这一帧没变,就整段复用,不重新生成。

三、连续的一批鼠标移动只合并成一帧。 拖动窗口、拖滑块时系统会灌进来一串移动事件,渲染按帧对齐,不会一个事件重画一次。

Zekit 是按万级控件这个量级设计的。至于你的界面能跑多快,拿真实场景压一遍最准——别信任何人的数字,包括我的。


九、分发:只需要两样东西

Windows 上,你只要给下游两样东西:

Zekit.lib
include/

没了。

字体、图片解码、OpenGL 加载器全在里面,不需要任何第三方 dll,也不需要装 Vulkan SDK。

关于 Vulkan 再补一句:如果机器上没有 Vulkan 运行时,它会自动回退到 OpenGL,而不是起不来。这让"能跑"这件事的失败面小了很多——你在自己机器上选了 Vulkan 调试,交到用户手里也不会因为显卡驱动版本而白屏。

⚠️ 提醒:GitHub Releases 里放的是使用文档和控件画廊,不是编译好的库。.lib 需要你自己用 CMake 编一遍。CLI 和 preset 都配好了,一条命令的事。


十、Zekit 适合谁

适合:

  • 想认真做 C++ 桌面应用,但不想在窗口和渲染上重复造轮子的人
  • 要在 Windows 和 Linux 上共用一套界面、不想为每个平台各写一份的人
  • 想快速验证界面想法、不想先花两周搭基础设施的人
  • 需要一个"能嵌进已有工程"的界面库、而不是一整套框架的人

不太适合:

  • 需要 Web 技术栈、或者要在浏览器里跑的项目
  • 需要成熟商业级生态、大量第三方控件市场的场景
  • 只是想要一个配置窗口、完全不想碰 C++ 的项目

十一、这就是 Zekit

回头看,这些都是设计选择,不是宣传口径:

  • 控件不碰 GPU,只描述这一帧画什么
  • 值语义,没有生命周期负担
  • 同一份界面代码,换后端不用改
  • 一致性靠纪律,不靠自觉

这四条串起来,就是 Zekit 的整个形状:把平台层和渲染层收进一个静态库,让"写 C++ 界面"这件事回到它本来的样子——描述界面,而不是搭建基础设施。

下一篇进入实操:环境搭建与构建,讲 CMake 怎么配、preset 怎么选、产物为什么在那个目录、以及那份唯一的源码清单。

有问题欢迎提 issue,或者直接在评论区说。