Chaînes Apple

Traduisez les valeurs des tables de chaînes Apple en conservant les clés de recherche et en échappant le texte reconstitué.

Une table de chaînes Apple associe des clés de recherche fixes au texte affiché. Le gestionnaire de fichiers xcode-strings traduit les valeurs à droite, conserve les clés et écrit les chaînes littérales échappées dans un fichier .strings par langue.

Clés et valeurs #

Par exemple :

text
/* Checkout heading */
"checkout.title" = "Complete your order";
"delivery.estimate" = "Delivery within %d days";

Les deux valeurs à droite sont des unités de texte. checkout.title et delivery.estimate restent des clés de recherche. Les commentaires sont conservés avec les entrées, mais ce gestionnaire ne transforme pas leur contenu en indications destinées à la traduction. Lorsqu'un libellé court est ambigu, utilisez les mécanismes de contexte pris en charge par le workflow de traduction.

Les clés et valeurs entre guillemets, les signes d'affectation et les points-virgules font partie de la syntaxe prise en charge pour les tables de chaînes. L'analyseur décode les séquences d'échappement reconnues ; à l'écriture, les guillemets, les barres obliques inverses, les sauts de ligne, les tabulations et les retours chariot sont échappés. Le remplacement des valeurs préserve les commentaires qui les entourent et l'espacement des entrées.

Fusion et emplacement des ressources #

La source précédente permet de déterminer, pour chaque clé, les valeurs qui ont changé, tandis qu'une cible existante fournit les traductions à conserver. La source actuelle définit l'ensemble des entrées et les commentaires. Pour les messages modifiés, procédez à une mise à jour habituelle de la source. Après avoir modifié les consignes de traduction, vous pouvez choisir d'actualiser l'ensemble du fichier ; consultez Portées de la CLI.

Placez les ressources de chaque langue là où l'application les charge, par exemple en.lproj/Localizable.strings et de.lproj/Localizable.strings. Une source située dans Base.lproj est interprétée différemment d'un répertoire nommé d'après une langue lors de la déduction des chemins. Vérifiez la destination à l'aide de l'outil sélectionné ; la traduction de la table ne configure ni la langue de développement de l'application ni l'appartenance des ressources.

Configurer et charger la table de chaînes #

La CLI déduit xcode-strings à partir de .strings. Consultez Configuration de la CLI pour les règles de sélection et de définition des chemins, ou GitHub pour la gestion des fichiers de sortie dans un dépôt.

Chargez la table cible dans l'application et testez les spécificateurs de format avec des valeurs réelles. Utilisez stringsdict pour les ressources de sélection des formes plurielles. Si le projet utilise des catalogues de chaînes, suivez plutôt leurs règles de fusion de fichiers partagés : renommer un catalogue pour chaque langue créerait une organisation différente des ressources.