React Nativeアプリをローカライズする

既存のJSONメッセージカタログをCLIで翻訳し、生成された言語ファイルをReact Nativeアプリに読み込みます。

React Nativeアプリでは、react-i18nextとJSON翻訳ファイルを組み合わせて使えます。Lingo.devが設定済みのローカライゼーションエンジンでファイルを翻訳し、既存のメッセージライブラリがロケールの選択とメッセージの表示を担います。

このワークフローでは、キーが付いた既存のカタログを使います。メッセージキー、変数の埋め込み構文、複数形の規則、実行時の設定はそのまま維持してください。

翻訳元カタログを設定する #

翻訳元がsrc/locales/en.jsonにある場合は、プロジェクトのルートでCLIを初期化します。

sh
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,fr,de,ja --files 'src/locales/en.json' --yes
lingo link

生成される.lingo/config.jsonは次の形式になります。連携時に生成された実際の組織IDとエンジンIDは、そのまま使ってください。

json
{
  "orgId": "org_...",
  "engineId": "eng_...",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr", "de", "ja"],
  "files": [{ "pattern": "src/locales/en.json" }]
}

CLIは拡張子からJSON形式を判別し、src/locales/es.jsonなどの翻訳先パスを自動で決定します。翻訳元カタログだけを選択し、生成された翻訳先ファイルを新たな翻訳元に含めないでください。アプリで複数のファイルを使う場合は、翻訳元の名前空間ごとにエントリを追加します。

メッセージを翻訳して読み込む #

まだ存在しない翻訳先ファイルを作成します。

sh
lingo push --backfill-missing --wait

処理が完了したら、生成されたJSONを確認します。翻訳先カタログをアプリの既存のリソースインポートまたはローダーに追加し、react-i18nextで使う言語と名前空間に登録してください。実行時の設定とCLIのtargetLocalesでは、対応言語を一致させる必要があります。

端末またはエミュレーターで、翻訳先の言語に切り替えて画面を開きます。ラベル、変数を埋め込んだ値、アプリで使う複数形をそれぞれ確認してください。翻訳元の言語にひそかにフォールバックしているのではなく、翻訳先カタログが読み込まれていることを確かめます。

翻訳元の変更を継続的に同期する #

設定、翻訳元、承認済みの翻訳先ファイル、.lingo/lock.jsonをまとめてコミットします。翻訳元のメッセージを編集したら、次を実行します。

sh
lingo push --wait

変更されたカタログをレビューし、リリース前にもう一度画面を確認します。自動化には、GitHub AppまたはCIワークフローを使ってください。ファイルの扱いと取得については、JSON形式の制御とレビュー済み翻訳の保持を参照してください。