flutter-visual-qa

Flutter 视觉 QA

渲染结果才是证据。仅检查源代码无法判断视觉质量。

构建测试矩阵

选择覆盖以下情况的最小代表性矩阵：

• 紧凑和扩展约束；
• 支持时的浅色和深色主题；
• 适用时的默认、加载中、空、错误和破坏性状态；
• 默认和放大文本；
• 本地化产品的 LTR 和 RTL。

记录确切的视口、设备像素比、主题、语言区域和测试数据状态。阅读 references/visual-qa.md。 对于联网或多域产品，还要阅读 references/connected-product-workflows.md，并在矩阵中包含部分数据源故障情况。

检查

先检查层级和浏览路径，然后检查布局、字体、间距节奏、颜色角色、控件、内容真实性、边缘行为和像素级缺陷。并排比较相关状态。区分实现缺陷和主观偏好。

优先处理：

1. 阻碍任务的裁切、重叠、不可见或无法触及的控件；
2. 层级、对比度、状态传达或自适应布局异常；
3. 不一致和润色缺陷；
4. 可选的美学调整。

Golden 测试

对稳定组件和确定性测试数据使用 Golden 测试。控制字体、动画、时间、网络内容和像素比。未经检查差异，不要批准大范围 Golden 更新。

完成闭环

对于重大问题，至少进行一轮优化，并重新捕获受影响的状态。报告检查过的矩阵、修复内容、未经验证的组合和产物路径。