Appleの文字列カタログ

XCStringsカタログのソース言語と他のロケールを保持しながら、カタログ内の翻訳先言語の値を更新します。

.xcstringsカタログは、ソースとその翻訳をまとめて保持します。xcode-xcstringsファイルハンドラーは、同じファイル内の他のロケールを保持しながら、カタログ内の翻訳先言語のエントリーに値を設定します。言語ごとに新しいファイルを作成するのではなく、ソースパスにあるカタログを更新します。

ソースの値とバリエーション #

英語のソース値を明示したエントリーは、次のようになります。

json
{
  "sourceLanguage": "en",
  "strings": {
    "checkout.title": {
      "localizations": {
        "en": {
          "stringUnit": {
            "state": "translated",
            "value": "Complete your order"
          }
        }
      }
    }
  },
  "version": "1.0"
}

ソース言語のstringUnit.valueがテキストの取得元になります。対応する複数形やデバイス別のバリエーションでは、末端の値が個別に扱われ、それぞれバリエーション固有の識別情報を持ちます。エントリーにソース言語のローカライズがない場合は、そのキーがソーステキストとして使われます。この代替動作は、ソーステキストをキーにしている場合には便利ですが、checkout.titleのような技術的なキーは、本来伝えたい英語のメッセージの代わりにはなりません。

shouldTranslate: falseが指定されたエントリーはスキップされます。カタログのコメントは共有構造内に残せますが、ハンドラーのヒントが示すのは形式とバリエーションです。各コメントが翻訳者向けの指針として使われることを保証するものではありません。

翻訳の充足状況はロケールごとに確認 #

翻訳の充足状況は、指定されたロケール内で確認されます。ハンドラーは、対応するソースの項目のうち、変更があったもの、または翻訳先の値がないものを選択します。そのため、共有カタログがすでに存在していても、新しい言語の翻訳を取得できます。

CLIの--forceを使用した場合でも、カタログ内の既存の翻訳が再利用されることがあります。別の翻訳先入力を空にしても、ソースカタログ内の値は削除されません。ソースに変更がないメッセージの訳文を変えたい場合は、以下の修正手順に従ってください。

出力の組み立ては現在のソースカタログを基に行われます。各エントリーの既存のロケールデータを該当する範囲で引き継ぎ、現在のエントリーとバリエーションに、指定された翻訳を書き込みます。ソースの変更や変更されていないロケールも含め、共有ファイル全体の差分をレビューしてください。新しい翻訳先の項目にはtranslated状態が設定されますが、人による承認は別途レビューで判断します。

複数形とデバイス別のバリエーションの構造は、対応するソースの末端要素に従います。すべての翻訳先言語について、必要な文法形式が生成・検証されているとは限りません。バリエーションの構成を確認し、代表的なケースをアプリで表示して確かめてください。

共有ファイルへの出力を設定する #

CLIは.xcstringsからxcode-xcstringsを推定し、ソースパスに出力を書き込みます。この形式では、別のtargetPathを設定するとエラーになります。CLIファイルのクイックスタートに従って取得まで進めるか、GitHubを使ってリポジトリの翻訳を管理してください。

既存の翻訳を修正する #

訳文を意図どおりの表現に修正するには、Xcodeで対象ロケールの値を編集し、アプリで確認してください。エンジンへの指針を変更して再生成する場合は、まず保留中の翻訳作業を完了し、カタログ全体を保存してください。CLIの既存のベースラインは保持し、targetLocalesに対象言語を含めてください。

再生成したい翻訳先のエントリーだけを削除してください。上の例で翻訳先がドイツ語の場合、削除するのはstrings["checkout.title"].localizations.deです。en、他のロケール、前後のエントリーは残してください。ファイルを保存したら、通常の差分プッシュを実行します。

sh
lingo push --wait

変更したカタログは、対象の翻訳先エントリーがない状態で送信されるため、そのエントリーが翻訳対象になります。待機中はファイルを編集しないでください。新しいドイツ語の値とカタログ全体の差分を確認してから採用してください。複数形やデバイス別のバリエーションがある場合は、そのロケールのエントリーを削除すると、対応するすべてのソースバリエーションの翻訳が再生成されます。

この手順では、保存済みのベースラインと通常のプッシュを使用してください。位置引数のパターン、--backfill-missing、--keyは、それぞれ異なる処理対象を選択します。purgeは共有ファイルをスキップします。

カタログ全体の変更をレビューする #

カタログを置き換えたり整理したりする前に、コミット済みのカタログまたはローカルコピーを保存してください。CLI purgeは、ソースと出力が同じパスを使うこの形式をスキップします。翻訳を一つ再生成する場合は、上記の手順に従って対象ロケールのエントリーを削除してください。

CLIのカタログチェックだけでは、XCStringsの各ロケールに必要な内容がすべて揃っているとは確認できません。リソースの所属、開発言語、複数のカタログ、プレースホルダー、表示されるバリエーションは、Xcodeとアプリで確認してください。手順はiOSアプリをローカライズするを参照してください。従来のstringsとstringsdictは、引き続きロケールごとの個別ファイルとして扱われます。