MAUI中Text Entry的Completed事件失效，求可行替代方案

针对MAUI中Entry控件Completed事件在Android端无响应的已知问题，结合条码扫描场景，提供以下几种实用解决方案：

方案一：自定义终止字符检测（跨平台通用） #

利用TextChanged事件监听输入内容，当检测到自定义终止符（如@）时触发完成逻辑。添加状态标记避免重复执行：

private bool _isProcessing = false;

private void Entry_TextChanged(object sender, TextChangedEventArgs e)
{
    if (_isProcessing) return;
    
    var entry = sender as Entry;
    if (entry?.Text?.EndsWith("@") == true)
    {
        _isProcessing = true;
        try
        {
            // 提取有效内容（移除终止符）
            var scannedContent = entry.Text.TrimEnd('@');
            System.Diagnostics.Debug.WriteLine($"扫描完成：{scannedContent}");
            
            // 执行你的业务逻辑
            ProcessScannedData(scannedContent);
            
            // 清空输入框，准备下一次扫描
            entry.Text = string.Empty;
        }
        finally
        {
            _isProcessing = false;
        }
    }
}

方案二：Android端监听回车键事件 #

如果条码扫描器以回车键作为输入结束标记，可通过自定义Android平台Handler捕获原生控件的回车动作：

1. 创建自定义Entry Handler #

using Microsoft.Maui.Handlers;
using Android.Widget;
using Android.Views.InputMethods;

namespace YourApp.Platforms.Android
{
    public class ScannableEntryHandler : EntryHandler
    {
        protected override void ConnectHandler(EditText platformView)
        {
            base.ConnectHandler(platformView);
            // 设置输入法动作为“完成”
            platformView.SetImeOptions(ImeAction.Done);
            platformView.EditorAction += OnEditorAction;
        }

        private void OnEditorAction(object sender, TextView.EditorActionEventArgs e)
        {
            if (e.ActionId == ImeAction.Done)
            {
                var entry = VirtualView as Entry;
                // 触发原生Completed事件，复用原有事件逻辑
                entry?.SendCompleted();
                
                // 隐藏软键盘
                var imm = (InputMethodManager)Platform.CurrentActivity.GetSystemService(Android.Content.Context.InputMethodService);
                imm.HideSoftInputFromWindow(platformView.WindowToken, 0);
            }
        }

        protected override void DisconnectHandler(EditText platformView)
        {
            platformView.EditorAction -= OnEditorAction;
            base.DisconnectHandler(platformView);
        }
    }
}

2. 注册Handler #

在MauiProgram.cs中添加平台Handler注册：

builder.ConfigureMauiHandlers(handlers =>
{
#if ANDROID
    handlers.AddHandler(typeof(Entry), typeof(Platforms.Android.ScannableEntryHandler));
#endif
});

注册后，Android端按下回车键时会触发Entry的Completed事件，与Windows端逻辑保持一致。

最优方案建议 #

• 若条码扫描器支持配置终止符，优先使用方案一，实现简单且完全跨平台；
• 若需要兼容回车键结束的场景，结合方案二，在Android端补全回车事件监听，Windows端依赖原生Completed事件即可；
• 复杂场景可同时实现两种检测逻辑，确保扫描器无论发送终止符还是回车都能触发完成动作。

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