Pour ajouter une langue à une application Flutter, il suffit de traduire un fichier : votre fichier ARB modèle. Tout le reste, y compris les classes Dart, est généré à partir de celui-ci.
Ce guide porte sur ce fichier, app_en.arb, et sur les trois éléments qui posent souvent problème : les métadonnées @, les paramètres et les pluriels. Pour les autres formats d’application, consultez comment traduire les fichiers de langue de votre application.
Qu’est-ce qu’un fichier ARB ?
Un fichier ARB est un fichier JSON auquel s’ajoute une convention. L’outil de localisation de Flutter lit par défaut les fichiers ARB dans lib/l10n, utilise app_en.arb comme modèle et génère les classes Dart lorsque vous lancez flutter gen-l10n. Chaque fichier correspond à une langue.
Les entrées vont par paires : une clé avec son texte, puis une entrée @ qui décrit ce texte. Seul le texte est à traduire.
Quelle option choisir ?
| Idéal pour | Limites | |
|---|---|---|
| AI Glot | Ajouter une ou plusieurs langues, appliquer un glossaire à chaque version, gérer chaque publication | Inutile pour dix chaînes |
| Une plateforme de gestion des traductions (Crowdin, Lokalise, Phrase, Localizely) | Une équipe avec des réviseurs et une connexion au dépôt | Il faut d’abord configurer un projet et connecter le dépôt |
| DeepL | Les fichiers XLIFF, qui figurent dans sa liste | ARB n’y figure pas : vous devez donc le convertir d’abord |
| ChatGPT, Claude ou un autre assistant | Quelques chaînes | Vous rédigez le prompt et devez ajouter votre glossaire à chaque conversation. À chaque exécution, une clé peut être modifiée, un {placeholder} altéré ou un pluriel ICU déformé ; vous devez donc comparer chaque fichier |
| Un traducteur indépendant ou une agence | Le texte de vos fiches sur l’App Store et le Play Store | Délais longs, tarif au mot, et le fichier reste à préparer par vos soins |
Confiez la fiche de la boutique et le premier écran à un traducteur. Utilisez un moteur pour le gros du travail sur les libellés et les messages.
Pourquoi AI Glot convient aux fichiers ARB
- Les clés et les métadonnées
@font partie de la structure. Vous pouvez les laisser exactement telles quelles. - Les paramètres et la syntaxe ICU sont préservés.
{name}et{count, plural, ...}restent dans le message ; les mots de chaque variante sont traduits. - Plusieurs langues dans une seule tâche, sans retraiter cinq fois les mêmes chaînes.
- Un seul glossaire pour toutes les langues, y compris celles que vous ajouterez plus tard.
- Un devis avant toute dépense, avec un échantillon à vérifier.
Le parcours d’un fichier
- 1Importerapp_en.arb tel quelJusqu’à 8 MB
- 2Dites ce dont vous avez besoinLangues et éléments à conserverGratuit
- 3Consultez le forfaitChaînes, langues, coûtGratuit
- 4ApprouverLa seule étape payanteConsomme des crédits
- 5TéléchargerUn fichier ARB par langueDéposez-le
À quoi ressemble une entrée traduite
{ "@@locale": "en", "@@locale": "fr", "welcome": "Welcome back, {name}", "welcome": "Bon retour, {name}", "@welcome": { "description": "Greeting on the home screen" }, "cartItems": "{count, plural, one{1 item} other{{count} items}}" "cartItems": "{count, plural, one{1 article} other{{count} articles}}"}Points à vérifier ensuite
Les pluriels dans les langues qui ont davantage de formes. L’anglais en nécessite deux. Le russe et l’arabe en demandent davantage, et le message traduit peut nécessiter des branches absentes du texte source anglais. Relisez ces messages.
@@locale. Si vous n’avez pas demandé sa mise à jour, il est conservé tel quel. Définissez donc la langue cible avant la livraison.
Longueur. Vérifiez les écrans contenant les chaînes les plus longues pour repérer les textes qui débordent d’un bouton ou d’une carte.
Comment procéder, étape par étape
1. Essayez gratuitement avec un fichier. Le traducteur ARB ne nécessite aucun compte et accepte les fichiers jusqu’à 2 MB et 5,000 mots.
2. Importez app_en.arb dans l’application, ou envoyez-le depuis la ligne de commande, ci-dessous.
3. Indiquez en une phrase ce dont vous avez besoin.
Translate this file into French, German and Spanish.
Leave the @ metadata entries alone. Set @@locale to the target language.La phrase détermine ce qui est traduit dans l’ensemble du fichier. Une règle de formulation, comme « conservez chaque {placeholder} et la syntaxe de pluriel ICU exactement tels quels » ou « utilisez le registre informel », doit être saisie dans le deuxième champ lors de la validation, car elle s’applique à chaque message au fur et à mesure de sa rédaction.
4. Ajoutez un glossaire pour le nom de l’application, les noms des fonctionnalités et les mots que votre application emploie toujours de la même façon. Comment en créer un.
5. Consultez les offres et choisissez un niveau de qualité.
Lite offre environ trois fois plus de mots par crédit et est plus rapide : idéal pour une première version dans une nouvelle langue. Standard convient aux chaînes que les utilisateurs voient en premier. Un crédit correspond à un mot en Standard.
6. Validez et téléchargez.
7. Placez les fichiers dans lib/l10n, à côté de app_en.arb, puis exécutez :
flutter gen-l10nUn fichier, plusieurs langues
Les noms de fichiers et les nombres sont donnés à titre d’exemple. Un fichier ARB contient une seule langue : chaque langue a donc son propre fichier.
Trois façons de lancer le traitement
En ligne de commande est la méthode que les développeurs Flutter gardent, car elle s’exécute à chaque nouvelle version :
id=$(aiglot batches create lib/l10n/app_en.arb \
--instruction "Translate into French. Leave the @ metadata entries alone. Set @@locale to the target language." \
--json | jq -r '.data.id')
aiglot batches get "$id" --json | jq '.data.plan'
aiglot batches approve "$id" --quality lite \
--instructions "Keep every {placeholder} and ICU plural syntax exactly as written."
aiglot batches download "$id" --output lib/l10n/app_fr.arbAvec votre agent IA : connectez AI Glot comme serveur MCP. L’agent peut lire votre projet, proposer des termes pour le glossaire, lancer la traduction, enregistrer les fichiers dans lib/l10n et exécuter flutter gen-l10n pour vous.
Dans l’application : importez, cliquez, téléchargez. Idéal pour un traitement ponctuel.
Pour intégrer l’API, consultez la documentation de l’API.
La page Tarifs indique le coût pour un volume plus important. Un compte gratuit inclut des crédits pour traiter un vrai fichier.
Les limites indiquées ici sont celles en vigueur au moment de la rédaction : 8 MB par fichier ARB, et 2 MB et 5,000 mots dans l’outil gratuit. Les valeurs par défaut de Flutter proviennent de sa propre documentation et peuvent changer. La liste de DeepL provient de sa documentation. Les noms de fichiers et le nombre de chaînes dans les schémas sont des exemples. Votre forfait affiche les chiffres réels pour votre fichier, et vous pouvez les consulter gratuitement.