Localiser une app iOS

Traduisez les catalogues de chaînes Apple ou les ressources héritées sans perdre les langues du fichier partagé, puis vérifiez le résultat dans Xcode et dans l’app.

Une app iOS peut conserver les mêmes appels de recherche de chaînes localisées tout en ajoutant une langue à ses fichiers de ressources. Lingo.dev traduit ces ressources ; Xcode et l’app déterminent toujours le bundle, la table, la langue et la variante présentés à l’utilisateur.

Utilisez le format que le projet charge déjà. Les catalogues de chaînes regroupent plusieurs langues dans un seul fichier .xcstrings, tandis que les ressources .strings et .stringsdict utilisent des fichiers par langue. Cette différence détermine où le résultat est écrit et ce qu’il faut préserver lors d’une mise à jour.

Identifiez les ressources qui font référence #

Pour un projet utilisant des catalogues de chaînes, identifiez la langue de développement, les langues cibles prises en charge et les catalogues chargés par l’app. Xcode 15 a introduit .xcstrings, généralement nommé Localizable.xcstrings. Les messages peuvent être répartis entre plusieurs catalogues, par fonctionnalité ou par bundle ; incluez tous ceux qui alimentent l’écran à localiser.

Pour les ressources héritées, identifiez les répertoires .lproj, les tables de chaînes et les dictionnaires de pluriels concernés. Base.lproj peut contenir des ressources d’interface de base ; sa seule présence ne suffit pas à indiquer au traducteur quelle langue source ou quelle table de chaînes utiliser. Veillez à la cohérence entre le réglage de la langue de développement du projet et la configuration des fichiers.

Reliez le texte de l’écran aux appels de recherche de chaînes localisées avant de le traduire. La traduction des fichiers ne remplace pas les chaînes d’interface codées en dur et n’associe pas les ressources à une cible Xcode. Conservez les commentaires qui indiquent qui parle et sur quel écran pour les personnes chargées de la relecture. Le gestionnaire existant des catalogues de chaînes conserve ces commentaires, mais ne les inclut pas dans les indications associées aux unités de traduction. Placez donc le contexte nécessaire à la génération dans les consignes prises en charge par le moteur de localisation.

Configurez un catalogue de chaînes partagé #

Installez et liez la version actuelle de la CLI depuis la racine du projet :

sh
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,fr --files 'App/Localizable.xcstrings' --yes
lingo link

Pour un catalogue situé à ce chemin, le .lingo/config.json obtenu doit avoir la structure suivante :

json
{
  "orgId": "org_...",
  "engineId": "eng_...",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr"],
  "files": [{ "pattern": "App/Localizable.xcstrings" }]
}

Conservez les identifiants générés lors de la liaison au lieu de copier les valeurs de substitution. L’extension sélectionne xcode-xcstrings. Chaque cible écrit dans le catalogue au même chemin, en ajoutant des entrées de langue tout en conservant la source et les autres langues. Un targetPath distinct n’est pas valide pour ce format à fichier partagé.

La valeur source se trouve dans la structure partagée :

json
{
  "sourceLanguage": "en",
  "strings": {
    "Welcome": {
      "comment": "Greeting on the signed-in home screen",
      "localizations": {
        "en": { "stringUnit": { "state": "translated", "value": "Welcome" } }
      }
    }
  },
  "version": "1.0"
}

Après la traduction, recherchez les entrées des langues demandées à côté de en. Le gestionnaire prend aussi en charge les valeurs terminales des variantes de pluriel et d’appareil de la source, et ignore les entrées marquées shouldTranslate: false. Si une entrée n’a pas de version localisée dans la langue source, sa clé sert de texte source ; une clé technique ne remplace pas le message attendu. Catalogues de chaînes Apple explique ces règles de sélection et pourquoi la source actuelle et le catalogue existant doivent rester alignés.

Conservez les fichiers hérités à leur propre chemin #

Pour un projet utilisant des ressources héritées, utilisez ces entrées de fichiers à la place de l’entrée du catalogue partagé :

json
[{ "pattern": "App/en.lproj/Localizable.strings" }, { "pattern": "App/en.lproj/Localizable.stringsdict" }]

Incluez uniquement les ressources présentes dans le projet. Les extensions sélectionnent les gestionnaires correspondants ; le résultat en espagnol doit se trouver dans App/es.lproj/. Veillez à ce que le réglage de la langue de développement du projet soit cohérent avec ce choix de source.

