MAUI中为特定页面设置WindowSoftInputModeAdjust为Resize的解决方案

核心问题分析 #

直接在页面OnAppearing/OnDisappearing中切换模式没生效，大概率是没正确获取Android平台当前Activity实例，或是切换时机晚于键盘弹出触发逻辑；返回主页UI异常则是因为评论页的模式未正确还原，导致主页误用Resize模式。

具体实现步骤 #

1. 封装平台特定模式切换工具类 #

在Android项目中创建静态工具类，负责统一管理窗口软键盘调整模式：

using Android.App;
using Android.Views;

namespace YourAppName.Platforms.Android;

public static class SoftInputModeHelper
{
    public static void SetResizeMode()
    {
        if (Platform.CurrentActivity != null)
        {
            Platform.CurrentActivity.Window.SetSoftInputMode(SoftInput.AdjustResize);
        }
    }

    public static void SetPanMode()
    {
        if (Platform.CurrentActivity != null)
        {
            Platform.CurrentActivity.Window.SetSoftInputMode(SoftInput.AdjustPan);
        }
    }
}

2. 在评论页中精准切换模式 #

在评论页代码中，调用工具类完成模式切换，确保页面显示前设置Resize、消失后强制还原Pan：

using YourAppName.Platforms.Android;

public partial class CommentPage : ContentPage
{
    public CommentPage()
    {
        InitializeComponent();
    }

    protected override void OnAppearing()
    {
        base.OnAppearing();
        // 页面显示前提前设置Resize，避免键盘弹出时头部被遮挡
        SoftInputModeHelper.SetResizeMode();
    }

    protected override void OnDisappearing()
    {
        base.OnDisappearing();
        // 页面消失立即还原Pan模式
        SoftInputModeHelper.SetPanMode();
    }
}

3. 修复返回主页UI异常 #

若OnDisappearing触发时机滞后，可额外在导航离开事件中再执行一次模式还原：

protected override void OnNavigatedFrom(NavigatedFromEventArgs args)
{
    base.OnNavigatedFrom(args);
    SoftInputModeHelper.SetPanMode();
}

4. 确认MainActivity默认设置 #

确保MainActivity中默认配置为Pan模式：

namespace YourAppName.Platforms.Android;

[Activity(Theme = "@style/Maui.SplashTheme", MainLauncher = true, ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.UiMode | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize | ConfigChanges.Density, WindowSoftInputMode = SoftInput.AdjustPan)]
public class MainActivity : MauiAppCompatActivity
{
}

关键注意事项 #

• 必须通过Platform.CurrentActivity获取当前Activity实例，避免拿到无效窗口对象
• 评论页的Resize模式要在OnAppearing中执行，确保键盘弹出前模式已生效
• 还原Pan模式需同时在OnDisappearing和OnNavigatedFrom中执行，保证页面切换时模式100%还原

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