Xamarin.Forms 如何通过编程方式选择指定键盘语言

Xamarin.Forms 官方没有提供跨平台的直接API来指定输入框唤起的键盘语言，但可以通过自定义渲染器分别对接Android、iOS原生API实现该需求，只要设备已安装目标语言的输入法即可生效，以下是完整实现方案：

实现前提 #

• 用户设备已安装目标语言（本例为马拉雅拉姆语）的键盘布局/输入法
• 仅支持遵守系统输入法规范的输入法，部分不遵守规范的第三方输入法可能无法生效

公共层自定义控件实现 #

在共享项目中自定义支持指定键盘语言的Entry控件：

// 共享项目代码
public class LocalizedKeyboardEntry : Entry
{
    // 绑定属性：指定键盘的语言标识，马拉雅拉姆语传"ml-IN"
    public static readonly BindableProperty KeyboardLocaleProperty =
        BindableProperty.Create(nameof(KeyboardLocale), typeof(string), typeof(LocalizedKeyboardEntry), string.Empty);

    public string KeyboardLocale
    {
        get => (string)GetValue(KeyboardLocaleProperty);
        set => SetValue(KeyboardLocaleProperty, value);
    }
}

Android 端自定义渲染器实现 #

在Android平台项目中添加渲染器：

using Android.Content;
using Android.OS;
using Android.Views.InputMethods;
using Android.Widget;
using Xamarin.Forms;
using Xamarin.Forms.Platform.Android;

// 注意替换为你自己项目的命名空间
[assembly: ExportRenderer(typeof(LocalizedKeyboardEntry), typeof(YourAppNamespace.Droid.Renderers.LocalizedKeyboardEntryRenderer))]
namespace YourAppNamespace.Droid.Renderers
{
    public class LocalizedKeyboardEntryRenderer : EntryRenderer
    {
        public LocalizedKeyboardEntryRenderer(Context context) : base(context) { }

        protected override void OnElementChanged(ElementChangedEventArgs<Entry> e)
        {
            base.OnElementChanged(e);
            if (Control == null || e.NewElement is not LocalizedKeyboardEntry localizedEntry) return;
            
            Control.FocusChange += (sender, focusArgs) =>
            {
                // 输入框获取焦点时触发键盘语言切换
                if (focusArgs.HasFocus && !string.IsNullOrEmpty(localizedEntry.KeyboardLocale))
                {
                    var targetLocale = Java.Util.Locale.ForLanguageTag(localizedEntry.KeyboardLocale);
                    if (Build.VERSION.SdkInt >= BuildVersionCodes.N)
                    {
                        // Android 7.0+ 官方API，给输入法发送语言提示
                        Control.SetImeHintLocales(new LocaleList(targetLocale));
                    }
                    else
                    {
                        // 低版本兼容方案
                        Java.Util.Locale.Default = targetLocale;
                        Control.OnCreateInputConnection(new EditorInfo())?.SetSelection(Control.Text?.Length ?? 0, Control.Text?.Length ?? 0);
                    }
                }
            };
        }
    }
}

iOS 端自定义渲染器实现 #

在iOS平台项目中添加渲染器：

using UIKit;
using Xamarin.Forms;
using Xamarin.Forms.Platform.iOS;
using System.Linq;

// 注意替换为你自己项目的命名空间
[assembly: ExportRenderer(typeof(LocalizedKeyboardEntry), typeof(YourAppNamespace.iOS.Renderers.LocalizedKeyboardEntryRenderer))]
namespace YourAppNamespace.iOS.Renderers
{
    public class LocalizedKeyboardEntryRenderer : EntryRenderer
    {
        protected override void OnElementChanged(ElementChangedEventArgs<Entry> e)
        {
            base.OnElementChanged(e);
            if (Control != null)
            {
                // 输入框开始编辑时刷新输入视图
                Control.Started += (sender, args) => Control.ReloadInputViews();
            }
        }

        // 重写输入模式属性，返回指定语言的输入法
        public override UITextInputMode TextInputMode
        {
            get
            {
                if (Element is LocalizedKeyboardEntry localizedEntry && !string.IsNullOrEmpty(localizedEntry.KeyboardLocale))
                {
                    var targetLang = localizedEntry.KeyboardLocale.ToLower();
                    return UITextInputMode.AllInputModes.FirstOrDefault(m => m.PrimaryLanguage == targetLang) ?? base.TextInputMode;
                }
                return base.TextInputMode;
            }
        }
    }
}

使用示例 #

在XAML页面中直接使用自定义控件即可：

<ContentPage 
    xmlns:local="clr-namespace:YourAppNamespace"
    ...>
    <!-- 指定键盘为马拉雅拉姆语 -->
    <local:LocalizedKeyboardEntry
        Placeholder="请输入搜索内容"
        KeyboardLocale="ml-IN" />
</ContentPage>

注意事项 #

• 若设备未安装指定语言的输入法，会自动 fallback 到系统默认键盘，不会出现异常
• 部分第三方输入法可能不支持系统的语言切换提示，这种场景下无法保证切换效果，优先适配系统自带输入法
• 不需要申请额外的系统权限，所有实现均基于各平台公开API

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