使用分部类的MAUI Handlers会替换现有处理器？自定义及类库注册问题

核心问题梳理 #

• 采用分部类实现MAUI Handlers时，会创建全新的控件实例，导致继承自MAUI原生控件的自定义控件（如CustomEntry）预定义的跨平台默认值丢失，这与Xamarin.Forms Renderers保留原有实例、继承默认属性的逻辑完全不同。
• 用于制作NuGet包的MAUI类库中，无法使用Microsoft.Maui.Handlers.EntryHandler.Mapper.AppendToMapping方法，常规的扩展映射方式不可用。
• 官方文档仅在创建原生控件场景下提及分部类Handlers，未覆盖自定义控件的处理方案，缺乏有效参考。

测试场景现象 #

• 未启用Handlers时，iOS端CustomEntry正常显示预设默认文本“this is default text”；
• 启用Handlers后，默认文本为空，原因是Handlers流程新建了Entry实例，未继承共享层定义的CustomEntry默认属性值。

类库中注册Handlers的可行方案 #

在MAUI类库中为自定义控件注册Handlers，需通过扩展IMauiHandlersCollection实现，具体步骤如下：

1. 创建类库内的注册扩展类

using Microsoft.Maui.Hosting;
using Microsoft.Maui.Handlers;

namespace YourLibraryNamespace
{
    public static class MauiHandlersRegistration
    {
        public static IMauiHandlersCollection AddCustomEntryHandlers(this IMauiHandlersCollection handlers)
        {
            // 关联自定义控件与对应Handlers
            handlers.AddHandler<CustomEntry, CustomEntryHandler>();
            return handlers;
        }
    }
}

2. 各平台实现分部类Handlers
   以iOS平台为例，在类库的iOS项目中实现Handlers，并同步跨平台控件的默认属性：

using Microsoft.Maui.Handlers;
using UIKit;

namespace YourLibraryNamespace.Platforms.iOS
{
    public partial class CustomEntryHandler : EntryHandler
    {
        protected override void ConnectHandler(UITextView platformView)
        {
            base.ConnectHandler(platformView);
            // 读取跨平台CustomEntry的属性值，同步到原生控件，避免默认值丢失
            if (VirtualView is CustomEntry customEntry)
            {
                platformView.Text = customEntry.Text;
                // 添加其他平台特定自定义逻辑
            }
        }
    }
}

3. 解决默认值丢失问题
   在Handlers的ConnectHandler或属性映射方法中，主动从VirtualView（即跨平台自定义控件实例）读取预定义属性值，同步到原生控件，而非直接忽略原有属性创建新实例。

4. Nu包使用者完成注册
   Nu包的使用者只需在项目的MauiProgram.cs中调用扩展方法，即可完成Handlers的注册：

builder.ConfigureMauiHandlers(handlers =>
{
    handlers.AddCustomEntryHandlers();
});

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