Localización
Prioridad: P1 (ESTÁNDAR)
Soporte multilingüe consistente usando easy_localization.
Selección de Formato
- CSV (Recomendado para equipos con traductores):
- Editores no técnicos pueden actualizar fácilmente
- Compatibilidad nativa con Google Sheets mediante
sheet_loader_localization - Almacenar en
assets/langs/(convención común)
- JSON (Amigable para desarrolladores):
- Soporte de estructura anidada (ej.,
items_count.zero) - Validación y autocompletado en IDE
- Almacenar en
assets/translations/
- Soporte de estructura anidada (ej.,
Ambos formatos funcionan de manera idéntica con easy_localization.
Estructura
# Formato CSV (flujo de trabajo Google Sheets)
assets/langs/langs.csv
# O Formato JSON (claves anidadas)
assets/translations/
├── en.json
└── vi.json
Pautas de Implementación
- Inicialización: Envolver la raíz con
EasyLocalization. Usar siempreawait EasyLocalization.ensureInitialized(). - Búsqueda: Usar la extensión
.tr()en cadenas (ej.,'welcome'.tr()). - Locale: Cambiar mediante
context.setLocale(Locale('code')). - Parámetros: Usar placeholders
{}; pasarlos contr(args: [...]). - Conteo: Usar
plural()para cantidades. - Sincronización con Sheets: Usar
sheet_loader_localizationpara generar automáticamente CSV/JSON desde Google Sheets.
Anti-Patrones
- Hardcoding: No usar cadenas literales en la interfaz; usar claves.
- L10n manual: Evitar el uso estándar de
Localizations.of; usar métodos de contexto de GetX oeasy_localization. - Desincronización: Mantener las claves idénticas en todos los archivos de locale.
Referencia y Ejemplos
Para configuración y automatización con Google Sheets: Ver references/REFERENCE.md.
Temas Relacionados
idiomatic-flutter | widgets