7. Internacionalização
7.1. Exemplo 21: um aplicativo bilíngue
Um aplicativo bilíngue tem três tipos de texto a traduzir:
- os textos do aplicativo: rótulos e mensagens. Eles são guardados em dicionários, um por idioma;
- as datas e os valores: o pacote [intl] (veja o exemplo 09), no idioma atual;
- os textos do pacote [Flutter] em si: os botões de suas janelas, os dias e os meses de seu calendário. O pacote [flutter_localizations] fornece esses textos.
7.1.1. Os dicionários
Cada texto tem uma chave ("HOME.HELLO"). Os parâmetros são escritos como [{{name}}]; um texto no plural tem várias chaves, como [_zero], [_one] e [_other]. Essas são as convenções da biblioteca [JavaScript] [i18next] , usada pelos clientes [React] e [Vue.js] do [RdvMedecins]: o estudo de caso usará seus dicionários como estão. O dicionário em inglês tem as mesmas chaves:
7.1.2. As traduções
- linhas 30–34: as traduções: um [ChangeNotifier] (as telas serão reconstruídas quando o idioma mudar), que guarda o idioma atual e seu dicionário;
- linhas 42–45: o idioma inicial: o armazenado no dispositivo; caso contrário, o idioma do celular (se conhecido); caso contrário, o inglês;
- linhas 48–54: mudar o idioma: carregar o dicionário, um arquivo JSON incluído no aplicativo ([rootBundle.loadString] lê um arquivo da seção [assets] do [pubspec.yaml]), decodificá-lo ([jsonDecode]), salvar a seleção e atualizar as telas;
- linhas 58–63: busca a chave “HOME.HELLO” no dicionário: percorre, seção por seção, os objetos JSON aninhados. [node is Map<String, Object?> ? ... : null]: uma verificação de tipo, que “promove” a variável no ramo em que é verdadeira;
- Linhas 66–83: a tradução. Para um plural (um parâmetro inteiro [count]), [Intl.pluralLogic] escolhe a forma de acordo com as regras do idioma: em francês, 0 e 1 são singular; em inglês, apenas 1. Uma chave desconhecida é exibida como está: dá para ver imediatamente o que está faltando. Por fim, cada [{{name}}] é substituído pelo valor do parâmetro.
Por que não usar a ferramenta oficial do [Flutter]? [Flutter] oferece um gerador ([flutter gen-l10n]) que cria, a partir de arquivos [.arb], uma classe com um método por texto ([AppLocalizations.of(context).hello('Marie')]): as chaves são validadas em tempo de compilação. É a melhor solução para uma aplicação em que todos os textos são conhecidos de antemão. Mas nosso servidor devolve chaves (“ERRORS.LOGIN_TAKEN”) que precisam ser traduzidas em tempo de execução: um dicionário, consultado pela chave, é muito mais adequado para isso e permite compartilhar os dicionários com outros clientes.
7.1.3. A página traduzida
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 | |
- linhas 30–31: uma extensão de [BuildContext] (veja o exemplo 09): [context.t('KEY')] lê as traduções fornecidas acima, assina as atualizações e realiza a tradução;
- linhas 36–38: inicialização: os nomes dos dias e dos meses em todos os idiomas, seguidos das traduções;
- linha 39: [ChangeNotifierProvider.value] fornece um objeto JÁ criado (por [main]);
- linha 50: o título da aplicação, traduzido;
- linhas 52–54: o idioma do [Flutter] em si segue o da aplicação;
- linhas 76–77: a data e o preço, formatados no idioma atual e depois passados como parâmetros aos textos;
- linhas 86–90: a seleção do idioma na barra superior;
- linha 110: [count] seleciona a forma plural e substitui [{{count}}];
- linhas 124–128: o calendário do [Flutter]: seus textos seguem o idioma do [MaterialApp];
- linhas 144–146: o que o servidor [RdvMedecins] devolveria: uma chave e seus parâmetros. A chave do servidor É uma chave do dicionário.
Em inglês (à esquerda); em francês, após uma inclusão (no meio); o calendário, em francês (à direita):
![]() | ![]() | ![]() |
A troca de idioma renderiza novamente a tela inteira, sem reiniciar e sem fazer nenhuma requisição ao servidor. O idioma selecionado é armazenado no dispositivo.


