Flutter ARB

Nachrichtenwerte in ARB-Dateien übersetzen und dabei Ressourcenmetadaten und Platzhalterdefinitionen beibehalten.

Ein Application Resource Bundle, kurz ARB, enthält Flutter-Nachrichten samt Beschreibungen und Platzhalterdefinitionen. Der Dateihandler flutter übersetzt einfache Zeichenfolgeneinträge in diesem flachen JSON-Objekt. Schlüssel, die mit @ beginnen, bleiben als Metadaten erhalten.

Nachrichten und Metadaten #

Eine Nachricht zur Lieferung kann beispielsweise die Zahl deklarieren, die ihr übergeben wird:

json
{
  "@@locale": "en",
  "delivery": "Delivery within {days} days",
  "@delivery": {
    "description": "Checkout estimate for the latest arrival date",
    "placeholders": {
      "days": { "type": "int" }
    }
  }
}

delivery wird zu einer Übersetzungseinheit. Der Eintrag @delivery.description auf derselben Ebene dient als Übersetzungshinweis und bleibt in der Ausgabe als Metadatum erhalten. Platzhalterdefinitionen werden unverändert übernommen und nicht übersetzt. Beliebige verschachtelte Objekte behandelt der Handler nicht als zusätzliche Nachrichtenkataloge.

Wenn @@locale vorhanden ist und eine Zielsprache angegeben wird, aktualisiert die Rekonstruktion diesen Eintrag. Ein fehlender Eintrag @@locale wird nicht automatisch hinzugefügt. Die übrigen globalen Werte des Bundles behalten ihre Quellwerte.

Vorhandene Werte und Geltungsbereich #

Anhand der vorherigen Quelle werden Änderungen an Nachrichten über ihre Schlüssel erkannt. Das vorhandene Ziel kann bereits akzeptierte Werte liefern. Bei der Rekonstruktion werden die Metadaten der aktuellen Quelle verwendet. Änderungen an den Quellmetadaten können daher auch dann in der Ausgabe erscheinen, wenn der Wortlaut einer Nachricht wiederverwendet wird.

Nutze für geänderte Nachrichten die reguläre Aktualisierung der Quelle. Wenn du die Übersetzungsvorgaben geändert hast, kannst du stattdessen gezielt die gesamte Datei aktualisieren; siehe CLI-Geltungsbereiche. Kontrolliere die entstandenen Nachrichten und Metadaten, bevor du die Flutter-Generierung startest.

Die JSON-Ausgabe wird mit zwei Leerzeichen eingerückt und endet mit einem Zeilenumbruch. Die Struktur wird dabei rekonstruiert; die Formatierung der Quelle bleibt nicht bytegetreu erhalten.

Erst übersetzen, dann Flutter-Ressourcen generieren #

Die CLI leitet flutter aus .arb ab. Aus einer Quelle wie app_en.arb entstehen Dateien pro Sprache, etwa app_de.arb. Stimme diese Pfade auf die Lokalisierungskonfiguration des Projekts ab. Nutze für die Dateiauswahl die CLI-Konfiguration oder GitHub.

Führe nach dem Abrufen den Flutter-Lokalisierungsgenerator des Projekts und die Build-Prüfungen aus. Stelle parametrisierte Nachrichten mit echten Werten dar und teste die Pluralfälle in jeder Zielsprache. Die beibehaltenen Metadaten geben dem Generator vor, was er erwarten soll. Die übersetzte Nachricht muss die Platzhalter dennoch korrekt verwenden. Eine Flutter-App lokalisieren zeigt, wie du die Ressourcen bis zu dieser Kontrolle in der Anwendung einsetzt.