测试
核心库不含 Minecraft 类型,所以整套 UI 生命周期都可以在没有游戏的情况下跑起来。测试基建就是一个把这些接口都实现成空操作的假后端。
假后端
假后端实现了全部后端接口,把职责委托给几个独立的小对象(渲染器、Screen 工厂、工具、元数据、输入),渲染参数与 Screen 类型都用 Unit。
这套基建位于 src/test,分发的是核心 jar、可选的 demo jar 及各自的 sources jar;测试夹具本身不在这些产物里,所以它是仓库内部的设计记录,不是可供依赖的公开 API;要测试自己的页面,得自己写一个后端实现。
它体现的取舍是:只保留能影响逻辑的部分。
| 部分 | 实现 |
|---|---|
| 渲染原语 | 四边形为空实现;三角形记录其几何、颜色与是否带纹理 |
| 裁剪与变换作用域 | 直接执行内部代码块(不留痕迹) |
| 翻译 | 原样返回键名 |
| 本地图像 | 返回空图像(不加载文件) |
| 输入查询 | 恒为未按下 |
| 字体 | 固定度量 |
字体度量是整个假后端里唯一有实质数值的部分:行高与字宽都是 9.px、粗体偏移 0.px、阴影偏移 1.px、缩放 1.0。布局断言依赖这些数值,改它们会改变大量期望值。
驱动一帧
测试通过一个辅助函数跑一帧,过程是:
- 设置鼠标位置(默认原点);
- 把根节点矩形设为固定的
800 × 600; - 把待测 Screen 收集为根节点的子节点;
- 在”后端 + 渲染参数 + 鼠标位置”三个上下文参数下调用根节点渲染;
- 帧结束后把该子节点从根节点移除。
第 3 步与第 5 步是这个辅助函数存在的主要理由:假后端有一根长期存在的 TestRoot.root 供普通用例使用,测试必须自己负责挂载与卸载,否则用例之间会互相污染。根不是进程级单例;需要独立树的用例用 TestRoot.newRoot() 建根,它的 Screen 工厂绑定这个根,TestRoot.screen(root, …) 创建的屏也属于它。
测试夹具的根也和产品一样从空 children 开始,不会在 newRoot() 里偷偷装入口 Overlay。需要覆盖 Overlay 的用例显式调用 installEntryOverlays(root);只测普通树的用例因此能真正观察到空根和 null 工厂路径。
src/demo 的示例页通过独立 source set 编进 demo 产物,测试 classpath 显式包含 demo output;所以 DslPreviewTest 里的 io.github...test.Test* 引用仍能解析。示例入口的注册表也在 demo resources 里,不在核心 resources 里。
同一进程里的测试仍共享 DslId 与 static 槽,测试之间没有完全隔离,所以每个用例仍从新建 Screen 开始。测试独立性必须来自真实的不同根、不同挂载和不同的工厂,而不是手写内部 rootState 或把全局根的屏挂到另一个根上——后者现在会被根拒绝,正是为了避免测试掩盖所有权错误。
进程级的启动序列(DslRuntime 的 install / start)本来各只允许调用一次,测试用 DslRuntime.resetForTest() 把它放回”什么都没发生”的状态。它只管三件事:installed、元数据 provider、平台 provider——运行时不再持有任何根,所以夹具的根是测试里直接 DslRoot(input, renderer, screenFactory, rootUtils) 构造的,resetForTest 不会也不该碰它。因此用例之间不依赖执行顺序:既不需要类级 @Order,也不需要 junit-platform.properties 里的顺序配置(那份配置现在只是可读性上的方便)。会改到平台 provider 的用例必须保存并恢复原值而不是置空——置空等于把”重复发布必须返回 false”这条契约从进程里抹掉。计数类断言要比较增量,因为每次安装都会重跑一次入口发现。
测试分层
| 层次 | 覆盖内容 | | — | — | | 单元 | Measure、MeasureArray、Rect、Position、Color、Transform、Aligner、Alignment、Modifier、DslId | | 集成 | 树结构、布局、装饰器、事件、惰性列表 |
集成测试直接断言组件的矩形:例如”行布局中第二个组件的左边界恰好等于第一个的右边界”、”权重 2 的组件比权重 1 的宽”、”嵌套后没有重叠”。这类断言不需要渲染,只需要布局正确。
装饰器测试断言属性而非绘制结果(子节点数量不变、可获得焦点、可高亮、有朗读文本、有提示)。事件测试断言消费语义(点击被消费、区域外不触发、命中测试的命中与未命中、Tab 导航、未处理的滚动量原样透传)。
写新测试
- 用假后端构造一个 Screen,包住待测的 DSL 片段;
- 调一次
renderFrame完成构建与布局; - 从 Screen 的组件树里按身份或位置取出目标组件,断言其
rect或元数据; - 需要模拟输入时,设置鼠标位置后用上下文参数调用根节点上的对应方法。
纯数学类型的测试不需要 Screen,直接断言即可。
覆盖缺口
这是当前最需要警惕的部分。
没有行为断言的组件:ShrinkBox、MouseTip、DefaultBackground、ColorRect、AutoScroll;Button 只有”宽高大于 0”这一级 smoke。
只覆盖了行为的一小部分:LateBox 只验证了”同帧重复布局不重复构建内容”;LazyScrollable 只验证了身份查找与 scrollTo 的对齐/约束分支,没有验证”视口外的条目确实没被构建”;Overlay 只验证了身份与迭代构建。
有测试但只测了弱语义:
- 装饰器测试不验证绘制输出、绘制顺序,也不验证修饰符内边距的叠加;
- 颜色作用域只验证了取值,没有验证渲染结果。
契约存在但零断言:反向渲染顺序、正向命中优先、首个消费者胜出、Overlay 的迭代构建、层叠顺序(提示层 > Overlay 层 > 主树)、文本折行。
依赖假后端而事实上无法验证的:四边形绘制语义(空实现)、裁剪与变换对绘制的影响、输入转发链路。三角形只记录输入,资源分支与缺图纹理由真实后端验收。
已知问题
- 四边形渲染原语为空,任何与”四边形画了什么”有关的回归都不可能在现有测试里发现;三角形测试只覆盖核心提交的几何与颜色,不覆盖后端解释。
- 假后端仍是”能跑通”而不是”能证明”:像线程约束、字体一致性这类要求,它只能做到不违反,无法在测试里主动验证。
- 断言的价值要用退化实现来确认:审计把 12 处算法改坏后整套测试仍然全绿(滑块越界、滚动条拖拽系数归零、退格删错方向、逆矩阵整体缩放……),补测后每一处才有用例守着。新加断言时应先把实现改坏、确认它会失败,否则断言可能什么都没守。