モバイルアプリのローカライズ

Lingo.dev のCLIは、Xcode .strings、Android XML、Flutter ARB、React Native JSON といったネイティブのモバイルリソースファイルを、設定済みのローカライゼーションエンジン経由で翻訳します。各プラットフォームには専用のバケットタイプがあり、ファイル形式を正しく理解し、構造を保ったまま、複数形もネイティブに処理します。

プラットフォーム概要#

前提条件#

CLI を実行するたびに、コンテンツはローカライゼーションエンジンを通ります。これは、どの LLM モデル、用語集、ブランドボイス、指示を適用するかを決める設定です。Lingo.dev のダッシュボードで作成し、API キーを生成してください。

プラットフォームの設定#

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja"]
  },
  "buckets": {
    "xcode-xcstrings": {
      "include": ["MyApp/Localizable.xcstrings"]
    }
  }
}

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja"]
  },
  "buckets": {
    "xcode-strings": {
      "include": ["MyApp/[locale].lproj/Localizable.strings"]
    },
    "xcode-stringsdict": {
      "include": ["MyApp/[locale].lproj/Localizable.stringsdict"]
    }
  }
}

翻訳の実行#

1 つのコマンドですべてのリソースファイルを翻訳できます。

npx lingo.dev@latest run

CLI はソースロケールのファイルを読み込み、lockfile を使って前回の実行からの変更を判定し、差分だけを翻訳してターゲットロケールのファイルに書き込みます。

プロジェクトに複数のリソースタイプが含まれている場合は、特定のプラットフォームだけを対象にすることもできます。

npx lingo.dev@latest run --bucket android
npx lingo.dev@latest run --bucket xcode-xcstrings

複数形とプラットフォームごとの慣習#

複数形の扱いはモバイルプラットフォームごとに異なります。iOS は .stringsdict または String Catalog のルール、Android は <plurals> XML 要素、Flutter は ARB ファイル内の ICU MessageFormat を使います。CLI は翻訳時に各プラットフォーム固有の複数形構造を保持し、各ターゲットロケールに対して正しい複数形カテゴリを生成します。

プラットフォーム別ガイド#

次のステップ#