Catalogues de chaînes Apple

Mettez à jour les valeurs des langues cibles dans un catalogue XCStrings tout en conservant la langue source et les autres langues.

Un catalogue .xcstrings regroupe le contenu source et ses traductions. Le gestionnaire de fichiers xcode-xcstrings renseigne les entrées des langues cibles dans ce catalogue, tout en conservant les autres langues dans le même fichier. Le catalogue est donc modifié à son chemin source : aucun fichier distinct n'est créé pour chaque langue.

Valeurs sources et variantes #

Voici un exemple d'entrée dont la valeur source est explicitement définie en anglais :

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

Le stringUnit.value de la langue source fournit le texte. Les variantes de pluriel ou d'appareil prises en charge fournissent des valeurs terminales distinctes, chacune avec une identité propre à sa variante. Lorsqu'une entrée ne comporte pas de localisation dans la langue source, sa clé sert de texte source. Ce mécanisme de repli est utile lorsque les clés correspondent au texte source, mais une clé technique comme checkout.title ne remplace pas le message anglais attendu.

Les entrées comportant shouldTranslate: false sont ignorées. Les commentaires du catalogue peuvent rester dans la structure partagée, mais les indications du gestionnaire précisent le format et la variante ; cela ne garantit pas que chaque commentaire soit utilisé comme consigne de traduction.

L'exhaustivité se vérifie par langue #

L'exhaustivité est vérifiée pour la langue demandée. Le gestionnaire sélectionne les emplacements sources pris en charge qui ont changé ou pour lesquels aucune valeur cible n'existe. Une nouvelle langue peut ainsi recevoir des traductions même si le catalogue partagé existe déjà.

Les traductions déjà intégrées au catalogue peuvent être réutilisées, même avec --force dans la CLI. Vider une entrée cible distincte fournie au gestionnaire ne supprime pas les valeurs présentes dans le catalogue source. Utilisez la procédure de correction ci-dessous lorsqu'un message inchangé doit être reformulé.

L'assemblage part du catalogue source actuel, reprend les données linguistiques existantes de ses entrées lorsqu'elles s'appliquent, puis écrit les traductions demandées dans les entrées et variantes actuelles. Relisez l'ensemble des différences du fichier partagé, y compris les modifications du contenu source et les langues laissées intactes. Les nouvelles unités cibles utilisent l'état translated ; leur acceptation par une personne reste une décision de relecture distincte.

La structure des variantes de pluriel et d'appareil suit les valeurs terminales sources prises en charge. N'en déduisez pas que toutes les formes grammaticales de chaque langue cible ont été générées ou vérifiées. Examinez l'ensemble des variantes et affichez des cas représentatifs dans l'application.

Configurer la sortie dans le fichier partagé #

La CLI déduit xcode-xcstrings de .xcstrings et écrit la sortie au chemin source. Pour ce type de fichier, sa configuration n'autorise pas de targetPath distinct. Suivez le guide de démarrage rapide pour les fichiers avec la CLI jusqu'à l'étape de récupération, ou utilisez GitHub pour une traduction gérée du dépôt.

Corriger une traduction existante #

Pour apporter une correction précise à une formulation, modifiez la valeur de la langue concernée dans Xcode et vérifiez-la dans l'application. Pour régénérer une traduction après avoir modifié les consignes du moteur, terminez d'abord les travaux de traduction en attente et sauvegardez l'intégralité du catalogue. Conservez l'état de référence existant de la CLI et incluez la langue souhaitée dans targetLocales.

Supprimez uniquement l'entrée cible à régénérer. Dans l'exemple ci-dessus, avec l'allemand comme langue cible, il s'agit de strings["checkout.title"].localizations.de ; conservez en, les autres langues et les entrées voisines. Enregistrez le fichier, puis lancez un envoi incrémental standard :

sh
lingo push --wait

Le catalogue modifié est envoyé sans cette entrée cible : l'entrée sélectionnée doit donc être traduite. Ne modifiez pas le fichier pendant l'attente. Examinez la nouvelle valeur allemande et l'ensemble des différences du catalogue avant de l'accepter. Si une entrée comporte des variantes de pluriel ou d'appareil, la suppression de son entrée pour la langue concernée régénère toutes ses variantes sources prises en charge.

Utilisez cette procédure avec l'état de référence enregistré et un envoi simple. Les motifs positionnels, --backfill-missing et --key sélectionnent des travaux différents ; purge ignore le fichier partagé.

Relire l'ensemble des modifications du catalogue #

Conservez le catalogue committé ou une copie locale avant de le remplacer ou de le nettoyer. La purge via la CLI ignore ce format, car la source et la sortie partagent le même chemin. Pour régénérer une traduction, supprimez l'entrée de la langue concernée comme indiqué ci-dessus.

Les vérifications du catalogue par la CLI ne permettent pas d'établir l'exhaustivité des langues dans XCStrings. Utilisez Xcode et les vérifications dans l'application pour contrôler l'appartenance des ressources, la langue de développement, les catalogues multiples, les espaces réservés et les variantes affichées. Consultez Localiser une application iOS pour suivre ce workflow. Les anciens formats strings et stringsdict conservent leur fonctionnement avec des fichiers distincts par langue.