Localização
Prioridade: P1 (PADRÃO)
Suporte consistente a múltiplos idiomas usando easy_localization.
Seleção de Formato
- CSV (Recomendado para equipes com tradutores):
- Editores não técnicos podem atualizar facilmente
- Compatibilidade nativa com Google Sheets via
sheet_loader_localization - Armazene em
assets/langs/(convenção comum)
- JSON (Favorável para desenvolvedores):
- Suporte a estrutura aninhada (ex.:
items_count.zero) - Validação e autocomplete na IDE
- Armazene em
assets/translations/
- Suporte a estrutura aninhada (ex.:
Ambos os formatos funcionam de forma idêntica com easy_localization.
Estrutura
# Formato CSV (fluxo Google Sheets)
assets/langs/langs.csv
# OU Formato JSON (chaves aninhadas)
assets/translations/
├── en.json
└── vi.json
Diretrizes de Implementação
- Inicialização: Envolva a raiz com
EasyLocalization. Sempre useawait EasyLocalization.ensureInitialized(). - Consulta: Use a extensão
.tr()em strings (ex.:'welcome'.tr()). - Locale: Altere via
context.setLocale(Locale('code')). - Parâmetros: Use placeholders
{}; passe viatr(args: [...]). - Contagem: Use
plural()para quantidades. - Sincronização com Planilhas: Use
sheet_loader_localizationpara gerar automaticamente CSV/JSON a partir do Google Sheets.
Anti-Padrões
- Hardcoding: Sem strings literais na UI; use chaves.
- Manual L10n: Evite
Localizations.ofpadrão; use GetX ou métodos de contexto doeasy_localization. - Dessincronização: Mantenha as chaves idênticas em todos os arquivos de localidade.
Referências e Exemplos
Para configuração e automação com Google Sheets: Veja references/REFERENCE.md.
Tópicos Relacionados
idiomatic-flutter | widgets