localize.dev

Docs / Traduire / Flutter ARB

Traduire les fichiers ARB Flutter

Traduisez lib/l10n/app_en.arb en app_<lang>.arb pour Flutter’s gen-l10n, avec {placeholders}, des messages pluriels et select ICU, et des descriptions @key utilisées comme contexte.

Comment ça marche

localize-dev translate lit votre fichier ARB modèle, envoie la description de @key de chaque message avec elle comme contexte, et écrit app_ar.arb, app_pt_BR.arb et le reste avec @@locale défini. gen-l10n récupère les nouveaux fichiers et ajoute les langues à supportedLocales lors de la prochaine compilation.

Les messages pluriels et select ICU sont divisés en leurs branches, traduits et rassemblés avec les formes dont la langue a besoin. Les correspondances exactes comme =0 restent, et le message est analysé avant d'être écrit.

Avant et après

Sortie réelle de localize-dev translate --locales ar sur le premier fichier. L'arabe utilise six formes plurielles, de sorte que le pluriel itemCount reçoit zéro, un, deux, peu, beaucoup et autre à côté de sa branche =0.

lib/l10n/app_en.arb
{
  "@@locale": "en",
  "cartTitle": "Your cart",
  "@cartTitle": { "description": "Title of the shopping cart screen" },
  "greeting": "Hi {name}, ready to check out?",
  "@greeting": { "placeholders": { "name": { "type": "String" } } },
  "itemCount": "{count, plural, =0{Your cart is empty} =1{1 item} other{{count} items}}",
  "@itemCount": { "placeholders": { "count": { "type": "int" } } }
}
lib/l10n/app_ar.arb · arabe
{
  "@@locale": "ar",
  "cartTitle": "عربتك",
  "greeting": "مرحباً {name}، هل أنت مستعد للدفع؟",
  "itemCount": "{count, plural, =0 {عربتك فارغة} zero {0 عناصر} one {عنصر واحد} two {عنصران} few {{count} عناصر} many {{count} عناصر} other {{count} عناصر}}"
}

Ce qui reste intact

  • Espaces réservés {name}, vérifiés
  • Pluriels ICU avec chaque forme CLDR utilisée par la langue
  • Branches exactes =0 et =1 et branches select
  • Les noms de fichiers avec underscore attendus par gen-l10n (app_pt_BR.arb)

Erreurs courantes et comment elles sont évitées

Seulement one et other dans chaque langue

L'arabe a six formes plurielles et le polonais quatre. Une other traduite seule fait que des comptes comme 2 ou 5 se lisent mal. Les formes utilisées par chaque langue sont écrites pour chaque pluriel.

Une accolade manquante

Un } non correspondant dans un message ICU arrête flutter gen-l10n. Chaque message traduit est analysé avant d'être écrit ; celui qui ne peut pas être analysé est retenté, puis omis et signalé.

Pas de contexte pour les chaînes courtes

« Book » peut être un nom ou un verbe. Ajoutez une description sous @book dans le modèle et elle sera envoyée avec le message, afin que la traduction corresponde à l'écran sur lequel elle se trouve.

Exécuter

Dans le dossier qui contient vos fichiers de langue. Les langues sans fichier en obtiennent un. --dry-run montre ce qui changerait en premier.

npx localize-dev login

# Preview, then write the missing translations
npx localize-dev translate --dry-run -l es,fr,de
npx localize-dev translate -l es,fr,de

Ensuite, gardez-le complet dans la CI. Cela ne nécessite pas de clé API et échoue lorsqu'une langue manque de traductions :

npx localize-dev check --only translations

Gratuit pour 1 000 chaînes par mois. Une chaîne compte une fois, peu importe dans combien de langues elle va. Créez un compte gratuit

Guides pour les applications qui utilisent ce format

Lorsque le texte est encore codé en dur dans votre code, localize-dev run le déplace d'abord dans ce format.