Dart 国际化翻译库 - intl_translation 使用指南

Dart 国际化翻译库 - intl_translation 使用指南

intl_translationMessage extraction and code generation from translated messages for the intl package项目地址:https://gitcode.com/gh_mirrors/in/intl_translation

项目介绍

intl_translation 是一个专为 Dart 和 Flutter 应用设计的国际化翻译扩展包。它允许开发者从源代码中提取可翻译的消息，通过外部工具进行翻译后，再生成对应的本地化库。这个包独立于 intl 包，以避免所有用户都依赖于分析器，从而简化了多语言支持的流程。它处理国际化的消息、日期和数字格式化与解析、双向文本以及其他全球化问题。

项目快速启动

安装

首先，在您的Dart或Flutter项目中的 pubspec.yaml 文件里添加 intl_translation 的依赖：

dependencies:
  intl_translation: ^0.20.0

之后运行 flutter pub get 或 dart pub get 来安装依赖。

提取翻译消息

运行以下命令来从您的程序中提取待翻译的消息到一个 ARB 格式的文件中：

dart run intl_translation:extract_to_arb --output-dir=lib/l10n intl.dart

这将创建一个 intl_messages.arb 文件，用于后续的人工翻译。

生成本地化代码

完成翻译后，使用此命令生成各个地域的翻译库：

dart run intl_translation:generate_from_arb --generated-file-prefix=l10n lib/l10n intl_messages.arb

这会生成如 l10n_messages_en.dart 这样的文件，分别对应不同的语言。

在您的代码中初始化指定的locale：

import 'package:intl_messagefile/intl_messagefile.dart';
import 'l10n_messages_all.dart';

void main() {
  initializeMessages('en');
}

现在，应用程序会基于初始化的locale显示相应的翻译。

应用案例和最佳实践

在开发过程中，确保每个需要本地化的字符串都通过 Intl.message 调用来引用，以便于自动化提取。保持ARB文件的结构清晰，便于翻译者理解上下文。对经常变化的文本，考虑实施持续集成（CI）流程来自动化翻译文件的更新和验证。

典型生态项目

虽然具体的典型生态项目示例不在直接提供的文档内，但intl_translation广泛应用于任何需要实现多语言功能的Dart和Flutter项目中，无论是企业级应用还是个人开发的小型应用。结合Flutter的全球普及，这个库常与其他本地化管理工具如flutter_localizations一起使用，来提供完整的国际化解决方案。开发者社区中分享的各种开源项目及应用往往都将此作为实现国际化的核心组件之一。

---

以上步骤和实践方法为使用intl_translation的基本框架，确保您的应用程序能够轻松地适应不同地区的语言环境。

intl_translationMessage extraction and code generation from translated messages for the intl package项目地址:https://gitcode.com/gh_mirrors/in/intl_translation