localize.dev

Dokumentation / Übersetzen / Flutter ARB

Flutter ARB-Dateien übersetzen

Übersetzen Sie lib/l10n/app_en.arb in app_<lang>.arb für Flutter’s gen-l10n, mit {placeholders}, ICU Plural- und Select-Nachrichten und @key-Beschreibungen als Kontext.

Funktionsweise

localize-dev translate liest Ihre ARB-Vorlagendatei, sendet die @key-Beschreibung jeder Nachricht als Kontext mit und schreibt app_ar.arb, app_pt_BR.arb und den Rest mit gesetztem @@locale. gen-l10n greift die neuen Dateien auf und fügt die Sprachen beim nächsten Build zu supportedLocales hinzu.

ICU Plural- und Select-Nachrichten werden in ihre Zweige aufgeteilt, übersetzt und mit den Formen, die die Sprache benötigt, wieder zusammengesetzt. Exakte Übereinstimmungen wie =0 bleiben erhalten, und die Nachricht wird geparst, bevor sie geschrieben wird.

Vorher und nachher

Reale Ausgabe von localize-dev translate --locales ar in der ersten Datei. Arabisch verwendet sechs Pluralformen, sodass die itemCount Pluralform neben ihrem =0-Zweig die Formen null, eins, zwei, wenige, viele und andere erhält.

lib/l10n/app_en.arb
{
  "@@locale": "en",
  "cartTitle": "Your cart",
  "@cartTitle": { "description": "Title of the shopping cart screen" },
  "greeting": "Hi {name}, ready to check out?",
  "@greeting": { "placeholders": { "name": { "type": "String" } } },
  "itemCount": "{count, plural, =0{Your cart is empty} =1{1 item} other{{count} items}}",
  "@itemCount": { "placeholders": { "count": { "type": "int" } } }
}
lib/l10n/app_ar.arb · Arabisch
{
  "@@locale": "ar",
  "cartTitle": "عربتك",
  "greeting": "مرحباً {name}، هل أنت مستعد للدفع؟",
  "itemCount": "{count, plural, =0 {عربتك فارغة} zero {0 عناصر} one {عنصر واحد} two {عنصران} few {{count} عناصر} many {{count} عناصر} other {{count} عناصر}}"
}

Was intakt bleibt

  • {name} Platzhalter, geprüft
  • ICU-Pluralformen mit jeder CLDR-Form, die die Sprache verwendet
  • Exakte =0- und =1-Zweige und Select-Zweige
  • Die von gen-l10n erwarteten Unterstrich-Dateinamen (app_pt_BR.arb)

Häufige Fehler und wie sie vermieden werden

Nur one und other in jeder Sprache

Arabisch hat sechs Pluralformen und Polnisch vier. Eine übersetzte other allein lässt Zählungen wie 2 oder 5 falsch lesen. Die Formen, die jede Sprache verwendet, werden für jeden Plural aufgeschrieben.

Eine fehlende Klammer

Ein nicht übereinstimmendes } in einer ICU-Nachricht stoppt flutter gen-l10n. Jede übersetzte Nachricht wird geparst, bevor sie geschrieben wird; eine, die nicht geparst werden kann, wird erneut versucht und dann weggelassen und gemeldet.

Kein Kontext für kurze Strings

„Book“ kann ein Substantiv oder ein Verb sein. Fügen Sie eine Beschreibung unter @book in der Vorlage hinzu, und sie wird mit der Nachricht gesendet, sodass die Übersetzung auf den Bildschirm passt, auf dem sie angezeigt wird.

Ausführen

In dem Ordner, der Ihre Lokalisierungsdateien enthält. Sprachen ohne eine Datei erhalten eine. --dry-run zeigt, was sich zuerst ändern würde.

npx localize-dev login

# Preview, then write the missing translations
npx localize-dev translate --dry-run -l es,fr,de
npx localize-dev translate -l es,fr,de

Dann halten Sie es in der CI vollständig. Dies erfordert keinen API-Schlüssel und schlägt fehl, wenn eine Sprache Übersetzungen vermisst:

npx localize-dev check --only translations

Kostenlos für 1.000 Strings pro Monat. Ein String zählt einmal, egal in wie viele Sprachen er übersetzt wird. Erstellen Sie ein kostenloses Konto

Anleitungen für Apps, die dieses Format verwenden

Wenn der Text noch fest in Ihrem Code codiert ist, verschiebt localize-dev run ihn zuerst in dieses Format.