Lokalisierung
Priorität: P1 (STANDARD)
Konsistente mehrsprachige Unterstützung mit easy_localization.
Formatauswahl
- CSV (Empfohlen für Teams mit Übersetzern):
- Nicht-technische Editoren können einfach aktualisieren
- Native Google Sheets-Kompatibilität via
sheet_loader_localization - Speichern in
assets/langs/(übliche Konvention)
- JSON (Entwicklerfreundlich):
- Unterstützung verschachtelter Strukturen (z. B.
items_count.zero) - IDE-Validierung und Autovervollständigung
- Speichern in
assets/translations/
- Unterstützung verschachtelter Strukturen (z. B.
Beide Formate funktionieren identisch mit easy_localization.
Struktur
# CSV-Format (Google Sheets-Workflow)
assets/langs/langs.csv
# ODER JSON-Format (verschachtelte Schlüssel)
assets/translations/
├── en.json
└── vi.json
Implementierungsrichtlinien
- Bootstrap: Root-Element mit
EasyLocalizationumschließen. Immerawait EasyLocalization.ensureInitialized()verwenden. - Lookup:
.tr()-Erweiterung auf Strings verwenden (z. B.'welcome'.tr()). - Locale: Über
context.setLocale(Locale('code'))ändern. - Parameter:
{}-Platzhalter verwenden; viatr(args: [...])übergeben. - Zählen:
plural()für Mengenangaben verwenden. - Sheets-Synchronisation:
sheet_loader_localizationverwenden, um CSV/JSON aus Google Sheets automatisch zu generieren.
Anti-Patterns
- Hardcoding: Keine Rohstrings im UI; Schlüssel verwenden.
- Manuelle L10n: Standard
Localizations.ofvermeiden; GetX- odereasy_localization-Kontextmethoden nutzen. - Desynchronisation: Schlüssel in allen Lokalisierungsdateien identisch halten.
Referenzen & Beispiele
Für Einrichtung und Google Sheets-Automatisierung: Siehe references/REFERENCE.md.
Verwandte Themen
idiomatic-flutter | widgets