feat(wayland-egl): 补上客户端做 GPU 渲染的唯一入口

[Sunrisepeak]

一个 Wayland 客户端要用 EGL 画东西,需要把 wl_surface 变成 EGLNativeWindowType,而唯一的办法是 wl_egl_window_create —— 它只在 libwayland-egl 里。之前索引里没有这个库:

wl_surface  ->  wl_egl_window  ->  eglCreateWindowSurface  ->  draw
                ^^^^^^^^^^^^^ 不存在

「Wayland 客户端 + EGL」整类程序不可表达。

漏掉的原因:fork 建了合成器需要的四个成员就停了(合成器渲染进 GBM 缓冲,不走这条路),所以索引从服务端看是完整的、从客户端看是不能用的。上游把源码放在同一个 tarball 里(upstream/egl/,118 行)。

配套 fork PR:mcpplibs/wayland#1(已合)。

tarball 换了指向,tag 没动

加第五个成员改变了归档内容,而一份归档支撑五个索引条目。原来 GLOBAL 指的是 tag archive(archive/refs/tags/v1.26.0.tar.gz),重切 tag 会当场打断已发布的四个描述符的 sha256 —— 正是「同版本重切 tag」那条教训。

所以不动 tag,把新内容作为 release 资产发布:wayland-1.26.0-mcpp2.tar.gz。旧 tag 归档原样还在,没有任何时间窗口里 main 是坏的。

附带两个好处:GLOBAL 与 CN 现在形态对称(都是 release 资产);重打包时解引用了 upstream/git-blame-ignore-revs 这个符号链接 —— 按「符号链接归档咬 Windows」那条,顺手消掉。

两个镜像逐字节一致(sha256 比对,非可达性):

GLOBAL bcf388cc1dd6617f…  1030428 bytes
CN     bcf388cc1dd6617f…  1030428 bytes

测试成员

只名一个包,client 走传递依赖 —— 因为 wayland-egl 成员内部对 client 是 path 依赖,测试再声明一次 version 依赖会被直接拒绝:

error: dependency 'freedesktop.wayland' is requested as both a version dep
       (by 'wayland-egl-tests') and a path dep (by 'freedesktop.wayland-egl@1.26.0').
       Pick one.

这个诊断是对的:两种拼法可能解析到两棵不同的树。

测试包含 wayland-egl-backend.h —— 那是这个库与 EGL 实现之间的契约(Mesa 就包含它),否则透过公共头只能观测到「create 返回非空」。

第一版我断言错了一处。 以为 get_attached_size 会返回创建尺寸,实际返回 0 x 0。读源码才发现 attached_width/height 是 EGL 实现附加缓冲时才写的字段,create 用 calloc 归零、resize 也不碰。现在断言的是真契约:没有东西渲染进去的窗口报告「什么都没附加」。

module exports wl_egl_window_create / _destroy / _resize / _get_attached_size   ok ×4
wl_egl_window_create(surface, 640, 480)                    ok
   version=3  size=640 x 480
…and stamped WL_EGL_WINDOW_VERSION                         ok
…and recorded 640 x 480                                    ok
…and round-tripped the wl_surface pointer                  ok
   attached size before any EGL attach: 0 x 0
get_attached_size reports 0 x 0 until EGL attaches          ok
wl_egl_window_resize updated the geometry                   ok
…and a width of 0 is refused, not stored                    ok
wl_egl_window_destroy                                       ok
wl_egl_window_create refuses a width of 0                   ok
libwayland-client is in the same program                    ok
0 check(s) failed

原有四个包在新 tarball 上照常绿(tests/examples/wayland:2 passed)。