将Xamarin Forms自定义ViewRenderer迁移至MAUI遇布局异常问题

正在将Xamarin Forms应用迁移到MAUI，原项目中通过自定义渲染器KeyboardGridRenderer实现点击Entry时调整Grid的Margin，避免输入框被键盘遮挡。按照官方文档迁移后，用ConfigureMauiHandlers注册兼容渲染器，却出现页面元素超出屏幕的问题，换成普通Grid则渲染正常。尝试转成MAUI原生Handler，但不清楚Xamarin的ViewRenderer对应MAUI的什么类型。

解决方案 #

• 替换兼容渲染器为MAUI原生Handler：MAUI不再使用Xamarin的ViewRenderer，改用原生Handler实现平台自定义逻辑。针对iOS平台，创建KeyboardGridHandler替代原渲染器，并调整布局逻辑避免元素溢出。

步骤1：创建iOS平台原生Handler #

在项目的Platforms/iOS目录下新建KeyboardGridHandler.cs，代码如下：

using UIKit;
using Foundation;
using CoreGraphics;
using Microsoft.Maui.Handlers;
using Microsoft.Maui.Controls;

namespace TestLink.Platforms.iOS
{
    public class KeyboardGridHandler : ViewHandler<KeyboardGrid, UIView>
    {
        private NSObject _keyboardShowObserver;
        private NSObject _keyboardHideObserver;

        protected override UIView CreatePlatformView()
        {
            return new UIView();
        }

        protected override void ConnectHandler(UIView platformView)
        {
            base.ConnectHandler(platformView);
            RegisterForKeyboardNotifications();
        }

        protected override void DisconnectHandler(UIView platformView)
        {
            UnregisterForKeyboardNotifications();
            base.DisconnectHandler(platformView);
        }

        private void RegisterForKeyboardNotifications()
        {
            _keyboardShowObserver?.Dispose();
            _keyboardHideObserver?.Dispose();

            _keyboardShowObserver = UIKeyboard.Notifications.ObserveWillShow(OnKeyboardShow);
            _keyboardHideObserver = UIKeyboard.Notifications.ObserveWillHide(OnKeyboardHide);
        }

        private void OnKeyboardShow(object sender, UIKeyboardEventArgs args)
        {
            if (VirtualView == null) return;

            NSValue frameValue = args.Notification.UserInfo[UIKeyboard.FrameEndUserInfoKey] as NSValue;
            CGSize keyboardSize = frameValue?.RectangleFValue.Size ?? CGSize.Empty;
            
            // 改用Padding替代Margin，避免布局溢出
            VirtualView.Padding = new Thickness(0, 0, 0, keyboardSize.Height);
        }

        private void OnKeyboardHide(object sender, UIKeyboardEventArgs args)
        {
            if (VirtualView == null) return;
            VirtualView.Padding = new Thickness(0);
        }

        private void UnregisterForKeyboardNotifications()
        {
            _keyboardShowObserver?.Dispose();
            _keyboardHideObserver?.Dispose();
            _keyboardShowObserver = null;
            _keyboardHideObserver = null;
        }
    }
}

步骤2：注册Handler到MAUI #

修改MauiProgram.cs，在ConfigureMauiHandlers中注册自定义Handler：

using Microsoft.Maui.Hosting;
using TestLink;
using TestLink.Platforms.iOS;

namespace TestLink
{
    public static class MauiProgram
    {
        public static MauiApp CreateMauiApp()
        {
            var builder = MauiApp.CreateBuilder();
            builder
                .UseMauiApp<App>()
                .ConfigureFonts(fonts =>
                {
                    fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
                    fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
                })
                .ConfigureMauiHandlers(handlers =>
                {
#if IOS
                    handlers.AddHandler<KeyboardGrid, KeyboardGridHandler>();
#endif
                });

            return builder.Build();
        }
    }
}

步骤3：修复布局溢出问题 #

原代码修改Margin会导致Grid布局范围超出屏幕，改用修改Padding让子元素在Grid内部调整位置。KeyboardGrid类保持不变：

namespace TestLink
{
    public class KeyboardGrid : Grid
    {
    }
}

步骤4：验证效果 #

保持MainPage.xaml不变，运行项目后点击Entry，Grid会自动调整内部Padding，既避免输入框被键盘遮挡，又不会出现元素超出屏幕的情况。

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