7. Internacionalización
7.1. Ejemplo 21: una aplicación bilingüe
Una aplicación bilingüe tiene tres tipos de texto que traducir:
- el texto de la aplicación: etiquetas y mensajes. Se almacenan en diccionarios, uno por idioma;
- las fechas y los montos: el paquete [intl] (véase el ejemplo 09), en el idioma actual;
- el texto del paquete de [Flutter] mismo: los botones de sus ventanas, los días y los meses de su calendario. El paquete [flutter_localizations] los proporciona.
7.1.1. Los diccionarios
Cada texto tiene una clave ("HOME.HELLO"). Los parámetros se escriben como [{{name}}]; un texto en plural tiene varias claves, como [_zero], [_one] y [_other]. Estas son las convenciones de la biblioteca [JavaScript] [i18next] , utilizada por los clientes [React] y [Vue.js] de [RdvMedecins]: el caso de estudio usará sus diccionarios tal cual. El diccionario en inglés tiene las mismas claves:
7.1.2. Las traducciones
- líneas 30–34: las traducciones: un [ChangeNotifier] (las pantallas se reconstruirán cuando cambie el idioma), que conserva el idioma actual y su diccionario;
- líneas 42–45: el idioma de origen: el almacenado en el dispositivo; si no, el idioma del teléfono (si se conoce); si no, inglés;
- líneas 48–54: cambiar de idioma: cargar el diccionario, un archivo JSON incluido con la aplicación ([rootBundle.loadString] lee un archivo de la sección [assets] de [pubspec.yaml]), decodificarlo ([jsonDecode]), guardar la selección y actualizar las pantallas;
- líneas 58–63: búsqueda de la clave “HOME.HELLO” en el diccionario: recorre, sección por sección, los objetos JSON anidados. [node is Map<String, Object?> ? ... : null]: una verificación de tipo que “promueve” la variable en la rama donde es verdadera;
- Líneas 66–83: la traducción. Para un plural (un parámetro entero [count]), [Intl.pluralLogic] elige la forma según las reglas del idioma: en francés, 0 y 1 son singular; en inglés, solo 1. Una clave desconocida se muestra tal cual: se ve de inmediato qué falta. Por último, cada [{{name}}] se reemplaza por el valor del parámetro.
¿Por qué no usar la herramienta oficial de [Flutter]? [Flutter] ofrece un generador ([flutter gen-l10n]) que crea, a partir de archivos [.arb], una clase con un método por texto ([AppLocalizations.of(context).hello('Marie')]): las claves se validan en tiempo de compilación. Es la mejor solución para una aplicación en la que todos los textos se conocen de antemano. Pero nuestro servidor devuelve claves (“ERRORS.LOGIN_TAKEN”) que deben traducirse en tiempo de ejecución: un diccionario consultado por clave es mucho más adecuado para este fin y permite compartir los diccionarios con otros clientes.
7.1.3. La página traducida
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 | |
- líneas 30–31: una extensión de [BuildContext] (véase el ejemplo 09): [context.t('KEY')] lee las traducciones proporcionadas más arriba, se suscribe a las actualizaciones y realiza la traducción;
- líneas 36–38: inicialización: los nombres de los días y de los meses en todos los idiomas, seguidos de las traducciones;
- línea 39: [ChangeNotifierProvider.value] proporciona un objeto ya creado (por [main]);
- línea 50: el título de la aplicación, traducido;
- líneas 52–54: el idioma de [Flutter] sigue al de la aplicación;
- líneas 76–77: la fecha y el precio, formateados en el idioma actual y luego pasados como parámetros a los textos;
- líneas 86–90: la selección del idioma en la barra superior;
- línea 110: [count] selecciona la forma plural y reemplaza a [{{count}}];
- líneas 124–128: el calendario de [Flutter]: sus textos siguen el idioma de [MaterialApp];
- líneas 144–146: lo que devolvería el servidor [RdvMedecins]: una clave y sus parámetros. La clave del servidor ES una clave del diccionario.
En inglés (izquierda); en francés, después de una adición (centro); el calendario, en francés (derecha):
![]() | ![]() | ![]() |
Cambiar el idioma vuelve a renderizar toda la pantalla sin reiniciar y sin hacer ninguna solicitud al servidor. El idioma seleccionado se guarda en el dispositivo.


