SuperAPI AI 工具集

avalonia-performance

编程与开发

查看项目

更新于 11-03 17:15

技能介绍

用途:该技能用于诊断和改进 Avalonia 应用的运行时性能,常见目标是解决大列表滚动卡顿、帧率下降、布局与渲染开销过高、启动慢和内存泄漏等问题。

工作流:官方资料建议先测量再优化。先打开 FPS、脏矩形、布局耗时和渲染耗时覆盖层,再用 DevTools 查看视觉树,最后用 dotnet-counters、dotnet-trace、dotnet-gcdump 分析 CPU 与内存。修复后必须在 Release 配置下复测(dotnet run -c Release),避免 Debug 构建或附加调试器造成结果失真。

诊断工具:12.0+ 使用 AvaloniaUI.DiagnosticsSupport 包与 avdt 全局工具,在 Application.Initialize() 中调用 this.AttachDeveloperTools();11.x 使用 Avalonia.Diagnostics 的 AttachDevTools(),两者不能同时引用。渲染覆盖层通过 TopLevel.RendererDiagnostics.DebugOverlays 设置 Fps、DirtyRects、LayoutTimeGraph、RenderTimeGraph 等标志。

主要能力:

  1. 列表虚拟化:ListBox、ComboBox 下拉、TreeView 项宿主默认虚拟化,ItemsControl 默认 StackPanel 不虚拟化,可替换为 VirtualizingStackPanel;TableView(12.1+)复用行与单元格;ItemsRepeater 在 12 中已退役。外层 ScrollViewer、StackPanel 或 Auto 高度会破坏虚拟化。
  2. 绑定优化:优先使用带 x:DataType 的编译绑定,12.0+ 无 x:DataType 的 {Binding} 无法编译;避免转换器重复分配,批量更新后统一通知属性变更。
  3. 视觉树与布局:减少嵌套元素,用 RenderTransform/Opacity 替代宽高与边距动画,IsVisible="False" 优于 Opacity="0",慎用 BoxShadow、OpacityMask、Effect 与裁剪。
  4. 图片:用 Bitmap.DecodeToWidth/DecodeToHeight 按显示尺寸解码,及时释放 Bitmap,缓存设上限。
  5. 启动与体积:PublishReadyToRun 降低 JIT 启动开销,PublishTrimmed 需配合编译绑定并处理裁剪警告;NativeAOT 在可执行项目设 PublishAot,各库设 IsAotCompatible,但动态加载 XAML、Reflection.Emit、部分第三方控件不兼容,风险高于 ReadyToRun+裁剪。
  6. 内存:在 OnDetachedFromVisualTree/Unloaded 中取消事件订阅,保存 Observable 订阅的 IDisposable,避免 VM 持有视图引用,停止 DispatcherTimer,用 gcdump 对比开闭视图前后的实例数排查泄漏。

12.x 渲染变化:12.0 大幅提升复杂场景帧率,Skia 成为唯一桌面渲染器;12.1 重构命中测试与合成器渲染数据序列化,默认启用模板缓冲,X11 与 Windows 部分渲染模式按显示器刷新率输出(可能提高 GPU/CPU 占用)。若 12.1 在特定 GPU/驱动上回退,建议带覆盖层和复现步骤提交 issue。

适用场景:Avalonia 桌面应用性能调优、列表卡顿排查、泄漏定位、启动与发布体积优化。

限制:资料主要面向 Avalonia 11.3/12.0/12.1,版本差异需按标注区分;发布步骤、RID 与安装包等细节另见 avalonia-deployment。部分具体数值与第三方控件兼容性需以实测为准,资料未逐一给出。