Localiser une application Flutter

Traduisez les messages ARB, générez les ressources Flutter et vérifiez l’écran obtenu dans chaque langue cible.

Les outils de localisation de Flutter transforment les messages ARB en méthodes que vos widgets appellent. Lingo.dev traduit ces ressources ARB : vous conservez ainsi la même API générée tout en ajoutant des langues. Commencez par un écran dont le message de bienvenue et le nombre d’éléments vous permettent de vérifier ensemble le texte, les variables et la gestion des pluriels.

Cette procédure suppose que le projet charge déjà son fichier ARB source via la génération des ressources de localisation de Flutter. Conservez l10n.yaml, le générateur et les appels existants dans les widgets. Ici, Lingo.dev se charge de la traduction des fichiers ; Flutter continue de sélectionner la langue et d’afficher les messages.

Donner à chaque message les informations dont il a besoin #

Pour un fichier source situé à lib/l10n/app_en.arb, utilisez un catalogue comme celui-ci :

json
{
  "@@locale": "en",
  "welcome": "Welcome, {name}",
  "@welcome": {
    "description": "Greeting on the signed-in account screen",
    "placeholders": { "name": { "type": "String" } }
  },
  "itemCount": "{count, plural, =0{No items} =1{One item} other{{count} items}}",
  "@itemCount": {
    "description": "Number of items in the cart",
    "placeholders": { "count": { "type": "int" } }
  }
}

La description explique à la personne chargée de la traduction comment le message est utilisé. Les définitions des paramètres indiquent à Flutter les valeurs fournies par le code appelant. Le gestionnaire ARB traduit les deux chaînes de message, conserve les métadonnées et met à jour le champ @@locale existant pour indiquer la langue cible.

Exécutez d’abord le générateur de localisation du projet sur la source, puis utilisez dans l’écran les méthodes générées pour le message de bienvenue et le nombre d’éléments. Vous vérifiez ainsi que le catalogue d’origine et le code appelant concordent avant d’ajouter une autre langue.

Installez la version actuelle de la CLI et authentifiez-vous depuis la racine du projet :

sh
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets de,fr --files 'lib/l10n/app_en.arb' --yes
lingo link

init écrit .lingo/config.json ; link sélectionne l’organisation et le moteur de localisation. Conservez les identifiants générés. Les champs de localisation doivent sélectionner uniquement le fichier source :

json
{
  "sourceLocale": "en",
  "targetLocales": ["de", "fr"],
  "files": [
    { "pattern": "lib/l10n/app_en.arb", "format": "flutter" }
  ]
}

Il s’agit de la partie consacrée à la localisation dans la configuration liée : elle ne remplace pas les identifiants de l’organisation et du moteur de localisation. L’extension .arb sélectionne aussi automatiquement flutter. Cette organisation des fichiers produit app_de.arb et app_fr.arb ; vérifiez que le générateur du projet les lit. Pour une autre organisation, définissez un chemin cible explicite.

Évitez un motif de sélection des sources comme app_*.arb s’il sélectionne aussi les catalogues traduits. Pour les variantes régionales, respectez la notation prévue par la configuration du projet Flutter dans les noms de fichiers, plutôt que de supposer que chaque code de langue peut y être utilisé tel quel.

Traduire et générer les ressources cibles #

Pour les fichiers cibles manquants, exécutez :

sh
lingo push --backfill-missing --wait

La commande attend la fin de l’exécution et récupère les fichiers. Si l’exécution attend une relecture ou échoue, réglez la situation avant de générer les ressources destinées à la publication. Un simple premier envoi peut établir la version de référence de la source sans demander les traductions manquantes.

Inspectez les clés cibles, les descriptions, les noms et les types des paramètres, ainsi que @@locale. Lancez ensuite la génération des ressources de localisation Flutter, l’analyse, les tests et la compilation du projet. Corrigez toute expression ICU invalide, tout paramètre manquant ou tout type incompatible avant de poursuivre. La reconstruction ARB conserve les métadonnées, mais ne vérifie pas la compatibilité de chaque message traduit avec le générateur de Flutter.

Ouvrez l’écran en allemand et en français. Fournissez un nom court, puis un nom long, et testez des nombres d’éléments de 0, 1, 2, puis une valeur plus élevée. Lisez la formulation du pluriel au lieu de vérifier seulement qu’un nombre s’affiche. Certaines langues peuvent nécessiter des catégories absentes de la source anglaise : vérifiez donc les formes requises dans la langue cible. Vérifiez la sélection de la langue, le mécanisme de repli, l’allongement du texte et, si nécessaire, le sens de lecture. Le formatage des dates et des nombres reste géré par Flutter à l’exécution.

Maintenir le lien entre les mises à jour ultérieures et la source #

Conservez ensemble la configuration, la source, les traductions cibles acceptées et .lingo/lock.json. Après avoir modifié un message source, exécutez lingo push --wait et examinez ce message à côté d’un message voisin inchangé. Une modification de la description seule ne crée pas, à elle seule, une nouvelle tâche de traduction du texte du message ; utilisez une mise à jour ciblée lorsque le contexte révisé doit entraîner une nouvelle traduction.

Ne modifiez pas les fichiers cibles tant que la réécriture est en attente. Pour protéger les corrections locales des traductions cibles, soumettez sans --wait, inspectez lingo pull --dry-run, puis récupérez les fichiers avec lingo pull depuis le checkout ayant servi à la soumission. Les autres machines doivent disposer de traductions committées ou recevoir les artefacts par un transfert explicite ; ne supposez pas qu’elles partagent la dernière exécution. Consultez Conserver les traductions relues pour connaître les modalités de récupération.

Une fois ce cycle opérationnel, utilisez la GitHub App ou l’automatisation CI pour répéter la traduction et la génération des ressources avant la relecture. Les fichiers XML Android natifs et les ressources Apple obéissent à des règles différentes pour les fichiers et l’exécution ; gardez-les séparés de la génération ARB dans un projet multiplateforme.