React Nativeアプリをローカライズする
既存のJSONメッセージカタログをCLIで翻訳し、生成された言語ファイルをReact Nativeアプリに読み込みます。
React Nativeアプリでは、react-i18nextとJSON翻訳ファイルを組み合わせて使えます。Lingo.devが設定済みのローカライゼーションエンジンでファイルを翻訳し、既存のメッセージライブラリがロケールの選択とメッセージの表示を担います。
このワークフローでは、キーが付いた既存のカタログを使います。メッセージキー、変数の埋め込み構文、複数形の規則、実行時の設定はそのまま維持してください。
翻訳元カタログを設定する #
翻訳元がsrc/locales/en.jsonにある場合は、プロジェクトのルートでCLIを初期化します。
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は、そのまま使ってください。
{
"orgId": "org_...",
"engineId": "eng_...",
"sourceLocale": "en",
"targetLocales": ["es", "fr", "de", "ja"],
"files": [{ "pattern": "src/locales/en.json" }]
}CLIは拡張子からJSON形式を判別し、src/locales/es.jsonなどの翻訳先パスを自動で決定します。翻訳元カタログだけを選択し、生成された翻訳先ファイルを新たな翻訳元に含めないでください。アプリで複数のファイルを使う場合は、翻訳元の名前空間ごとにエントリを追加します。
メッセージを翻訳して読み込む #
まだ存在しない翻訳先ファイルを作成します。
lingo push --backfill-missing --wait処理が完了したら、生成されたJSONを確認します。翻訳先カタログをアプリの既存のリソースインポートまたはローダーに追加し、react-i18nextで使う言語と名前空間に登録してください。実行時の設定とCLIのtargetLocalesでは、対応言語を一致させる必要があります。
端末またはエミュレーターで、翻訳先の言語に切り替えて画面を開きます。ラベル、変数を埋め込んだ値、アプリで使う複数形をそれぞれ確認してください。翻訳元の言語にひそかにフォールバックしているのではなく、翻訳先カタログが読み込まれていることを確かめます。
翻訳元の変更を継続的に同期する #
設定、翻訳元、承認済みの翻訳先ファイル、.lingo/lock.jsonをまとめてコミットします。翻訳元のメッセージを編集したら、次を実行します。
lingo push --wait変更されたカタログをレビューし、リリース前にもう一度画面を確認します。自動化には、GitHub AppまたはCIワークフローを使ってください。ファイルの扱いと取得については、JSON形式の制御とレビュー済み翻訳の保持を参照してください。