localize.dev

Documenti / Traduci / Flutter ARB

Traduci file ARB Flutter

Traduci lib/l10n/app_en.arb in app_<lang>.arb per Flutter’s gen-l10n, con {placeholders}, messaggi plurali e select ICU, e descrizioni @key usate come contesto.

Come funziona

localize-dev translate legge il tuo file ARB modello, invia la descrizione di @key di ogni messaggio con esso come contesto e scrive app_ar.arb, app_pt_BR.arb e il resto con @@locale impostato. gen-l10n raccoglie i nuovi file e aggiunge le lingue a supportedLocales alla prossima build.

I messaggi plurali e select ICU vengono divisi nei loro rami, tradotti e riassemblati con le forme di cui la lingua ha bisogno. Le corrispondenze esatte come =0 rimangono, e il messaggio viene analizzato prima di essere scritto.

Prima e dopo

Output effettivo di localize-dev translate --locales ar sul primo file. L'arabo utilizza sei forme plurali, quindi il plurale itemCount ottiene zero, uno, due, pochi, molti e altri accanto al suo ramo =0.

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 · arabo
{
  "@@locale": "ar",
  "cartTitle": "عربتك",
  "greeting": "مرحباً {name}، هل أنت مستعد للدفع؟",
  "itemCount": "{count, plural, =0 {عربتك فارغة} zero {0 عناصر} one {عنصر واحد} two {عنصران} few {{count} عناصر} many {{count} عناصر} other {{count} عناصر}}"
}

Cosa rimane intatto

  • Segnaposto {name}, verificati
  • Plurali ICU con ogni forma CLDR utilizzata dalla lingua
  • Rami esatti =0 e =1 e rami select
  • I nomi dei file con underscore attesi da gen-l10n (app_pt_BR.arb)

Errori comuni e come vengono evitati

Solo one e other in ogni lingua

L'arabo ha sei forme plurali e il polacco quattro. Una other tradotta da sola fa sì che conteggi come 2 o 5 vengano letti in modo errato. Le forme utilizzate da ciascuna lingua sono scritte per ogni plurale.

Una parentesi graffa mancante

Un } non corrispondente in un messaggio ICU interrompe flutter gen-l10n. Ogni messaggio tradotto viene analizzato prima di essere scritto; uno che non viene analizzato viene ritentato, quindi omesso e segnalato.

Nessun contesto per stringhe brevi

“Book” può essere un sostantivo o un verbo. Aggiungi una descrizione sotto @book nel template e verrà inviata con il messaggio, in modo che la traduzione si adatti allo schermo su cui si trova.

Esegui

Nella cartella che contiene i file di localizzazione. Le lingue senza un file ne ottengono uno. --dry-run mostra cosa cambierebbe per primo.

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

Quindi tienilo completo in CI. Non richiede alcuna chiave API e fallisce quando a una lingua mancano le traduzioni:

npx localize-dev check --only translations

Gratuito per 1000 stringhe al mese. Una stringa conta una volta, indipendentemente da quante lingue includa. Crea un account gratuito

Guide per le app che utilizzano questo formato

Quando il testo è ancora hardcoded nel tuo codice, localize-dev run lo sposta prima in questo formato.