Xamarin.Forms聊天应用键盘消失白屏，如何实现平滑过渡？

我之前开发Xamarin.Forms聊天应用时也碰到过一模一样的问题——用Resize模式虽然能让输入框跟着键盘上移，但隐藏键盘时的白屏卡顿实在影响体验；换成Pan模式又会被键盘挡住输入框，完全没法用。后来摸索出几个可行的方案，能实现类似WhatsApp的平滑键盘过渡效果，分享给你：

方案一：自定义安卓渲染器调整窗口动画 #

这种方法通过自定义页面渲染器，在键盘隐藏时手动调整窗口动画效果，避免白屏出现：

1. 在共享项目中定义一个自定义页面类：

public class ChatPage : ContentPage
{
}

2. 在安卓项目中添加自定义渲染器：

[assembly: ExportRenderer(typeof(ChatPage), typeof(ChatPageRenderer))]
namespace YourAppName.Droid.Renderers
{
    public class ChatPageRenderer : PageRenderer
    {
        public ChatPageRenderer(Context context) : base(context)
        {
        }

        protected override void OnElementChanged(ElementChangedEventArgs<Page> e)
        {
            base.OnElementChanged(e);

            if (e.NewElement != null)
            {
                // 初始设置为Resize模式
                App.Current.On<Xamarin.Forms.PlatformConfiguration.Android>()
                    .UseWindowSoftInputModeAdjust(WindowSoftInputModeAdjust.Resize);

                // 监听页面布局变化判断键盘状态
                var rootView = (ViewGroup)ViewGroup.GetChildAt(0);
                rootView.ViewTreeObserver.GlobalLayout += RootView_GlobalLayout;
            }
        }

        private void RootView_GlobalLayout(object sender, EventArgs e)
        {
            var rootView = (ViewGroup)sender;
            Rect displayFrame = new Rect();
            rootView.GetWindowVisibleDisplayFrame(displayFrame);
            int screenHeight = rootView.RootView.Height;
            int keypadHeight = screenHeight - displayFrame.Bottom;

            // 判定键盘从显示转为隐藏时，启用平滑动画
            if (keypadHeight < screenHeight * 0.15)
            {
                Window.SetWindowAnimations(Resource.Style.WindowAnimation_SmoothKeyboardHide);
            }
            else
            {
                // 键盘显示时恢复默认动画
                Window.SetWindowAnimations(Resource.Style.Base_Animation_AppCompat);
            }
        }
    }
}

3. 在安卓项目的Resources/values/styles.xml中添加自定义动画样式：

<style name="WindowAnimation_SmoothKeyboardHide">
    <item name="android:windowExitAnimation">@android:anim/fade_out</item>
    <item name="android:windowEnterAnimation">@android:anim/fade_in</item>
</style>

你也可以替换成平移类动画，只要对应安卓原生动画资源即可，找到你觉得最自然的过渡效果。

方案二：结合Pan模式和输入框位置动态调整 #

如果不想写原生渲染器，也可以用Pan模式配合键盘高度监听，手动调整输入框位置：

1. 先设置Pan模式：

App.Current.On<Xamarin.Forms.PlatformConfiguration.Android>()
    .UseWindowSoftInputModeAdjust(WindowSoftInputModeAdjust.Pan);

2. 在聊天页面中监听键盘状态，动态调整输入框所在布局的位置：

// 假设输入框放在名为inputContainer的布局中
protected override void OnAppearing()
{
    base.OnAppearing();
    Xamarin.Essentials.KeyboardListener.Instance.KeyboardInfoChanged += OnKeyboardInfoChanged;
}

protected override void OnDisappearing()
{
    base.OnDisappearing();
    Xamarin.Essentials.KeyboardListener.Instance.KeyboardInfoChanged -= OnKeyboardInfoChanged;
}

private void OnKeyboardInfoChanged(object sender, Xamarin.Essentials.KeyboardInfoChangedEventArgs e)
{
    // 根据键盘可见性调整布局位置
    if (e.KeyboardInfo.IsVisible)
    {
        inputContainer.TranslationY = -e.KeyboardInfo.Height;
    }
    else
    {
        inputContainer.TranslationY = 0;
    }
}

这里可以用Xamarin.Essentials的键盘监听功能，也可以自己写安卓依赖服务获取键盘高度。这种方式完全用Xamarin.Forms API实现，过渡动画还能自己用Animation类进一步优化。

方案三：借助第三方成熟库 #

还有一些现成的第三方库已经封装好了键盘适配逻辑，比如Xamarin.Forms.InputKit，这类库能直接实现平滑的键盘过渡效果，省去自己造轮子的麻烦，适合快速解决问题。

我个人更推荐方案一，它更贴近原生安卓的处理逻辑，能完美复刻WhatsApp的平滑消失体验。你可以根据项目实际情况选择合适的方案尝试。

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