Localisation Flutter : fichiers ARB, intl et gen-l10n expliqués

Utilisez un seul générateur de localisation et rendez explicites ses emplacements d’entrée et de sortie. L’exemple ci-dessous suppose une application Flutter existante avec ses propres contraintes de SDK et une configuration de projet standard.

Fusionnez les entrées pertinentes dans pubspec.yaml ; ne dupliquez pas les sections dependencies ou flutter :

dependencies:
  flutter:
    sdk: flutter
  flutter_localizations:
    sdk: flutter
  intl: any

flutter:
  generate: true

Résolvez les dépendances avec flutter pub get. L’entrée intl: any suit le modèle de configuration officiel et laisse la résolution des dépendances choisir la version compatible avec le SDK Flutter ; conservez le fichier de verrouillage de l’application et votre processus habituel de revue des dépendances.

Créez l10n.yaml à la racine du projet :

arb-dir: lib/l10n
template-arb-file: app_en.arb
output-localization-file: app_localizations.dart

Suivez le guide d’internationalisation Flutter à jour pour la configuration propre au SDK. Dans le processus moderne, les fichiers de localisation générés se trouvent dans l’arborescence source de l’application. L’exemple importe depuis lib/l10n ; évitez de copier un ancien import synthétique package:flutter_gen dans une nouvelle configuration. Consultez la note de migration sur les sources générées.

Créez lib/l10n/app_en.arb :

{
  "@@locale": "en",
  "appTitle": "Reading room",
  "@appTitle": {
    "description": "Title of the sample reading application"
  },
  "welcomeName": "Welcome, {name}",
  "@welcomeName": {
    "description": "Greeting on the home screen",
    "placeholders": {
      "name": {"type": "String", "example": "Sam"}
    }
  },
  "savedBooks": "{count, plural, =0{No saved books} one{1 saved book} other{{count} saved books}}",
  "@savedBooks": {
    "description": "Number of books saved to the user's library",
    "placeholders": {
      "count": {"type": "int"}
    }
  },
  "readingState": "{state, select, active{Reading now} paused{Reading paused} other{Ready to read}}",
  "@readingState": {
    "description": "Reading status; state is active, paused or another value",
    "placeholders": {
      "state": {"type": "String"}
    }
  }
}

Créez lib/l10n/app_es.arb :

{
  "@@locale": "es",
  "appTitle": "Sala de lectura",
  "welcomeName": "Te damos la bienvenida, {name}",
  "savedBooks": "{count, plural, =0{No hay libros guardados} one{1 libro guardado} other{{count} libros guardados}}",
  "readingState": "{state, select, active{Leyendo ahora} paused{Lectura en pausa} other{Todo listo para leer}}"
}

Le modèle contient les métadonnées de placeholders utilisées par le générateur. Le fichier localisé conserve les clés de message, les noms de placeholders et les identifiants de sélection tout en modifiant la formulation visible par l’utilisateur. Ces exemples en espagnol illustrent la mécanique ; en production, la langue doit faire l’objet d’une relecture native dans le contexte réel du produit.

Exécutez flutter gen-l10n après avoir ajouté ou modifié des ressources. Traitez les erreurs du générateur comme des problèmes de ressources à corriger et résolvez-les avant d’intégrer les fichiers à une version.

L’exemple suivant se place dans lib/main.dart après la génération :

import 'package:flutter/material.dart';
import 'l10n/app_localizations.dart';

void main() => runApp(const ReadingApp());

class ReadingApp extends StatelessWidget {
  const ReadingApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      localizationsDelegates: AppLocalizations.localizationsDelegates,
      supportedLocales: AppLocalizations.supportedLocales,
      home: const ReadingHome(),
    );
  }
}

class ReadingHome extends StatelessWidget {
  const ReadingHome({super.key});

  @override
  Widget build(BuildContext context) {
    final messages = AppLocalizations.of(context)!;
    return Scaffold(
      appBar: AppBar(title: Text(messages.appTitle)),
      body: Padding(
        padding: const EdgeInsetsDirectional.all(16),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text(messages.welcomeName('Sam')),
            Text(messages.savedBooks(3)),
            Text(messages.readingState('active')),
          ],
        ),
      ),
    );
  }
}

L’API générée rend visible dans le code la distinction entre un message simple et un message avec arguments. appTitle est accessible en tant que valeur ; welcomeName, savedBooks et readingState reçoivent les valeurs nécessaires pour construire leurs messages.

Consultez la documentation d’easy_localization et la documentation de GetX à jour avant de choisir. Testez le comportement de repli, les paramètres, les catégories de pluriel et les processus d’extraction avec vos vrais messages. Une API pratique pour les chaînes anglaises ne garantit pas la prise en charge de toutes les langues que vous prévoyez de livrer.

intl n’est pas une plateforme concurrente de gestion des traductions. Il fournit des utilitaires d’internationalisation utilisés par les processus de localisation. gen-l10n génère des accesseurs applicatifs à partir des ressources ARB. Le package intl_utils, distinct, génère aussi du code de localisation, mais sa page était marquée comme abandonnée lors de notre vérification du 30 octobre 2026. Vérifiez son état de maintenance avant de l’adopter pour un nouveau projet.

Utilisez une matrice de test pratique :

La FAQ web de Flutter décrit son orientation vers les expériences applicatives et recommande une approche orientée document pour le contenu web statique riche en texte. Envisagez des pages marketing, d’aide et éditoriales distinctes en HTML lorsque ces pages doivent performer dans la recherche organique.

Gardez une terminologie alignée entre l’application et ces pages publiques. Un visiteur venu de la recherche doit reconnaître le nom de la fonctionnalité en passant de la page d’atterrissage localisée à l’application, même si les deux surfaces utilisent des systèmes de rendu différents.

Les formats de projet logiciel documentés par Smartcat incluent les imports JSON, YAML, Android XML, iOS .strings et LocJSON. La documentation consultée pour ce guide n’établit ni une prise en charge native de l’ARB, ni un processus de conversion ARB vers JSON testé. Ne supposez pas qu’un simple changement d’extension prouve la compatibilité. Consultez la documentation des projets logiciels.

Utilisez ce qui suit comme procédure de validation à proposer à votre équipe d’implémentation, et non comme une recette de connecteur déjà testée :