SuperAPI AI 工具集

avalonia-pro-max/review-checklist

测试与质量

查看项目

更新于 11-03 16:15

技能介绍

用途:这是一个 Avalonia UI 应用交付前检查清单,在合并 UI 工作或发布版本前使用。逐项核对,任一项失败则修复后从头重跑;失败项可关联到对应子技能(如 design-system、themes、components、motion、accessibility、layout-patterns、icons-imagery)。

使用方法:以默认窗口尺寸、紧凑宽度(640px)和宽屏(1600+px)打开每个界面;在 Light 与 Dark 间切换 RequestedThemeVariant;仅用键盘 Tab 遍历每个界面;在主流程上运行屏幕阅读器(Windows 用 Narrator,macOS 用 VoiceOver);用 Avalonia DevTools(F12)分析布局/渲染问题(12.x 需 AvaloniaUI.DiagnosticsSupport 包并调用 AttachDeveloperTools();11.x 用 Avalonia.Diagnostics 与 AttachDevTools())。

主要检查范围:

  • 设计令牌与主题:视图中不得硬编码颜色、间距和字号,须通过 DynamicResource 和统一的比例引用;每个语义画刷提供明暗两套字典;运行时跟随系统主题变化;文字/背景对比度两种主题均≥4.5:1。
  • 主题库:只导入一个基础主题;主题 NuGet 版本与 Avalonia 版本兼容;不依赖主题内部画刷键。
  • 组件质量:按钮使用共享样式类;纯图标按钮有足够点击区域;表单有可见标签、错误内联显示;空状态与加载状态规范;Toast 3–5 秒自动消失且不抢焦点。
  • 动效:悬停/按下反馈≤150ms,页面过渡 200–300ms 并带缓动;不对 Width/Height/Margin 做动画;验证减少动效路径。
  • 无障碍:纯图标按钮设置 AutomationProperties.Name;输入与标签关联;必填项标记;焦点环可见;不只靠颜色传达信息;在多种 DPI 与高对比度下验证;快捷键符合平台习惯。
  • 布局与响应式:无在 800px 宽度下破坏的固定像素布局;长文限宽约 720px;长列表虚拟化;单一垂直滚动;紧凑宽度下侧栏折叠、右面板隐藏。
  • 图标与图像:统一图标族,尺寸取自尺寸令牌;提供各平台所需应用图标尺寸;网络图片异步加载并带占位。
  • 性能:启用编译绑定(12.0 起默认开启,11.x 需显式开启,12 中每个 {Binding} 需 x:DataType);避免属性变更风暴与 Render() 中分配;≥100 项列表虚拟化;滚动保持 60fps;首窗口显示<1s;发布构建无控制台警告。
  • 平台一致性:在 Windows、macOS、Linux(X11,必要时 Wayland)上构建测试;Linux 屏幕阅读器(Orca)需 Avalonia 12.0+;如目标平台包含移动端或 Web,也需测试;文件对话框使用 IStorageProvider;字体在各平台正常渲染;快捷键符合平台约定。

最终打磨:构建输出无 XAML 警告;App.axaml 样式按主题、令牌、应用样式顺序排列;移除未用样式与资源;多语言应用避免硬编码英文字符串;设计器预览可用;生产代码中不残留 MessageBox.Show。

限制:资料仅提供检查清单内容,未说明该技能的具体安装方式、运行命令或自动化能力,这些暂未提供。