如何在MAUI中移植Xamarin的OnViewAdded/OnViewRemoved原生方法重写逻辑？

在MAUI的Handler机制下，无法直接像Xamarin那样重写原生方法，需要针对不同平台的原生视图绑定对应的事件监听来实现等效逻辑。以下是各平台的具体实现方式：

Android平台实现 #

Android中Page对应的原生控件是ViewGroup子类，我们可以直接监听它的ViewAdded和ViewRemoved事件：

using Android.Views;
using Microsoft.Maui.Handlers;
using Microsoft.Maui.Platform;

public static class PageHandlerExtensions
{
    public static void BindViewLifecycleEvents(this PageHandler handler)
    {
        if (handler.PlatformView is not ViewGroup nativeViewGroup) return;

        // 先移除旧事件避免重复绑定
        nativeViewGroup.ViewAdded -= OnNativeViewAdded;
        nativeViewGroup.ViewAdded += OnNativeViewAdded;

        nativeViewGroup.ViewRemoved -= OnNativeViewRemoved;
        nativeViewGroup.ViewRemoved += OnNativeViewRemoved;
    }

    private static void OnNativeViewAdded(object sender, ViewGroup.ViewAddedEventArgs e)
    {
        // 原Xamarin中OnViewAdded的自定义逻辑写在这里
        if (sender is ViewGroup viewGroup && viewGroup.GetElement() is MyPage myPage)
        {
            var addedNativeView = e.View;
            // 执行你的业务操作
        }
    }

    private static void OnNativeViewRemoved(object sender, ViewGroup.ViewRemovedEventArgs e)
    {
        // 原Xamarin中OnViewRemoved的自定义逻辑写在这里
        if (sender is ViewGroup viewGroup && viewGroup.GetElement() is MyPage myPage)
        {
            var removedNativeView = e.View;
            // 执行你的业务操作
        }
    }
}

在MauiProgram.cs中注册Handler并绑定事件：

builder.ConfigureMauiHandlers(handlers =>
{
#if ANDROID
    handlers.AddHandler<MyPage, PageHandler>(handler =>
    {
        handler.BindViewLifecycleEvents();
        // 监听PlatformView变更，确保视图重建后重新绑定事件
        handler.PlatformViewChanged += (s, e) => ((PageHandler)s).BindViewLifecycleEvents();
    });
#endif
});

iOS平台实现 #

iOS中Page对应的原生控件是UIView，我们可以通过自定义UIView子类重写视图生命周期方法来实现：

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

public static class PageHandlerExtensions
{
    public static void BindViewLifecycleEvents(this PageHandler handler)
    {
        if (handler.PlatformView is CustomPageView customView)
        {
            customView.OnSubviewAdded = OnNativeViewAdded;
            customView.OnSubviewRemoved = OnNativeViewRemoved;
        }
    }

    private static void OnNativeViewAdded(UIView subview)
    {
        // 原Xamarin中OnViewAdded的自定义逻辑写在这里
        if (subview.Superview?.GetElement() is MyPage myPage)
        {
            // 执行你的业务操作
        }
    }

    private static void OnNativeViewRemoved(UIView subview)
    {
        // 原Xamarin中OnViewRemoved的自定义逻辑写在这里
        if (subview.Superview?.GetElement() is MyPage myPage)
        {
            // 执行你的业务操作
        }
    }
}

// 自定义iOS UIView子类，用于捕获视图添加/移除事件
public class CustomPageView : UIView
{
    public Action<UIView> OnSubviewAdded { get; set; }
    public Action<UIView> OnSubviewRemoved { get; set; }

    public override void DidAddSubview(UIView subview)
    {
        base.DidAddSubview(subview);
        OnSubviewAdded?.Invoke(subview);
    }

    public override void WillRemoveSubview(UIView subview)
    {
        base.WillRemoveSubview(subview);
        OnSubviewRemoved?.Invoke(subview);
    }
}

在MauiProgram.cs中替换原生视图并绑定事件：

builder.ConfigureMauiHandlers(handlers =>
{
#if IOS
    handlers.AddHandler<MyPage, PageHandler>(handler =>
    {
        handler.PlatformView = new CustomPageView();
        handler.BindViewLifecycleEvents();
    });
#endif
});

通用注意事项 #

• 记得在Handler的DisconnectHandler方法中移除事件监听，避免内存泄漏；
• 通过GetElement()方法可以从原生视图关联到对应的MAUI元素，方便业务逻辑关联；
• 不同平台的原生视图事件逻辑有差异，需严格遵循对应平台的原生API规范。

内容的提问来源于stack exchange，提问作者BlueRaja - Danny Pflughoeft