Flutter本地化管理插件best_localization的使用

发布于 1周前 作者 yibo5220 来自 Flutter

Flutter本地化管理插件best_localization的使用

最佳实践：最佳本地化插件

最佳本地化插件

最佳本地化插件 是一个轻量且灵活的Flutter本地化包。它支持动态翻译、插值、复数形式处理，并为库尔德语（Kurdish）提供了自定义本地化支持，包括Material和Cupertino小部件。

功能

  • 动态翻译: 动态基于区域设置进行文本翻译。
  • 插值: 在翻译中插入动态值（例如，Hello, {name}!）。
  • 复数形式处理: 根据数字值处理文本的单数和复数形式。
  • 库尔德语自定义本地化:
    • 支持库尔德语（ku）本地化，适用于Material和Cupertino小部件。
    • 包括自定义日期和数字格式。
  • 无缝集成:
    • 与Flutter的本地化系统无缝集成。
    • 完全兼容MaterialApp和CupertinoApp。
  • 无ARB文件: 直接在Dart映射中管理翻译，简化工作流程。

使用指南

开始使用

安装
  1. 添加 best_localization 包到你的项目中。
flutter pub add best_localization

或者在 pubspec.yaml 文件中添加：

dependencies:
  best_localization: ^1.0.0
  1. 添加 flutter_localizations 包到你的 pubspec.yaml 文件中：
dependencies:
  flutter_localizations:
    sdk: flutter
使用插件
初始化本地化

定义你的翻译，使用Dart映射。这里以库尔德语和英语为例：

final translations = {
  'en': {
    'hello': 'Hello, {name}!',
    'welcome': 'welcome',
  },
  'ku': {
    'hello': 'سڵاو، {name}!',
    'welcome': 'بەخێربێیت',
  },
  // 更多语言...
};
添加本地化委托

更新你的 MaterialApp 或 CupertinoApp，以包含本地化委托：

import 'package:best_localization/best_localization.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      localizationsDelegates: [
        BestLocalizationDelegate(translations: translations),
        ...kurdishLocalizations,
        GlobalMaterialLocalizations.delegate,
        GlobalCupertinoLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
      ],
      supportedLocales: const [
        Locale('ku'), // 库尔德语
        Locale('en'), // 英语
        // 更多语言...
      ],
      locale: Locale('ku'),
      home: MyHomePage(),
    );
  }
}
访问翻译

在你的小部件中使用 BestLocalization.of(context) 方法访问翻译：

class MyHomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    final localizer = BestLocalization.of(context);

    return Scaffold(
      appBar: AppBar(
        title: Text(localizer.translate('hello', args: {'name': 'John'})),
      ),
      body: Center(
        child: Text(localizer.translate('welcome')),
      ),
    );
  }
}
复数形式处理

在你的翻译中定义单数和复数形式的键：

final translations = {
  'en': {
    'items.one': 'One item',
    'items.other': '{count} items',
  },
  'ku': {
    'items.one': 'یەک دانە',
    'items.other': '{count} دانە',
  },
};

动态访问复数形式的翻译：

Text(localizer.translate('items', args: {'count': '2'})); // 输出: 2 دانە
设置非英语的语言键

你可以在其他语言中定义翻译键。例如：

final translations = {
  'en': {
    'سڵاو': 'Hello, {name}!',  // 库尔德语的 "سڵاو" 翻译为英语
    'بەخێربێن': 'Welcome',     // 库尔德语的 "بەخێربێن" 翻译为英语
  },
  'ku': {
    'سڵاو': 'سڵاو، {name}!',  // 库尔德语的 "سڵاو" 翻译为库尔德语
    'بەخێربێن': 'بەخێربێیت',  // 库尔德语的 "بەخێربێن" 翻译为库尔德语
  },
  // 添加更多语言...
};

更多关于Flutter本地化管理插件best_localization的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

Harmonyos Next教程
1 回复

更多关于Flutter本地化管理插件best_localization的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然，以下是关于如何在Flutter项目中使用best_localization插件进行本地化管理的代码示例。这个插件允许你轻松地在Flutter应用中实现多语言支持。

1. 添加依赖

首先，你需要在pubspec.yaml文件中添加best_localization的依赖：

dependencies:
  flutter:
    sdk: flutter
  best_localization: ^x.y.z  # 请替换为最新版本号

然后运行flutter pub get来安装依赖。

2. 配置语言文件

在项目的assets目录下创建一个locales文件夹，并在其中创建不同语言的JSON文件。例如：

  • locales/en.json
  • locales/zh.json

en.json的内容可能如下：

{
  "greeting": "Hello",
  "farewell": "Goodbye"
}

zh.json的内容可能如下：

{
  "greeting": "你好",
  "farewell": "再见"
}

3. 初始化BestLocalization

在你的main.dart文件中，初始化BestLocalization：

import 'package:flutter/material.dart';
import 'package:best_localization/best_localization.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return BestLocalization(
      supportedLocales: [Locale('en'), Locale('zh')],
      pathToJson: 'locales', // 指定语言文件所在的路径
      fallbackLocale: Locale('en'), // 默认语言
      child: MaterialApp(
        title: 'Flutter Localization Demo',
        theme: ThemeData(
          primarySwatch: Colors.blue,
        ),
        home: MyHomePage(),
        localizationsDelegates: [
          BestLocalization.delegate,
          GlobalMaterialLocalizations.delegate,
          GlobalWidgetsLocalizations.delegate,
        ],
        supportedLocales: [Locale('en'), Locale('zh')],
        locale: BestLocalization.of(context).locale,
      ),
    );
  }
}

4. 使用本地化字符串

在你的组件中使用本地化字符串：

import 'package:flutter/material.dart';
import 'package:best_localization/best_localization.dart';

class MyHomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    final String greeting = BestLocalization.of(context).getTranslate('greeting');
    final String farewell = BestLocalization.of(context).getTranslate('farewell');

    return Scaffold(
      appBar: AppBar(
        title: Text('Localization Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              greeting,
              style: TextStyle(fontSize: 20),
            ),
            Text(
              farewell,
              style: TextStyle(fontSize: 20),
            ),
            ElevatedButton(
              onPressed: () {
                BestLocalization.of(context).setLocale(Locale('zh'));
              },
              child: Text('切换到中文'),
            ),
            ElevatedButton(
              onPressed: () {
                BestLocalization.of(context).setLocale(Locale('en'));
              },
              child: Text('切换到英文'),
            ),
          ],
        ),
      ),
    );
  }
}

5. 运行应用

现在，你可以运行你的Flutter应用，并在应用界面上看到不同语言的切换效果。点击按钮可以切换语言，并显示相应的本地化字符串。

总结

通过以上步骤，你已经成功在Flutter项目中集成了best_localization插件，并实现了基本的本地化功能。你可以根据需要进一步扩展和定制你的本地化实现。

回到顶部