.NET MAUI应用中系统UI按钮翻译问题咨询

核心结论 #

系统原生UI元素（如Picker的Done按钮、Alert的默认按钮）的文本由平台系统语言控制，无法仅通过设置CultureInfo或.NET MAUI资源文件直接覆盖。不需要为每个系统按钮单独写自定义Handler，但必须通过平台特定代码或自定义UI逻辑来替换文本，实现跟随应用内语言切换。

分平台处理方案 #

iOS平台 #

iOS系统原生UI组件（如UIBarButtonSystemItem、UIAlertController默认按钮）的文本绑定系统语言，而非应用线程文化，需手动替换为资源文件中的翻译值：

1. Entry/Picker的工具栏按钮修改
   你当前的EntryKeyboardHandler使用了系统预设的UIBarButtonSystemItem.Done，需改为从资源文件读取翻译文本，而非依赖系统按钮：

   #if IOS
   using Microsoft.Maui.Platform;
   using System.Drawing;
   using UIKit;
   
   namespace MyApp;
   
   public class EntryKeyboardHandler : Microsoft.Maui.Handlers.EntryHandler
   {
       protected override void ConnectHandler(MauiTextField platformView)
       {
           base.ConnectHandler(platformView);
   
           var toolbar = new UIToolbar(new RectangleF(0.0f, 0.0f, 50.0f, 44.0f));
           // 从资源文件获取翻译后的"Done"文本
           var doneText = AppResources.Done;
           var doneButton = new UIBarButtonItem(doneText, UIBarButtonItemStyle.Done, delegate
           {
               this.PlatformView.EndEditing(true);
           });
   
           toolbar.Items = new UIBarButtonItem[]
           {
               new UIBarButtonItem (UIBarButtonSystemItem.FlexibleSpace),
               doneButton
           };
   
           this.PlatformView.InputAccessoryView = toolbar;
       }
   }
   #endif
   

   Picker的处理逻辑完全类似，只需自定义PickerHandler，替换其原生视图的输入工具栏按钮文本。

2. 系统Alert按钮自定义
   调用iOS原生UIAlertController时，手动传入资源文件中的翻译文本，而非使用系统默认按钮类型：

   var alert = UIAlertController.Create(AppResources.AlertTitle, AppResources.AlertContent, UIAlertControllerStyle.Alert);
   alert.AddAction(UIAlertAction.Create(AppResources.Cancel, UIAlertActionStyle.Cancel, null));
   alert.AddAction(UIAlertAction.Create(AppResources.Ok, UIAlertActionStyle.Default, null));
   Platform.CurrentActivity?.PresentViewController(alert, true, null);
   

Android平台 #

Android系统UI元素默认可跟随应用配置的Locale，但需在切换语言时更新应用配置：

1. 更新应用Locale配置
   在切换语言的代码中添加以下逻辑，确保系统UI组件感知语言变化：

   CultureInfo newCulture = new CultureInfo(value.Key);
   
   CultureInfo.DefaultThreadCurrentCulture = newCulture;
   CultureInfo.DefaultThreadCurrentUICulture = newCulture;
   
   LocalizationResourceManager.CurrentCulture = newCulture;
   LanguageResourceManager.Instance.SetCulture(newCulture);
   
   // Android平台额外配置
   #if ANDROID
   var activity = Platform.CurrentActivity;
   if (activity != null)
   {
       var config = activity.Resources.Configuration;
       config.SetLocale(newCulture);
       activity.Resources.UpdateConfiguration(config, activity.Resources.DisplayMetrics);
   }
   #endif
   

2. Alert按钮与输入法处理

   • 使用MAUI跨平台DisplayAlert时，直接传入翻译后的按钮文本：

     await DisplayAlert(AppResources.AlertTitle, AppResources.AlertContent, AppResources.Ok, AppResources.Cancel);
     

   • 系统输入法的Done按钮文本由输入法自身语言设置决定，若需完全自定义，需像iOS一样实现应用内输入工具栏替代系统输入法工具栏。

优化建议 #

• 封装通用平台工具类，比如PlatformLocalizationHelper，提供获取翻译文本、替换原生UI组件文本的方法，避免重复代码。
• 对于MAUI的跨平台组件（Entry、Picker等），可创建基类Handler统一处理文本替换逻辑，减少重复实现。

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