如何配置MAUI自定义控件库自动注册默认ModalPageHandler？

要让你的ModalPageHandler无需消费者手动注册，可通过以下两种方式实现，核心是利用MAUI的扩展方法和程序集初始化机制：

方法一：封装扩展方法（推荐，清晰可控） #

在控件库中创建静态扩展类，把Handler注册逻辑封装起来，让消费者只需一行代码启用：

1. 在控件库项目中新增ModalLibraryExtensions.cs文件：

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

namespace YourControlLibraryNamespace;

public static class ModalLibraryExtensions
{
    public static MauiAppBuilder UseModalControls(this MauiAppBuilder builder)
    {
        builder.ConfigureMauiHandlers(handlers =>
        {
            handlers.AddHandler(typeof(ModalPage), typeof(ModalPageHandler));
            // 后续新增的自定义Handler都可在此统一注册
        });
        return builder;
    }
}

2. 消费者使用时，只需在MauiProgram.cs中添加一行：

var builder = MauiApp.CreateBuilder();
builder.UseMauiApp<App>()
       .UseModalControls(); // 自动完成所有控件库的Handler注册

方法二：模块初始化器实现完全自动注册（可选，无侵入） #

如果想让消费者连调用扩展方法都省掉，可借助.NET 6+的ModuleInitializer特性，在控件库程序集加载时自动注册Handler：

在控件库中新增静态初始化类：

using System.Runtime.CompilerServices;
using Microsoft.Maui.Handlers;

namespace YourControlLibraryNamespace;

internal static class ModalLibraryInitializer
{
    [ModuleInitializer]
    public static void RegisterHandlers()
    {
        // 直接向MAUI的全局Handler映射添加注册
        PageHandlerMapper.AppendToMapping(nameof(ModalPage), (handler, view) =>
        {
            if (view is ModalPage && handler.GetType() != typeof(ModalPageHandler))
            {
                // 替换为自定义Handler实例
                var newHandler = new ModalPageHandler();
                newHandler.SetVirtualView(view);
                view.Handler = newHandler;
            }
        });
    }
}

注意：这种方式虽然完全无侵入，但存在全局冲突风险（若其他库也修改同类型Handler），因此更推荐第一种扩展方法的方式。

原理说明 #

MAUI原生控件的自动注册逻辑，本质也是通过程序集内的扩展方法+模块初始化器，在程序集加载时完成Handler与控件的映射绑定，和上述两种方法逻辑一致。

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