CommunityToolkit.Maui中Popup二次显示失效问题分析与解决方案

在.NET MAUI开发中，CommunityToolkit.Maui是一个广受欢迎的扩展工具包，它提供了许多实用的功能来简化开发流程。其中，Popup控件是开发者常用的组件之一，用于实现各种弹窗交互。然而，在MAUI 8.0.60版本中，开发者发现了一个影响Popup正常工作的关键问题。

问题现象

当使用CommunityToolkit.Maui的Popup功能时，开发者遇到了一个奇怪的现象：第一次显示Popup时一切正常，但当尝试第二次显示Popup时，弹窗无法正常显示。更严重的是，如果开发者使用了CommunityToolkit.MVVM中的RelayCommand，触发Popup的按钮会被禁用，因为相关Task无法正常完成。

问题根源

经过深入分析，这个问题源于Popup的Loaded事件没有被正确触发。在CommunityToolkit.Maui的PopupExtensions.shared.cs文件中，Popup的显示依赖于Loaded事件的触发来完成TaskCompletionSource。当Loaded事件没有被触发时，TaskCompletionSource就无法完成，导致相关Task一直处于运行状态，进而造成UI按钮被禁用。

这个问题与MAUI框架在8.0.60版本中的一个修复有关，该修复改变了页面加载的行为模式。值得注意的是，这个问题仅出现在Windows平台上，Android平台不受影响。

临时解决方案

在官方修复发布前，开发者可以采用以下临时解决方案：

1. 对于使用CommunityToolkit.MVVM的情况，可以将[RelayCommand]改为[RelayCommand(AllowConcurrentExecutions = true)]，这样可以避免按钮被禁用。

2. 修改PopupExtensions.shared.cs文件中的相关代码，添加对Unload事件的处理：

var taskCompletionSource = new TaskCompletionSource<object?>();

void unloadedHandler(object? sender, EventArgs args) => {};

async void loadedHandler(object? sender, EventArgs args)
{
    page.GetCurrentPage().Unloaded -= unloadedHandler;
    page.GetCurrentPage().Loaded -= loadedHandler;

    try
    {
        var result = await CreateAndShowPopupAsync(page, popup, token);
        taskCompletionSource.TrySetResult(result);
    }
    catch (Exception ex)
    {
        taskCompletionSource.TrySetException(ex);
    }
}

page.GetCurrentPage().Unloaded += unloadedHandler;
page.GetCurrentPage().Loaded += loadedHandler;

return taskCompletionSource.Task.WaitAsync(token);

官方修复

MAUI团队已经意识到了这个问题，并在后续的8.0.61-ci.net8.24319.3夜间构建版本中提供了修复。开发者可以通过获取最新的夜间构建版本来解决这个问题。

总结

Popup控件在MAUI应用开发中扮演着重要角色，这个问题的出现提醒我们在框架升级时需要特别注意兼容性问题。对于开发者来说，了解问题的根源和解决方案有助于在遇到类似情况时快速应对。同时，这也展示了开源社区的优势——问题能够被快速发现、分析和解决。

建议开发者在升级MAUI版本时，充分测试Popup相关功能，特别是在多平台上的表现。对于生产环境，建议等待稳定版本的修复发布，而非直接使用夜间构建版本。