Flutter ARB
Traduisez les valeurs des messages ARB tout en préservant les métadonnées des ressources et les définitions des paramètres de substitution.
Un Application Resource Bundle, ou ARB, regroupe les messages Flutter, leurs descriptions et les définitions de leurs paramètres de substitution. Le gestionnaire de fichiers flutter traduit les entrées constituées de simples chaînes de caractères dans cet objet JSON plat et conserve les clés commençant par @ en tant que métadonnées.
Messages et métadonnées #
Par exemple, un message de livraison peut déclarer le nombre qu'il reçoit :
{
"@@locale": "en",
"delivery": "Delivery within {days} days",
"@delivery": {
"description": "Checkout estimate for the latest arrival date",
"placeholders": {
"days": { "type": "int" }
}
}
}delivery devient une unité de traduction. L'entrée associée @delivery.description fournit une indication pour la traduction ; elle reste une métadonnée dans la sortie. Les définitions des paramètres de substitution sont conservées telles quelles, sans être traduites. Le gestionnaire ne considère pas les objets imbriqués arbitraires comme des catalogues de messages supplémentaires.
Lorsque @@locale existe et qu'une langue cible est fournie, la reconstruction le met à jour. Si @@locale est absent, il n'est pas ajouté automatiquement. Les autres éléments globaux du bundle conservent leurs valeurs d'origine.
Valeurs existantes et périmètre #
La version précédente de la source permet de repérer les modifications des messages à partir de leur clé. La cible existante peut fournir des valeurs déjà acceptées. La reconstruction utilise les métadonnées de la source actuelle : les modifications de ces métadonnées peuvent donc apparaître dans la sortie même si le texte des messages est réutilisé.
Pour les messages modifiés, procédez aux mises à jour habituelles de la source. Après un changement des consignes de traduction, vous pouvez choisir d'actualiser l'ensemble du fichier ; consultez Périmètres de la CLI. Vérifiez les messages et les métadonnées obtenus avant de lancer la génération Flutter.
La sortie utilise une indentation JSON de deux espaces et se termine par un saut de ligne. Il s'agit d'une reconstruction structurelle : la mise en forme de la source n'est pas conservée à l'octet près.
Traduisez, puis générez les ressources Flutter #
La CLI déduit flutter à partir de .arb. Une source telle que app_en.arb produit des fichiers par langue, comme app_de.arb ; veillez à faire correspondre ces chemins à la configuration de localisation du projet. Utilisez Configuration de la CLI ou GitHub pour sélectionner les fichiers.
Après la récupération, lancez le générateur de localisation Flutter du projet et les vérifications de compilation. Affichez les messages paramétrés avec des valeurs réelles et testez les différentes formes du pluriel dans chaque langue cible. Les métadonnées conservées indiquent au générateur les paramètres attendus ; le message traduit doit néanmoins utiliser correctement ces paramètres de substitution. Le guide Localiser une application Flutter vous accompagne dans l'utilisation des ressources jusqu'à cette vérification dans l'application.