2. Wayland基础
Wayland 并不是一个“图形库”，也不是一个“窗口系统实现”，而是一套显示服务器协议。它规定了客户端（应用）与合成器（Compositor）之间如何交换缓冲区、输入事件、窗口状态和同步信息。理解 Wayland 的关键，是把“协议”“合成器”“客户端-服务器模型”三件事分开看：协议定义通信规则，合成器是协议的服务器端实现，客户端则是遵循协议的应用进程。
核心原理：协议是契约，合成器是执行者
在 Wayland 架构中，客户端通过 Unix 域套接字连接到合成器，使用 wl_display 作为连接入口，再通过 wl_registry 发现合成器暴露的全局接口，例如 wl_compositor、wl_shm、xdg_wm_base、wl_seat 等。客户端调用这些接口创建对象，合成器则负责管理对象生命周期、合成画面、分发输入。
与 X11 最大的不同在于：Wayland 客户端不再直接绘制到“屏幕”，而是把渲染结果写入缓冲区，再通过协议把缓冲区提交给合成器。合成器决定何时、以何种方式把缓冲区合成到最终显示画面。这种“客户端渲染、合成器合成”的分工，使 Wayland 天然更适合 OpenGL ES 等 GPU 渲染路径。
一句话理解：Wayland 协议是客户端与合成器之间的“合同”，合成器是执行合同的“服务器”，客户端是提交缓冲区和请求的“客户”。
客户端-服务器模型：谁在做什么
Wayland 的客户端-服务器模型非常清晰：合成器运行在服务器端，负责设备输入、输出管理、窗口策略和最终合成；客户端运行在应用侧，负责创建表面、渲染内容、处理自身逻辑。两者通过异步请求和事件进行通信。
- 客户端请求：创建表面、附加缓冲区、提交表面、设置窗口标题、请求移动等。
- 服务器事件：输入事件、表面进入输出、配置变更、帧回调、键盘焦点变化等。
- 同步机制：通过
wl_callback帧回调控制渲染节奏，避免无节制提交。 - 缓冲区管理：使用
wl_buffer传递像素数据，支持共享内存和 GPU 缓冲区。
这种模型下，合成器拥有最终决定权。例如窗口如何排列、哪个表面获得焦点、输入事件发给谁，都由合成器策略决定。客户端不能绕过合成器直接操作显示硬件，这带来了更好的安全性和一致性，但也要求客户端严格遵循协议。
与 X11 对比：从“直接控制”到“合成器主导”
X11 的设计年代较早，客户端可以通过 X Server 直接创建窗口、绘制图形、查询设备，甚至绕过窗口管理器。Wayland 则把显示控制权集中到合成器，客户端只负责渲染自己的表面。这种变化带来了更清晰的职责边界，也改变了输入处理、窗口管理和渲染同步的方式。
| 对比维度 | X11 | Wayland |
|---|---|---|
| 架构核心 | X Server 作为显示服务，客户端直接与其通信 | 合成器作为服务器，客户端提交缓冲区 |
| 渲染方式 | 客户端可调用 X11 绘图 API，也可使用 GLX | 客户端使用 EGL/OpenGL ES 渲染到缓冲区 |
| 输入分发 | X Server 分发事件，窗口管理器参与策略 | 合成器统一分发输入事件，策略更集中 |
| 窗口管理 | 窗口管理器是独立客户端，可替换 | 窗口管理逻辑内置于合成器 |
| 同步机制 | 依赖 X Sync 扩展和帧回调 | 通过 wl_callback 帧回调与缓冲区提交同步 |
| 安全性 | 客户端权限较大，隔离性较弱 | 客户端只能操作自己的表面，隔离性更强 |
案例场景：一个 OpenGL ES 应用如何与 Wayland 交互
假设我们有一个基于 OpenGL ES 的简单应用，它需要在 Wayland 下显示一个旋转三角形。典型流程如下：
- 连接合成器：
wl_display_connect(NULL)建立与合成器的连接。 - 获取全局对象：通过
wl_registry绑定wl_compositor、wl_shm、xdg_wm_base等接口。 - 创建表面：调用
wl_compositor_create_surface()创建wl_surface。 - 创建 EGL 上下文：使用
eglGetPlatformDisplay()绑定 Wayland 显示，创建 EGLSurface。 - 渲染循环：在每一帧中调用 OpenGL ES 绘制，然后
eglSwapBuffers()提交缓冲区。 - 帧同步：通过
wl_surface_frame()获取帧回调，等待合成器通知下一帧。
// 简化示例：Wayland + EGL 初始化片段
display = wl_display_connect(NULL);
registry = wl_display_get_registry(display);
wl_registry_add_listener(registry, ®istry_listener, NULL);
wl_display_roundtrip(display);
surface = wl_compositor_create_surface(compositor);
egl_display = eglGetPlatformDisplay(EGL_PLATFORM_WAYLAND_KHR, display, NULL);
eglInitialize(egl_display, NULL, NULL);
egl_surface = eglCreatePlatformWindowSurface(egl_display, config, surface, NULL);
eglMakeCurrent(egl_display, egl_surface, egl_surface, egl_context);
while (running) {
// OpenGL ES 绘制
glClear(GL_COLOR_BUFFER_BIT);
// ... 绘制三角形
eglSwapBuffers(egl_display, egl_surface);
wl_display_dispatch(display);
}
这个流程中，eglSwapBuffers 会触发 Wayland 的缓冲区提交，合成器收到后决定何时合成。客户端不能假设提交后立即显示，必须依赖帧回调来保持节奏。
常见误区与复盘
误区一：把 Wayland 当成“另一个 X11”。实际上 Wayland 协议更精简，客户端不能直接查询全局窗口树，也不能随意控制其他窗口。
误区二：认为合成器只是“窗口管理器”。在 Wayland 中，合成器同时承担显示服务器、输入分发、窗口策略和最终合成，职责远比传统窗口管理器重。
误区三：忽略帧回调，导致渲染节奏与合成器不同步，出现卡顿或撕裂。正确做法是每帧等待 wl_callback 后再提交。
复盘建议：调试 Wayland 应用时，先确认 WAYLAND_DISPLAY 环境变量是否指向正确的合成器套接字；再用 wayland-info 查看合成器暴露的全局接口；最后检查 EGL 平台是否选择了 Wayland 后端。若应用在 X11 下正常、Wayland 下异常，优先排查缓冲区格式、帧回调和输入焦点处理。
总结来看，Wayland 的基础可以归纳为三点：协议定义通信规则，合成器是服务器端实现，客户端-服务器模型决定了渲染与输入的职责划分。与 X11 相比，Wayland 更强调合成器主导、客户端隔离和缓冲区提交，这为 OpenGL ES 集成提供了更现代、更高效的路径。