Appleのstringsdict

プロパティリストの制御フィールドと形式選択の構造を保ちながら、複数形リソース内のサポート対象の文字列を翻訳します。

Appleの複数形リソースには、読者に表示する文言と、適切な形式を選ぶための指示が含まれています。xcode-stringsdictファイルハンドラーは、プロパティリスト内のサポート対象の文字列スロットを翻訳し、Appleのフォーマッターが使用する制御値を保持します。

テキストスロットと制御キー #

次の例では、数量に応じて変わるメッセージを定義しています。

xml
<plist version="1.0">
<dict>
  <key>items</key>
  <dict>
    <key>NSStringLocalizedFormatKey</key>
    <string>%#@count@</string>
    <key>count</key>
    <dict>
      <key>NSStringFormatSpecTypeKey</key>
      <string>NSStringPluralRuleType</string>
      <key>NSStringFormatValueTypeKey</key>
      <string>d</string>
      <key>one</key><string>%d item</string>
      <key>other</key><string>%d items</string>
    </dict>
  </dict>
</dict>
</plist>

NSStringFormatSpecTypeKeyとNSStringFormatValueTypeKeyには制御データが格納されているため、翻訳対象から除外されます。NSStringLocalizedFormatKeyを含む、それ以外のサポート対象の<string>値は、テキストスロットとして扱われます。翻訳を確認する際は、%#@count@や%dなどのフォーマッタートークンを変更しないでください。

スロットは、辞書や配列内のプロパティリストのキーパスで照合されます。空の<string/>要素も文字列値として読み取られ、置換テキストの書き込み時に<string>...</string>へ展開されることがあります。

再構築と複数形 #

プロパティリストの構造には、現在のソースを使用します。以前のソース値から変更箇所を特定し、一致する既存の翻訳先スロットがあれば、承認済みの文言を再利用できます。置換時には、エンコードしたテキストをソースに差し込み、サポート対象の範囲を囲むヘッダーや書式を保持します。

ハンドラーは、既存の複数形選択構造を保持します。翻訳先言語のすべての複数形カテゴリを生成するわけではなく、あらゆる数量で文言が適切に機能することを保証するものでもありません。oneとotherだけを個別に確認するのではなく、その複数形リソースを実際に使用するAppleのフォーマッターでテストしてください。

複数形リソースの設定とテスト #

CLIは.stringsdictからxcode-stringsdictを推定します。キー単位のモードは利用できません。CLI設定またはGitHubでファイルを選択してください。

これらのロケール別リソースは、文字列テーブルとともに、アプリケーションの.lprojディレクトリに配置してください。プロパティリストを検証し、異なる形式が選択される数量を指定して、アプリ内で読み込んでください。文字列カタログは構成が異なり、複数のロケールを単一の共有ファイルに格納します。