Microsoft.UI.Xaml 中 FocusVisualKind.Reveal 导致应用崩溃问题解析

问题概述

在 Windows App SDK 1.6.0 版本中，开发者报告了一个严重的 UI 交互问题：当在应用程序中设置 FocusVisualKind = FocusVisualKind.Reveal 后，通过 TAB 键进行焦点切换时，应用会在第二次或第三次焦点切换时崩溃。这个崩溃问题在之前的 1.5 版本中并不存在，属于明显的回归性问题。

技术背景

FocusVisualKind 是 WinUI 3 中控制焦点视觉效果的枚举类型，它决定了当 UI 元素获得焦点时如何显示视觉反馈。Reveal 是其中一种视觉效果风格，它源自 Fluent Design 系统，通过微妙的发光和动画效果来指示当前获得焦点的元素。

问题表现

当开发者按照常规方式在 App.xaml.cs 中设置：

public App()
{
    this.InitializeComponent();
    FocusVisualKind = FocusVisualKind.Reveal;
}

然后通过键盘 TAB 键在界面元素间切换焦点时，应用会在第二次或第三次焦点切换时抛出异常并崩溃。错误信息显示这是一个持续时间(Duration)参数无效的问题，具体错误为：

WinRT originate error - 0x80070057 : 'An invalid Duration is specified. It must be >= 1ms and <= 24 days'

问题根源

经过微软开发团队分析，这个问题是由于在 1.6 版本中对焦点视觉动画的持续时间处理出现了逻辑错误。当使用 Reveal 效果时，系统尝试设置一个无效的动画持续时间值，这个值可能小于 1 毫秒或者格式不正确，导致 WinRT 运行时抛出参数无效异常。

影响范围

这个问题影响所有使用 WinUI 3 1.6.0 版本并启用了 FocusVisualKind.Reveal 效果的应用程序。对于那些依赖键盘导航的应用（如工具类应用、无障碍应用等），这个问题尤为严重，因为它会直接导致应用崩溃，影响用户体验。

解决方案

微软团队已经确认修复了这个问题，并将在下一个 WinAppSDK 1.6 的更新版本中发布修复。对于急需解决此问题的开发者，可以考虑以下临时解决方案：

1. 降级到 1.5 版本：如果不依赖 1.6 的新特性，可以暂时回退到稳定的 1.5 版本。

2. 使用其他焦点视觉效果：将 FocusVisualKind 设置为 DottedLine 或其他可用选项，避免使用 Reveal 效果。

3. 自定义焦点样式：通过 XAML 样式完全自定义焦点视觉效果，绕过系统默认实现。

最佳实践建议

1. 版本升级测试：在升级 WinUI 版本时，应全面测试所有 UI 交互场景，特别是键盘导航和焦点相关功能。

2. 异常处理：对于关键的用户交互路径，添加适当的异常处理逻辑，避免应用直接崩溃。

3. 关注发布说明：定期查看官方发布说明，了解已知问题和修复情况。

总结

这个问题的出现提醒我们，即使是成熟的 UI 框架，在版本更新时也可能引入回归性问题。作为开发者，我们需要建立完善的测试流程，特别是在视觉和交互相关的功能上。微软团队已经确认修复此问题，建议开发者关注后续更新，及时升级到修复后的版本。