如何在MAUI中实现Page Handler？替换Xamarin Forms页面渲染器

问题背景 #

熟悉Xamarin Forms自定义渲染器，已实现两个MAUI自定义视图处理器，但在转换Xamarin Forms的iOS页面渲染器到MAUI处理器时遇到编译错误，不清楚如何映射ViewWillAppear方法。

原Xamarin Forms iOS渲染器代码：

public class MyPageRenderer : PageRenderer, IUIGestureRecognizerDelegate
{
    public override void ViewWillAppear(bool animated)
    {
        base.ViewWillAppear(animated);

        if (NavigationController != null)
        {
            NavigationController.NavigationBarHidden = true;
            NavigationController.InteractivePopGestureRecognizer.Delegate = this;
            NavigationController.InteractivePopGestureRecognizer.Enabled = true;
        }
    }
}

自行尝试的MAUI代码（编译失败）：

public partial class MyPageHandler : PageHandler
{
    public static MyCommandMapper<IContentView, IPageHandler> CommandMapper = new CommandMapper<IContentView, IPageHandler>(CommandMapper)
    {
        "ViewWillAppear" = MyViewWillAppear
    };

    protected override void ConnectHandler(ContentViewGroup platformView)
    {
        base.ConnectHandler(platformView);
    }

    protected override void DisconnectHandler(ContentViewGroup platformView)
    {
        base.DisconnectHandler(platformView);
    }

    public static void MyViewWillAppear(CustomEntryHandler handler, CustomEntry view)
    {
        if (NavigationController != null)
        {
            NavigationController.NavigationBarHidden = true;
            NavigationController.InteractivePopGestureRecognizer.Delegate = this;
            NavigationController.InteractivePopGestureRecognizer.Enabled = true;
        }
    }
}

错误分析 #

1. CommandMapper泛型参数错误：应针对IPage和IPageHandler，而非IContentView
2. 生命周期方法映射方式错误：ViewWillAppear是iOS原生视图控制器的生命周期方法，不能通过CommandMapper直接映射，需通过获取原生UIViewController处理
3. 方法参数不匹配：自定义方法参数应对应PageHandler和IPage，而非CustomEntryHandler/CustomEntry
4. NavigationController获取方式错误：MAUI中需从处理器的PlatformView（iOS端为UIViewController）获取导航控制器
5. 委托实现未正确关联：IUIGestureRecognizerDelegate需在处理器中正确实现并绑定

正确实现代码 #

using Microsoft.Maui.Handlers;
using Microsoft.Maui.Platform;
using UIKit;

namespace YourNamespace;

public class MyPageHandler : PageHandler, IUIGestureRecognizerDelegate
{
    private UIViewController? _viewController;

    protected override void ConnectHandler(UIViewController platformView)
    {
        base.ConnectHandler(platformView);
        _viewController = platformView;
        
        // 订阅ViewWillAppear事件
        _viewController.ViewWillAppear += OnViewWillAppear;
    }

    protected override void DisconnectHandler(UIViewController platformView)
    {
        if (_viewController != null)
        {
            _viewController.ViewWillAppear -= OnViewWillAppear;
            _viewController = null;
        }
        
        base.DisconnectHandler(platformView);
    }

    private void OnViewWillAppear(object? sender, EventArgs e)
    {
        if (_viewController?.NavigationController != null)
        {
            var navController = _viewController.NavigationController;
            navController.NavigationBarHidden = true;
            
            if (navController.InteractivePopGestureRecognizer != null)
            {
                navController.InteractivePopGestureRecognizer.Delegate = this;
                navController.InteractivePopGestureRecognizer.Enabled = true;
            }
        }
    }

    // 实现IUIGestureRecognizerDelegate的必要方法
    [Export("gestureRecognizerShouldBegin:")]
    public bool ShouldBegin(UIGestureRecognizer gestureRecognizer)
    {
        // 可根据需求添加自定义逻辑，默认返回true
        return true;
    }
}

注册处理器（MauiProgram.cs） #

确保在MauiProgram.cs中注册该处理器：

builder.ConfigureMauiHandlers(handlers =>
{
#if IOS
    handlers.AddHandler(typeof(YourCustomPage), typeof(MyPageHandler));
#endif
});

关键说明 #

• MAUI中iOS端的PageHandler对应的PlatformView是UIViewController，而非ContentViewGroup
• 通过订阅ViewWillAppear事件替代重写方法，避免直接修改原生控制器的生命周期
• 实现IUIGestureRecognizerDelegate时需添加[Export]特性，确保原生iOS能识别该方法
• 断开处理器时记得取消事件订阅，避免内存泄漏

内容的提问来源于stack exchange，提问作者Maxime Esprit