feat(gnome.pango*): 文本排版那条线接上了 —— 三个成员,各带模块

[Sunrisepeak]

gio 到位,闸门就开了

§19.7 说 pango 被 gio 挡住 —— 那条判断在 #322 里被推翻并修正。现在:

PangoFontMap 声明 G_IMPLEMENT_INTERFACE (G_TYPE_LIST_MODEL, …),没有 gio 它连注册都做不到。 测试在运行期断言 g_type_is_a(pango_font_map_get_type(), g_list_model_get_type()),而不是拿「构建通过」当证据。

成员	是什么	模块导出
gnome.pango	分项、bidi、断行、markup	851
gnome.pangoft2	fontconfig 选文件,FreeType 出字形	88
gnome.pangocairo	cairo 后端 —— pango_cairo_show_layout	284

⭐ 唯一一个产出像素的测试

pangocairo 把 "Hello 世界" 画到 ARGB32 surface 上,数非透明像素:1,492。走到那一步要七个包:

gnome.pango        分项、bidi、断行
gnome.pangoft2     fontconfig 选文件,FreeType 光栅化
gnome.gio          PangoFontMap 是 GListModel
compat.harfbuzz    整形
compat.fribidi     bidi 算法
freedesktop.cairo  字形落下去的那张 surface

空白图片意味着其中之一没干活。

⚠️ 它诚实地降级:freedesktop.fontconfig 故意把运行期路径编译成空,所以没有字体的 runner 合法地得到 0 个字体族 —— 那条断言就不跑,并且说出来。「0 个字体族所以没跑」和「文字画出来了」不能长得一样。

⚠️ config.h 没有输入模板

上游写的是 configure_file(output: 'config.h', configuration: pango_conf),没有 input: —— meson 按 key 逐条发 #define,树里根本没有可替换的模板。文件必须写出来,每个值都是本包的决定。两个是算术:

PANGO_BINARY_AGE    = minor * 100 + micro      # 5601
PANGO_INTERFACE_AGE = minor 奇数 ? 0 : micro    # 1

pango_version_check() 读第一个,所以写错不会构建失败,只会让一次正确的版本比较给出错误答案。测试两个方向都断言。

⚠️ 一次静默降级,和抓住它的那条断言

HAVE_CAIRO_FREETYPE 被一次编辑失误弄丢。什么都没有构建失败。 pangocairo-fontmap.c 只是一个后端都没注册:

Pango-CRITICAL: Unknown $PANGOCAIRO_BACKEND value.
  Available backends are:            <- 空列表

然后段错误。测试现在读 font map 的字体类型并要求 CAIRO_FONT_TYPE_FT。

⚠️ 待办:freedesktop.cairo 的模块自己不够用

1.18.2 实测:470 个名字、零个枚举量(没有 CAIRO_FORMAT_ARGB32、没有 CAIRO_FONT_TYPE_FT)、没有 cairo_t。

索引自己的 cairo 示例没发现,因为它同时写了 #include <cairo.h> 和 import freedesktop.cairo; —— 头文件补上了模块缺的那半。也就是说那个 import 从来没有被单独检验过。

pangocairo 不能混用两条路(pangocairo.h 经 glib 到 <stdio.h>,混用让 struct _IO_FILE 变成两个实体),所以 gnome.pangocairo 自己扫了 cairo.h。从两个模块导出同一实体是无害的,所以这是追加而非冲突 —— cairo 修好后那行可以去掉。

两条消费路线,各带测试

import gnome.pangocairo;        // 转出 pango、pangoft2、cairo
#include <pango/pangocairo.h>   // 另一条

两条不能混用。选哪条由宏决定:模块带不了宏,用 PANGO_TYPE_*/G_OBJECT 的走头文件,用函数 API 的走模块。每个成员各带两个测试。

依赖形态

点名 gnome.pangocairo 一个就够 —— 另外两个是它的 workspace path 依赖,再点名会得到 requested as both a version dep and a path dep。那条错误就是这个 fork 第一次构建时学到的。

验证

• 三个示例 × 两条路线 × 两条工具链(gcc 16.1 / llvm 22.1)全绿
• fork CI 三个 job 全绿:两条工具链 + upstream/ 未改
• 端到端:1,492 个像素

文本排版那条线接上了。