Flutter添加Hmong(hmn)语言时本地化功能失效求助

问题原因 #

报错核心是：Flutter官方的GlobalMaterialLocalizations和GlobalCupertinoLocalizations组件**不支持hmn（苗语）**语言代码，当应用切换到hmn locale时，这两个delegate无法找到对应本地化资源，从而抛出异常。

另外你的代码中同时注册了Translations.delegate和TranslationsHMNDelegate，两者同属LocalizationsDelegate<Translations>类型，会造成逻辑冲突——因为_TranslationsDelegate已经包含了hmn的加载逻辑，无需重复注册。

解决方案 #

方案1：为Material/Cupertino本地化添加 fallback（快速解决） #

如果不需要将Material/Cupertino组件的默认文本（如按钮、对话框提示）翻译成hmn，可以让这两个组件在hmn locale下自动回退到英文本地化：

1. 创建fallback delegate类

// Material本地化的fallback代理
class FallbackMaterialLocalizationsDelegate extends LocalizationsDelegate<MaterialLocalizations> {
  const FallbackMaterialLocalizationsDelegate();

  @override
  bool isSupported(Locale locale) => true;

  @override
  Future<MaterialLocalizations> load(Locale locale) async {
    if (locale.languageCode == 'hmn') {
      // hmn不支持时加载英文本地化资源
      return await GlobalMaterialLocalizations.delegate.load(const Locale('en'));
    }
    return await GlobalMaterialLocalizations.delegate.load(locale);
  }

  @override
  bool shouldReload(FallbackMaterialLocalizationsDelegate old) => false;
}

// Cupertino本地化的fallback代理
class FallbackCupertinoLocalizationsDelegate extends LocalizationsDelegate<CupertinoLocalizations> {
  const FallbackCupertinoLocalizationsDelegate();

  @override
  bool isSupported(Locale locale) => true;

  @override
  Future<CupertinoLocalizations> load(Locale locale) async {
    if (locale.languageCode == 'hmn') {
      return await GlobalCupertinoLocalizations.delegate.load(const Locale('en'));
    }
    return await GlobalCupertinoLocalizations.delegate.load(locale);
  }

  @override
  bool shouldReload(FallbackCupertinoLocalizationsDelegate old) => false;
}

2. 更新main.dart中的localizationsDelegates
   移除多余的TranslationsHMNDelegate，替换为上面的fallback代理：

localizationsDelegates: [
  Translations.delegate,
  FallbackMaterialLocalizationsDelegate(),
  GlobalWidgetsLocalizations.delegate,
  FallbackCupertinoLocalizationsDelegate(),
],
locale: value.appLocale,
supportedLocales: [const Locale('en'), const Locale('hmn')],

方案2：自定义Material/Cupertino本地化（完全本地化组件文本） #

如果需要将Material/Cupertino组件的默认文本也翻译成hmn，需要手动实现对应的本地化类：

1. 自定义HmnMaterialLocalizations

class HmnMaterialLocalizations extends GlobalMaterialLocalizations {
  HmnMaterialLocalizations(Locale locale) : super(locale);

  static const LocalizationsDelegate<MaterialLocalizations> delegate = _HmnMaterialLocalizationsDelegate();

  // 重写需要本地化的Material文本方法，替换为hmn翻译
  @override
  String get okButtonLabel => '你的hmn翻译文本';
  @override
  String get cancelButtonLabel => '你的hmn翻译文本';
  @override
  String get saveButtonLabel => '你的hmn翻译文本';
  // 按需重写其他方法，比如alertDialogLabel、closeButtonLabel等
}

class _HmnMaterialLocalizationsDelegate extends LocalizationsDelegate<MaterialLocalizations> {
  const _HmnMaterialLocalizationsDelegate();

  @override
  bool isSupported(Locale locale) => locale.languageCode == 'hmn';

  @override
  Future<MaterialLocalizations> load(Locale locale) async {
    return HmnMaterialLocalizations(locale);
  }

  @override
  bool shouldReload(_HmnMaterialLocalizationsDelegate old) => false;
}

2. 同理自定义HmnCupertinoLocalizations

class HmnCupertinoLocalizations extends GlobalCupertinoLocalizations {
  HmnCupertinoLocalizations(Locale locale) : super(locale);

  static const LocalizationsDelegate<CupertinoLocalizations> delegate = _HmnCupertinoLocalizationsDelegate();

  // 重写需要本地化的Cupertino文本方法
  @override
  String get alertDialogOkButtonLabel => '你的hmn翻译文本';
  @override
  String get alertDialogCancelButtonLabel => '你的hmn翻译文本';
  // 按需重写其他方法
}

class _HmnCupertinoLocalizationsDelegate extends LocalizationsDelegate<CupertinoLocalizations> {
  const _HmnCupertinoLocalizationsDelegate();

  @override
  bool isSupported(Locale locale) => locale.languageCode == 'hmn';

  @override
  Future<CupertinoLocalizations> load(Locale locale) async {
    return HmnCupertinoLocalizations(locale);
  }

  @override
  bool shouldReload(_HmnCupertinoLocalizationsDelegate old) => false;
}

3. 更新main.dart中的localizationsDelegates
   将自定义的delegate放在官方delegate之前，确保优先加载：

localizationsDelegates: [
  Translations.delegate,
  HmnMaterialLocalizations.delegate,
  GlobalMaterialLocalizations.delegate,
  GlobalWidgetsLocalizations.delegate,
  HmnCupertinoLocalizations.delegate,
  GlobalCupertinoLocalizations.delegate,
],
locale: value.appLocale,
supportedLocales: [const Locale('en'), const Locale('hmn')],

额外注意点 #

• 必须移除代码中多余的TranslationsHMNDelegate，避免同类型delegate冲突。
• 确保HmnTranslations类正确重写了Translations中的所有翻译方法，避免出现未本地化的文本。

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