Flutter ARB

リソースのメタデータとプレースホルダー定義を保持しながら、ARBのメッセージ値を翻訳します。

アプリケーションリソースバンドル(ARB)は、Flutterのメッセージを、その説明やプレースホルダー定義とともに格納する形式です。flutterファイルハンドラーは、このフラットなJSONオブジェクト内の通常の文字列エントリを翻訳し、@で始まるキーはメタデータとして保持します。

メッセージとメタデータ #

たとえば、配送に関するメッセージでは、受け取る数値を次のように宣言できます。

json
{
  "@@locale": "en",
  "delivery": "Delivery within {days} days",
  "@delivery": {
    "description": "Checkout estimate for the latest arrival date",
    "placeholders": {
      "days": { "type": "int" }
    }
  }
}

deliveryが翻訳単位になります。同じ階層にある@delivery.descriptionは翻訳者向けのヒントで、出力でもメタデータとして保持されます。プレースホルダー定義は翻訳せず、そのまま引き継ぎます。ハンドラーは、任意の入れ子のオブジェクトを追加のメッセージカタログとしては扱いません。

@@localeが存在し、翻訳先ロケールが指定されている場合は、再構築時にその値を更新します。@@localeが存在しない場合、自動では追加しません。バンドルのその他のグローバル値は、翻訳元の値を保持します。

既存の値と対象範囲 #

以前の翻訳元をもとに、キーごとのメッセージの変更を特定します。既存の翻訳先にある承認済みの値も利用できます。再構築には現在の翻訳元のメタデータを使うため、メッセージの文言を再利用する場合でも、翻訳元のメタデータの変更が出力に反映されることがあります。

メッセージを変更した場合は通常の翻訳元の更新で対応し、翻訳指針を変更した場合は明示的にファイル全体を更新してください。詳しくはCLIの対象範囲を参照してください。Flutterの生成処理を実行する前に、出力されたメッセージとメタデータを確認してください。

出力では、JSONのインデントにスペース2つを使い、末尾に改行を付けます。構造に基づいて再構築するため、翻訳元の書式をバイト単位で保持するものではありません。

翻訳後にFlutterリソースを生成する #

CLIは.arbからflutterを推定します。app_en.arbのような翻訳元から、app_de.arbのようにロケールごとのファイルを生成します。これらのパスは、プロジェクトのローカライゼーション設定に合わせてください。ファイルの選択には、CLI設定またはGitHubを使用してください。

取得後は、プロジェクトのFlutterローカライゼーション生成処理とビルドチェックを実行してください。パラメーターを含むメッセージに実際の値を入れて表示し、各翻訳先ロケールで複数形の各ケースを確認してください。保持されたメタデータは生成処理に必要な情報を伝えますが、翻訳されたメッセージでも、それらのプレースホルダーを正しく使う必要があります。Flutterアプリをローカライズするでは、リソースをアプリで検証するところまで扱います。