如何在Flutter中结合GetX复用库中的多语言字符串资源

1. 创建独立的Flutter多语言包 #

先搭建一个可复用的Flutter包，专门存放所有多语言字符串：

• 执行命令创建包：flutter create --template=package my_localization_lib
• 包的核心目录结构建议：

  my_localization_lib/
    lib/
      lang/
        en.dart
        zh_cn.dart
        // 其他语言文件...
      my_localizations.dart // GetX翻译类
    pubspec.yaml
  

2. 配置包内的GetX多语言 #

• 在包的pubspec.yaml中添加GetX依赖：

  dependencies:
    get: ^4.6.5 # 替换为最新稳定版
  

• 编写语言文件，比如lang/en.dart：

  const Map<String, String> en = {
    'welcome': 'Welcome',
    'login_btn': 'Login',
    'logout_msg': 'Are you sure you want to logout?'
  };
  

  lang/zh_cn.dart：

  const Map<String, String> zhCn = {
    'welcome': '欢迎',
    'login_btn': '登录',
    'logout_msg': '确定要退出登录吗？'
  };
  

• 创建GetX翻译类my_localizations.dart：

  import 'package:get/get.dart';
  import 'lang/en.dart';
  import 'lang/zh_cn.dart';
  
  class MyLocalizations extends Translations {
    @override
    Map<String, Map<String, String>> get keys => {
          'en_US': en,
          'zh_CN': zhCn,
          // 其他语言映射...
        };
  }
  

• 可选：在包中添加初始化方法，简化主项目配置：

  void initAppLocalization({Locale? defaultLocale}) {
    Get.locale = defaultLocale ?? const Locale('en', 'US');
    Get.fallbackLocale = const Locale('en', 'US');
  }
  

3. 主项目引入并使用该包 #

• 在主项目的pubspec.yaml中添加包依赖：

  dependencies:
    my_localization_lib:
      path: ../my_localization_lib # 本地包路径，若发布到pub则直接写包名
  

• 在主项目的main.dart中配置GetX：

  import 'package:get/get.dart';
  import 'package:my_localization_lib/my_localizations.dart';
  import 'package:my_localization_lib/my_localizations.dart'; // 引入初始化方法
  
  void main() {
    initAppLocalization(defaultLocale: const Locale('zh', 'CN')); // 调用包的初始化
    runApp(const MyApp());
  }
  
  class MyApp extends StatelessWidget {
    const MyApp({super.key});
  
    @override
    Widget build(BuildContext context) {
      return GetMaterialApp(
        translations: MyLocalizations(), // 注册包的翻译类
        home: Scaffold(
          appBar: AppBar(title: Text('welcome'.tr)), // 使用翻译字符串
          body: Center(
            child: ElevatedButton(
              onPressed: () => Get.dialog(AlertDialog(title: Text('logout_msg'.tr))),
              child: Text('login_btn'.tr),
            ),
          ),
        ),
      );
    }
  }
  

4. 扩展优化 #

• 可以在包中封装常用的多语言切换方法：

  void switchLocale(Locale locale) {
    Get.updateLocale(locale);
  }
  

• 处理带参数的字符串，在语言文件中添加占位符：

  // en.dart中添加：'greet': 'Hello, {name}'
  // 使用时：'greet'.trParams({'name': 'John'})
  

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