.NET MAUI（.NET 8 Android）软键盘覆盖输入控件问题求助

以下是几个经过验证的解决办法，针对软键盘始终覆盖底部输入控件的问题：

方法1：修改AndroidManifest的软键盘模式 #

打开项目中的Platforms/Android/AndroidManifest.xml，找到主Activity节点，添加android:windowSoftInputMode属性：

<activity android:name=".MainActivity"
          android:windowSoftInputMode="adjustResize|stateHidden">

• adjustResize：系统会自动调整窗口大小以适配软键盘空间，适合包含ScrollView的页面，输入控件会随布局调整自动上移。
• adjustPan：若页面无滚动容器，系统会将整个页面向上平移，确保输入控件可见。根据你的页面布局选择合适的参数。

方法2：自定义页面渲染器（针对顽固场景） #

如果修改Manifest后仍无效，可通过自定义渲染器强制设置软键盘行为：

1. 在Platforms/Android/Renderers目录下创建CustomPageRenderer.cs：

using Android.App;
using Android.Content;
using Android.Views;
using Microsoft.Maui.Controls.Platform;
using Microsoft.Maui.Platform;

[assembly: ExportRenderer(typeof(ContentPage), typeof(CustomPageRenderer))]
namespace YourAppNamespace.Platforms.Android.Renderers;

public class CustomPageRenderer : PageRenderer
{
    public CustomPageRenderer(Context context) : base(context) { }

    protected override void OnAttachedToWindow()
    {
        base.OnAttachedToWindow();
        // 强制设置软键盘调整模式为adjustResize
        Window?.SetSoftInputMode(SoftInput.AdjustResize);
    }
}

2. 将YourAppNamespace替换为你的项目实际命名空间，该设置会应用到所有ContentPage。

方法3：优化页面布局结构 #

确保页面布局支持滚动或自适应：

• 将页面内容包裹在ScrollView中，软键盘弹出时ScrollView会自动调整可滚动区域。你还可以在输入控件获得焦点时主动滚动到可见位置：

private async void Entry_Focused(object sender, FocusEventArgs e)
{
    if (sender is Entry entry && entry.Parent is ScrollView scrollView)
    {
        await scrollView.ScrollToAsync(entry, ScrollToPosition.Center, true);
    }
}

• 若使用Grid布局，确保输入控件所在行的RowDefinition使用Auto或*（自适应），避免固定高度导致布局无法调整。

方法4：针对.NET 8的特殊处理 #

.NET 8 MAUI在Android平台的软键盘处理存在部分已知问题，可尝试：

• 将项目更新至最新的.NET 8补丁版本（如8.0.100及以上）。
• 在MauiProgram.cs中配置自定义渲染器的注册：

builder.ConfigureMauiHandlers(handlers =>
{
#if ANDROID
    handlers.AddHandler<Page, CustomPageRenderer>();
#endif
});

若以上方法均无效，建议暂时简化页面布局（移除第三方控件或复杂自定义布局），排查是否有其他代码干扰了软键盘的默认行为。

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