如何将通用Xamarin.Forms渲染器迁移为.NET MAUI处理器？

核心思路 #

你在Xamarin.Forms中通过重写Draw方法直接在控件Canvas上绘制的逻辑，在.NET MAUI中可以通过扩展现有控件Handler的行为来实现，无需创建额外平台视图——核心是复用控件原生的PlatformView，在其初始化完成后注入自定义绘制逻辑。

Android平台具体实现 #

1. 编写自定义绘制扩展 #

创建静态类封装绘制逻辑，直接复用原生View的Canvas：

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

namespace MyApp.Platforms.Android
{
    public static class CustomDrawingExtensions
    {
        public static void AddCustomDrawing(this IViewHandler handler)
        {
            if (handler.PlatformView is not View nativeView) return;

            // 保存原生Draw方法，避免覆盖后丢失原有绘制逻辑
            var originalDraw = nativeView.Draw;
            
            // 注入自定义绘制逻辑
            nativeView.Draw = canvas =>
            {
                // 先执行原生控件的绘制
                originalDraw(canvas);
                
                // 这里添加你的自定义绘制代码，示例：绘制一条红色对角线
                using var paint = new Paint();
                paint.Color = Android.Graphics.Color.Red;
                paint.StrokeWidth = 2;
                canvas.DrawLine(0, 0, nativeView.Width, nativeView.Height, paint);
            };

            // 触发重绘，确保自定义内容显示
            nativeView.Invalidate();
        }
    }
}

2. 给目标控件注册扩展 #

在MauiProgram.cs中，通过HandlerMapping给需要添加绘制的控件绑定扩展逻辑：

using Microsoft.Maui.Handlers;
using MyApp.Platforms.Android;

namespace MyApp
{
    public static class MauiProgram
    {
        public static MauiApp CreateMauiApp()
        {
            var builder = MauiApp.CreateBuilder();
            builder
                .UseMauiApp<App>()
                .ConfigureFonts(fonts =>
                {
                    fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
                });

            ConfigureCustomDrawingHandlers(builder.Services);
            return builder.Build();
        }

        private static void ConfigureCustomDrawingHandlers(IServiceCollection services)
        {
            // 通用方法批量注册多个控件
            AddDrawingToControl<XFUserControl1>(services);
            AddDrawingToControl<XFUserControl2>(services);
            AddDrawingToControl<XFUserControl3>(services);
            AddDrawingToControl<XFUserControl4>(services);
            AddDrawingToControl<XFUserControl5>(services);
        }

        private static void AddDrawingToControl<T>(IServiceCollection services) where T : Microsoft.Maui.IView
        {
            services.Configure<HandlerMapping>(mapping =>
            {
                mapping.AppendToHandler<T, ViewHandler<T, Android.Views.View>>(handler =>
                {
                    // 原生视图创建完成后注入绘制逻辑
                    handler.OnPlatformViewCreated += (_, __) => handler.AddCustomDrawing();
                });
            });
        }
    }
}

关键优势 #

• 完全复用控件原有原生视图，无额外视图包裹，保持和Xamarin.Forms一致的轻量性
• 逻辑和原渲染器对齐：先执行原生绘制，再叠加自定义内容
• 通用化注册方式适配多个控件，和你之前的ExportRenderer批量注册逻辑一致

跨平台适配参考 #

• iOS：获取原生UIView，重写DrawRect方法或添加自定义CALayer实现绘制
• Windows：监听原生FrameworkElement的OnRender事件，通过DrawingContext添加绘制内容

最佳实践 #

1. 始终先执行原生视图的绘制逻辑，避免覆盖控件原有样式
2. 绘制完成后调用对应平台的重绘方法（Android:Invalidate()/iOS:SetNeedsDisplay()）
3. 通用化注册逻辑减少重复代码，提升可维护性

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