ローカライゼーション
優先度: P1(標準)
easy_localization を使用した一貫性のある多言語サポート。
フォーマット選択
- CSV(翻訳者とのチーム作業に推奨):
- 非技術的な編集者でも簡単に更新可能
sheet_loader_localizationによるネイティブ Google Sheets 互換性assets/langs/に保存(一般的な慣習)
- JSON(開発者向け):
- ネスト構造のサポート(例:
items_count.zero) - IDE のバリデーションとオートコンプリート
assets/translations/に保存
- ネスト構造のサポート(例:
どちらのフォーマットも easy_localization で同様に動作します。
構造
# CSV 形式(Google Sheets ワークフロー)
assets/langs/langs.csv
# または JSON 形式(ネストキー)
assets/translations/
├── en.json
└── vi.json
実装ガイドライン
- ブートストラップ: ルートを
EasyLocalizationでラップします。常にawait EasyLocalization.ensureInitialized()を使用してください。 - 参照: 文字列に
.tr()拡張を使用します(例:'welcome'.tr())。 - ロケール:
context.setLocale(Locale('code'))で変更します。 - パラメータ:
{}プレースホルダーを使用し、tr(args: [...])で渡します。 - カウント: 数量には
plural()を使用します。 - シート同期:
sheet_loader_localizationを使用して、Google Sheets から CSV/JSON を自動生成します。
アンチパターン
- ハードコーディング: UI に生の文字列を入れないでください。キーを使用します。
- 手動 L10n: 標準の
Localizations.ofは避け、GetX またはeasy_localizationのコンテキストメソッドを使用します。 - 同期ずれ: すべてのロケールファイル間でキーを同一に保ちます。
参考と例
セットアップと Google Sheets の自動化については、以下を参照してください。 references/REFERENCE.md。
関連トピック
idioatic-flutter | widgets