Skip to content

Traduction des textes de l'application

Date de création : 11 décembre 2025
Dernière modification le : 13 décembre 2025
Dernière modification par : Vanessa LEROY Statut : À relire

Pour rappel, j'appelle les textes de l'application : tout texte d'affichage, de messages utilisateurs et lié à l'intéraction.

🌿 Fonctionnalités

Ajouter des textes à l'application

Le code ne doit pas contenir de textes en dur. S'il n'existe pas déjà de traduction réalisé du texte souhaité, alors il y a une nouvelle clé de traduction à créer suivant le processus suivant :

  1. Ajoutez la clé dans lib/l10n/translation_keys.dart : 
    static const String newKey = 'newKey';

Les clés sont triés par fichiers. Si le fichier n'existe pas dans le fichier alors créé une nouvelle "section" pour facilement s'y retrouver. Le premier champ est la constante réutilisable dans le code, le second champ ('newKey') est celui qui sera réutilisé dans les fichiers de traductions.

  1. Ajoutez la traduction dans tous les fichiers de traductions du dossier assets/translations/ en respectant l'ordre des clés du fichier lib/l10n/translation_keys.dart (même si c'est dans un premier temps en français dans tous les fichiers)

  2. Utilisez-la clé directement dans le code : 

    context.translate(TranslationKeys.newKey)

Traduire les textes de l'application

Le processus est assez simple : 1. Traduire le texte dans le fichier du dossier assets/translations/ correspondant à la langue 2. Créer une nouvelle version de l'application mobile pour diffuser les nouvelles traductions ! 3. Vérifier que cela s'affiche correctement

⚡️ Tests à réaliser

Pour tester les traductions, il est important de mixer les situations : - Situation de l'Utilisateur : - [ ] Sans utilisateur connecté - [ ] Utilisateur Admin connecté - [ ] Utilisateur Testeur connecté - [ ] Utilisateur en période d'essai connecté - [ ] Utilisateur Payant connecté - [ ] Utilisateur Sans abonnement connecté - Tester toutes les fonctionnalités possibles pour générer un maximum de messages et vérifier qu'il est bien traduit

L'objectif est de découvrir les possibles oublies de traductions

Documentation techniques

Le fonctionnement du système de traduction est entièrement rassemblé dans lib/l10n/app_localizations.dart

🔗 Documents Complémentaires