Flutter (arb)

Application Resource Bundle (ARB) est le format de localisation utilisé par les applications Flutter. Les fichiers ARB sont du JSON valide avec une structure spécifique définie par le package Flutter intl. Ils fonctionnent avec l'outil gen-l10n de Flutter, qui lit les fichiers ARB et génère une classe d'accesseur Dart typée (AppLocalizations par convention). Chaque chaîne traduisible dans votre application Flutter est représentée comme une entrée clé-valeur dans un fichier ARB.

Chaque chaîne traduisible est définie par une clé camelCase et une valeur de chaîne. Une entrée de métadonnées optionnelle — identifiée par la même clé avec un signe at en tête — comporte un champ description pour le contexte du traducteur, un objet placeholders définissant les valeurs interpolées avec leurs types, et des définitions de formes plurielles utilisant la syntaxe de message ICU. ICU gère chaque catégorie plurielle requise par n'importe quelle langue : l'arabe nécessite six formes, le polonais en nécessite quatre, le russe en nécessite trois.

Bonne pratique : écrivez toujours des métadonnées de description pour chaque clé ARB — c'est le contexte que les traducteurs voient dans Language Monster. Définissez explicitement les types d'espaces réservés dans les métadonnées ARB afin que gen-l10n génère des signatures de méthodes Dart correctes avec des arguments de type sûr. Utilisez la syntaxe plurielle ICU plutôt que des clés de chaînes singulier et pluriel séparées. Language Monster lit les métadonnées ARB pour protéger les valeurs des espaces réservés lors de la traduction, gère correctement les structures plurielles ICU et préserve les entrées de métadonnées lors du retour des fichiers ARB complétés vers votre dépôt.

Guides de localisation pour développeurs

Localisation Flutter

En savoir plus Formats de fichiers