freedesktop.egl 1.7.0:libglvnd 源码构建;模块名改跟接口所有者(khronos.egl / freedesktop.wayland.*)

[Sunrisepeak]

⚠ 先说一件需要尽快合的事

为了承载模块重命名,mcpplibs/wayland 的 v1.26.0 被原地重切(上游没有更新版本可跟,而版本号必须与上游对齐)。后果是立即的:

main 上 freedesktop.wayland.lua 的 sha256   0a5dd54a…
tag 上 tarball 的实际 sha256                961a900d…   ← 不匹配

在本 PR 合并之前,freedesktop.wayland@1.26.0 从 main 装不下来。 本 PR 更新了四个 wayland 描述符的 sha256,合并即恢复。正确的次序本该是先改描述符、合并、再重切 tag,这一点已记进设计文档 §19.6。

另有一个更隐蔽的:store 只按 (name, version) 索引,已经装过 1.26.0 的机器不会重新下载,会继续用旧模块名而毫无提示。开发机需要手动清:

rm -rf ~/.mcpp/registry/data/xpkgs/freedesktop-x-wayland*/1.26.0 \
       ~/.mcpp/registry/data/xpkgs/freedesktop-x-egl/1.7.0 \
       ~/.mcpp/build-cache/v1/pkg/freedesktop ~/.mcpp/build-cache/v1/tool/freedesktop

这个 PR 做了什么

1. compat.egl → freedesktop.egl:从绑定改为源码构建。

compat.egl 自己的注释就写着这是错的:

libglvnd is a separable project, so by the criterion this should be a source build; it is still a binding for effort alone

判据里没有「工作量」这一项。上游 fork:mcpplibs/libglvnd v1.7.0,CI 四 job 全绿。

2. 模块命名:跟拥有「接口」的组织。

wayland.client  →  freedesktop.wayland.client      freedesktop 确实拥有 wayland 协议
wayland.server  →  freedesktop.wayland.server
wayland.util    →  freedesktop.wayland.util
egl             →  khronos.egl                     EGL 是 Khronos 的规范

EGL 的包名与模块名故意不一致:包是 freedesktop.egl(freedesktop 确实在发这份代码),模块是 khronos.egl(Khronos 拥有规范,libglvnd 只是实现之一)。

依据不是审美,是 mcpplibs.openkal 已经付过的学费 —— 它的 0.1.0 是被撤回而不是保留的:

It placed the module a consumer imports under the control of the implementation, which contradicts what the specification is for

模块名是全局且长期的,包名不是。换实现不该逼消费者改 import,否则一个「除了 include 那一行什么都不改」的包装层就失去了意义。副作用是好的:两个 EGL 提供方现在会在模块名上硬冲突,而不是静默共存 —— 这正是 GLVND 想要的。

索引既有的惯例本来就是「namespace 不进模块名」(chriskohlhoff.asio → import asio、compat.opencv → import opencv.cv),这次是把它说具体。

3. 两个 fork 的 CI 钉住 xlings。

原先 curl … | bash 拿的是当天最新,红了也分不清是自己坏了还是生态变了。现钉 XLINGS_VERSION: "2026.8.27.5",与 mcpp 的 kXlingsVersion 一致。mcpp 本身仍不钉 —— 这些包依赖的正是生态,钉死的 mcpp tarball 带的是生态的冻结快照。钉住装的工具,放开被测的生态。

（要求里写的是 pin 到 2026.8.27.4,但那比 .5 旧三小时、且缺少「声明压过索引」的行为。详见设计文档 §15 与 §19.5。）

生态真实验证(--sandbox --gpu)

在一个 /home/speak 是合成的沙箱里从零 clone + 装 mcpp + 构建 + 运行。关键是沙箱里 /usr 是宿主的:

host has  /usr/lib/x86_64-linux-gnu/libEGL.so.1
host has  /usr/lib/x86_64-linux-gnu/libgbm.so.1
host has  /usr/lib/x86_64-linux-gnu/libdrm.so.2
host has  /usr/lib/x86_64-linux-gnu/libwayland-client.so.0

所以要证的不是「宿主不在」,而是「宿主在、可达、且依然全部落败」:

libdrm.so.2            => <project>/target/…/bin/libdrm.so.2
libEGL.so.1            => <project>/target/…/bin/libEGL.so.1
libGLdispatch.so.0     => <project>/target/…/bin/libGLdispatch.so.0
libwayland-client.so.0 => <project>/target/…/bin/libwayland-client.so.0
libwayland-server.so.0 => <project>/target/…/bin/libwayland-server.so.0
libffi.so.8            => <project>/target/…/bin/libffi.so.8
libgbm.so.1            => <registry>/xpkgs/compat-x-libgbm/25.0.7/…/libgbm.so.1

PASS: the host's copies were present and reachable, and none of them won

真跑:

EGL_VERSION            1.5 libglvnd            ← 自建 dispatch 在答
/dev/dri/card0         drm driver simpledrm
  gbm_bo_create        256x256 stride=1024     ← 真分配出 buffer object
  eglInitialize        EGL 1.5, vendor Mesa Project

import khronos.egl; 与两个 import freedesktop.wayland.*; 在同一次干净构建里编译链接通过。

测试成员

每条断言在零 vendor 的机器上都成立,这是被 runner 教的:原来那条「扩展串里有 EGL_EXT_」在开发机过、在干净 runner 挂,因为上游在 vendor 列表为空时直接 return ""(libegl.c:928)—— 那条断言测的是机器有没有 GPU 驱动。换成两条更有用的:EGL_VERSION 由 libglvnd 在任何 vendor 之前答成字面量 "1.5 libglvnd"(既是活性也是身份检查),以及 dladdr 确认加载的确实是本包构建的 libEGL.so.1 而不是 xim:libglvnd payload 的同 soname 副本。

镜像

wayland / libglvnd 两个 CN 镜像已重新发布,与 GLOBAL 字节一致。

文档

跨仓设计文档补 §19(模块命名、生成器该放 build.mcpp 还是签进仓、沙箱验证、自己造成的破坏、八角度审视),两份 descriptor-examples 同步。