从Xamarin.Forms迁移至MAUI：iOS页面侧滑返回功能适配求助

问题背景 #

从Xamarin.Forms迁移到MAUI时，原iOS端通过PageRenderer实现的侧滑返回逻辑无法直接复用：

• 兼容模式复用原PageRenderer代码导致应用崩溃
• 改为继承PageHandler并重写ConnectHandler时，NavigationController始终为空

需求：无需自定义Page类型、无需在每个页面编写OnAppearing方法，将页面侧滑返回权限与ViewModel的ShouldNavigateBack()方法绑定。

原Xamarin.Forms实现代码：

public class BaseCoreRenderer : PageRenderer
{
    public override void ViewWillAppear(bool animated)
    {
        base.ViewWillAppear(animated);
        if (ViewController?.NavigationController?.InteractivePopGestureRecognizer == null)
        {
            return;
        }

        ViewController.NavigationController.InteractivePopGestureRecognizer.Enabled = true;
        ViewController.NavigationController.InteractivePopGestureRecognizer.Delegate = null;
        ViewController.NavigationController.InteractivePopGestureRecognizer.ShouldBegin = OnShouldBegin;
    }

    private bool OnShouldBegin(UIGestureRecognizer recognizer)
    {
        if (NavigationController?.ViewControllers?.Length == 1)
        {
            return false;
        }
        if (Element is Page page && page.BindingContext is ViewModelBase viewModelBase)
        {
            return viewModelBase.ShouldNavigateBack();
        }

        return true;
    }
}

解决方案 #

在MAUI中，需通过PageHandler结合iOS生命周期事件实现，核心是在页面加入导航栈后再获取NavigationController：

1. 实现自定义PageHandler #

using Microsoft.Maui.Handlers;
using UIKit;

namespace YourNamespace.Platforms.iOS
{
    public class CustomPageHandler : PageHandler
    {
        private UIGestureRecognizerDelegate? _gestureDelegate;

        protected override void ConnectHandler(Microsoft.Maui.Controls.VisualElement platformView)
        {
            base.ConnectHandler(platformView);
            
            // 订阅ViewController的ViewWillAppear事件，此时页面已加入导航栈
            if (ViewController != null)
            {
                ViewController.ViewWillAppear += OnViewWillAppear;
            }
        }

        protected override void DisconnectHandler(Microsoft.Maui.Controls.VisualElement platformView)
        {
            if (ViewController != null)
            {
                ViewController.ViewWillAppear -= OnViewWillAppear;
                // 清理委托避免内存泄漏
                if (ViewController.NavigationController?.InteractivePopGestureRecognizer != null)
                {
                    ViewController.NavigationController.InteractivePopGestureRecognizer.ShouldBegin = null;
                    ViewController.NavigationController.InteractivePopGestureRecognizer.Delegate = _gestureDelegate;
                }
            }
            
            base.DisconnectHandler(platformView);
        }

        private void OnViewWillAppear(object? sender, EventArgs e)
        {
            var navController = ViewController?.NavigationController;
            if (navController?.InteractivePopGestureRecognizer == null)
                return;

            // 保存原始Delegate，断开时恢复
            _gestureDelegate = navController.InteractivePopGestureRecognizer.Delegate;
            
            navController.InteractivePopGestureRecognizer.Enabled = true;
            navController.InteractivePopGestureRecognizer.Delegate = null;
            navController.InteractivePopGestureRecognizer.ShouldBegin = OnShouldBegin;
        }

        private bool OnShouldBegin(UIGestureRecognizer recognizer)
        {
            var navController = ViewController?.NavigationController;
            // 根页面不允许侧滑返回
            if (navController?.ViewControllers.Length == 1)
                return false;

            // 绑定ViewModel的ShouldNavigateBack方法
            if (Element is Microsoft.Maui.Controls.Page page && page.BindingContext is ViewModelBase viewModel)
            {
                return viewModel.ShouldNavigateBack();
            }

            return true;
        }
    }
}

2. 注册自定义Handler #

在MauiProgram.cs中注册该Handler：

using YourNamespace.Platforms.iOS;

builder.ConfigureMauiHandlers(handlers =>
{
#if IOS
    handlers.AddHandler(typeof(Microsoft.Maui.Controls.Page), typeof(CustomPageHandler));
#endif
});

API说明 #

• InteractivePopGestureRecognizer并未被弃用，MAUI完全支持通过原生iOS API直接调用该控件。
• 原Xamarin.Forms的PageRenderer在MAUI中已被Handler模式替代，直接复用会因生命周期和对象关系变化导致崩溃。

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