Les clés de chaînes et les paramètres de substitution du format font partie du contrat d’exécution. Préservez %@, les arguments positionnels et les types attendus par le code appelant. Un .stringsdict contient une structure de variables de pluriel qui doit rester cohérente avec sa chaîne de formatage. Consultez Chaînes Apple et Dictionnaires de chaînes pour connaître leurs contrats respectifs, plutôt que de traiter ces fichiers comme du XML ou du texte quelconque.

Traduisez et examinez le résultat fusionné #

Avant de remplacer le catalogue actuel, conservez-le dans le système de gestion de versions ou dans une copie distincte. Pour protéger les modifications locales, soumettez sans --wait et examinez lingo pull --dry-run avant de récupérer le résultat. Résolvez les divergences au lieu de forcer l’écrasement. La réécriture avec attente ne refait pas la vérification des conflits effectuée par pull ; consultez Préserver les traductions relues.

Pour une première traduction sans conflit, utilisez la commande suivante uniquement si le catalogue reste inchangé pendant l’attente. Avant d’ajouter des langues à un projet existant, terminez les mises à jour habituelles de la source pour les langues existantes, récupérez les résultats et examinez-les. Conservez ensuite cette révision de la source inchangée pendant l’ajout des langues et le remplissage rétroactif. Ajouter une langue explique l’ordre à respecter :

bash
lingo push --backfill-missing --wait

Les catalogues partagés font l’objet d’une planification par langue, même si le fichier existe déjà. Examinez les entrées des langues demandées plutôt que de chercher un nouveau nom de fichier. Un simple premier push peut établir la version de référence de la source sans lancer de traduction. Après des modifications habituelles de la source, utilisez lingo push --wait ; si vous n’attendez pas, récupérez le résultat enregistré avec lingo pull dans le checkout depuis lequel vous avez effectué la soumission.

Pour corriger une formulation, modifiez l’entrée cible dans Xcode. La commande CLI --force peut encore réutiliser les traductions intégrées à un catalogue inchangé. Pour régénérer une entrée après avoir modifié les consignes, suivez la procédure de correction du catalogue, qui préserve la source et les traductions voisines.

lingo purge ignore les catalogues de chaînes, car leur source et leurs cibles partagent le même chemin. Pour régénérer une traduction sélectionnée, utilisez le workflow de correction des catalogues de chaînes.

Vérifiez dans Xcode et sur des écrans représentatifs #

Ouvrez le résultat dans Xcode et vérifiez que le catalogue ou le fichier hérité est bien inclus dans la cible et le bundle prévus. Compilez avec le schéma existant du projet. Exécutez une configuration dans la langue cible et examinez un écran contenant un libellé simple, une valeur formatée et une variante de pluriel ou d’appareil.

Comparez les paramètres de substitution de la langue cible avec le code appelant. Testez des nombres qui sélectionnent différentes formes de pluriel dans chaque langue ; les catégories de l’anglais ne constituent pas une spécification complète pour toutes les langues cibles. Vérifiez que les langues non modifiées sont toujours présentes dans le catalogue fusionné. Examinez les libellés longs, les textes d’accessibilité, la troncature et le comportement de droite à gauche, le cas échéant.

Les vérifications de compilation de Xcode peuvent détecter des problèmes de ressources, tandis qu’une personne chargée de la relecture linguistique ou une mesure appropriée vérifie le sens. lingo check ne permet de confirmer ni l’exhaustivité de .xcstrings ni le bon fonctionnement des pluriels Apple.

Préservez le fichier partagé lors de l’automatisation #

Conservez ensemble les sources, les traductions cibles acceptées, la configuration et .lingo/lock.json, puis choisissez la GitHub App ou un exécuteur CI pour les tâches récurrentes. L’exécuteur gère sa propre authentification, son état et une réécriture permettant la relecture. Examinez les différences d’un catalogue de chaînes comme une modification d’un fichier partagé : identifiez la révision de la source, les langues modifiées et les langues préservées avant de l’accepter.

Pour les projets multiplateformes, utilisez les workflows distincts Android et Flutter pour les qualificateurs XML et la génération ARB. Chaque plateforme nécessite toujours ses propres vérifications du chargement des ressources et du rendu des écrans.