引言

在使用Flutter开发Google Play市场的安卓应用时，国际化是一个不可或缺的需求。你是否也曾遇到过这样的问题：需要支持多种语言，但官方文档提供的方案仅支持单文件的多语言实现，导致多个文件的管理变得复杂？别担心，今天我将为大家揭秘一个优雅且高效的解决方案。

基本实现

首先，确保你的pubspec.yaml文件中已经添加了以下依赖：

dependencies:
  flutter:
    sdk: flutter
  flutter_localizations:
    sdk: flutter
  intl: any

接下来，创建一个名为l10n.yaml的配置文件，并将其放置在项目根目录下。以下是一个示例配置：

arb-dir: lib/l10n
template-arb-file: app_zh.arb
output-dir: lib/l10n/generated
output-localization-file: app_localizations.dart
prefer-matched-file: true
prevent-collisions: true
synthetic-package: false
nullable-getter: false

然后，在lib/l10n目录下创建相应的.arb文件，例如app_zh.arb和app_en.arb。这些文件的内容示例如下：

{
  "helloWorld": "你好 世界!"
}

{
  "helloWorld": "Hello World!"
}

最后，运行flutter gen-l10n命令生成多语言文件：

flutter gen-l10n

生成的文件将位于lib/l10n/generated目录下。

进阶使用

对于小型项目，所有多语言配置可以放在同一个文件中。但对于中大型项目，多人开发时，建议按业务拆分出不同的模块。例如，可以将公共词汇放在common模块的common_en.arb和common_zh.arb文件中，首页模块放在home模块的home_en.arb和home_zh.arb文件中。

手动生成多语言文件

除了使用flutter gen-l10n命令外，还可以使用flutter gen-l10n --arb-dir参数手动生成多语言文件。例如：

flutter gen-l10n --arb-dir ./lib/l10n/home --template-arb-file home_en.arb --output-localization-file home_localizations.dart --output-class HomeLocalizations

多模块ARB合并

如果你希望在不修改官方实现的基础上实现多模块ARB的合并，可以使用以下脚本来实现：

# !/bin/bash

BASE_DIR="lib/l10n"
MODULES=("common" "home" "setting")
LANGUAGES=("en" "zh")

# 清理旧文件
rm -f $BASE_DIR/app_*.arb

# 按语言合并
for lang in "${LANGUAGES[@]}"; do
  OUTPUT_FILE="$BASE_DIR/app_${lang}.arb"
  TEMP_FILE="${OUTPUT_FILE}.tmp"

  # 初始化合并文件
  echo "{}" > $TEMP_FILE

  # 合并模块文件
  for module in "${MODULES[@]}"; do
    MODULE_FILE="$BASE_DIR/$module/${module}_${lang}.arb"
    if [ -f "$MODULE_FILE" ]; then
      jq -s '.[0] * .[1]' $TEMP_FILE $MODULE_FILE > $TEMP_FILE.tmp
      mv $TEMP_FILE.tmp $TEMP_FILE
    fi
  done

  # 格式化输出
  jq --sort-keys . $TEMP_FILE > $OUTPUT_FILE
  rm $TEMP_FILE
done

echo "ARB files merged successfully!"

运行此脚本后，再使用flutter gen-l10n命令生成多语言文件。

结语

通过以上方法，你可以在不修改官方实现的基础上，实现多语言文件的优雅管理和高效生成。希望这篇文章能为你带来帮助，让你的Flutter应用支持多语言时更加得心应手。关注我，了解更多关于Flutter的相关内容！