stringsdict Apple

Traduisez les chaînes prises en charge dans les ressources de pluriel tout en conservant les champs de contrôle du plist et la structure de sélection des formes.

Les ressources de pluriel Apple associent le texte affiché à des instructions qui permettent de sélectionner la bonne forme. Le gestionnaire de fichiers xcode-stringsdict traduit les emplacements de chaînes pris en charge dans le plist et conserve les valeurs de contrôle utilisées par le moteur de formatage d'Apple.

Emplacements de texte et clés de contrôle #

Cet extrait définit un message dont la forme dépend d'un nombre :

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 et NSStringFormatValueTypeKey contiennent des données de contrôle et sont exclus de la traduction. Les autres valeurs <string> prises en charge, dont NSStringLocalizedFormatKey, deviennent des emplacements de texte. Lors de la relecture des traductions, conservez à l'identique les jetons de formatage tels que %#@count@ et %d.

Les emplacements sont mis en correspondance à partir de leurs chemins de clés plist dans les dictionnaires et les tableaux. Les éléments <string/> vides sont eux aussi lus comme des valeurs de chaîne et peuvent prendre la forme <string>...</string> lors de l'écriture d'un remplacement.

Reconstruction et pluriels #

La source actuelle fournit la structure du plist. Les valeurs de la source précédente permettent de repérer les changements, tandis que les emplacements correspondants déjà présents dans la cible peuvent fournir des formulations acceptées. Les remplacements insèrent le texte encodé dans la source tout en conservant l'en-tête et la mise en forme qui entourent les segments pris en charge.

Le gestionnaire conserve la structure existante de sélection des formes plurielles. Il ne génère pas toutes les catégories de pluriel de la langue cible et ne garantit pas que les formulations conviennent à toutes les quantités. Testez la ressource de pluriel avec le moteur de formatage Apple qui l'utilise, plutôt que d'examiner uniquement one et other de façon isolée.

Configurer et tester les ressources de pluriel #

La CLI déduit xcode-stringsdict à partir de .stringsdict ; le mode limité à certaines clés n'est pas disponible. Sélectionnez les fichiers dans la configuration de la CLI ou via GitHub.

Conservez ces ressources par langue dans les répertoires .lproj de l'application, aux côtés des tables de chaînes. Vérifiez la validité du plist et chargez-le dans l'application avec des quantités qui déclenchent la sélection de différentes formes. Les catalogues de chaînes suivent une organisation différente et regroupent plusieurs langues dans un même fichier partagé.