Localisation
Priorité : P1 (STANDARD)
Support multilingue cohérent avec easy_localization.
Sélection du format
- CSV (Recommandé pour les équipes avec traducteurs) :
- Les éditeurs non techniques peuvent mettre à jour facilement
- Compatibilité native avec Google Sheets via
sheet_loader_localization - Stocker dans
assets/langs/(convention courante)
- JSON (Adapté aux développeurs) :
- Support de structure imbriquée (ex.
items_count.zero) - Validation IDE et autocomplétion
- Stocker dans
assets/translations/
- Support de structure imbriquée (ex.
Les deux formats fonctionnent de manière identique avec easy_localization.
Structure
# Format CSV (workflow Google Sheets)
assets/langs/langs.csv
# OU Format JSON (clés imbriquées)
assets/translations/
├── en.json
└── vi.json
Directives d'implémentation
- Amorçage : Encapsuler la racine avec
EasyLocalization. Toujours utiliserawait EasyLocalization.ensureInitialized(). - Recherche : Utiliser l'extension
.tr()sur les chaînes (ex.'welcome'.tr()). - Locale : Modifier via
context.setLocale(Locale('code')). - Paramètres : Utiliser des espaces réservés
{}; passer viatr(args: [...]). - Comptage : Utiliser
plural()pour les quantités. - Synchronisation des feuilles : Utiliser
sheet_loader_localizationpour générer automatiquement CSV/JSON à partir de Google Sheets.
Anti-patrons
- Codage en dur : Pas de chaînes brutes dans l'interface utilisateur ; utiliser des clés.
- L10n manuelle : Éviter d'utiliser
Localizations.ofstandard ; utiliser les méthodes de contexte GetX oueasy_localization. - Désynchronisation : Garder les clés identiques dans tous les fichiers de locale.
Références et exemples
Pour l'installation et l'automatisation Google Sheets : Voir references/REFERENCE.md.
Sujets connexes
idiomatic-flutter | widgets