localize.dev

Documentación / Traducir / Flutter ARB

Traducir archivos ARB de Flutter

Traduce lib/l10n/app_en.arb a app_<lang>.arb para Flutter’s gen-l10n, con {placeholders}, mensajes plurales y select de ICU, y descripciones de @key usadas como contexto.

Cómo funciona

localize-dev translate lee su archivo ARB de plantilla, envía la descripción de @key de cada mensaje con él como contexto, y escribe app_ar.arb, app_pt_BR.arb y el resto con @@locale establecido. gen-l10n recoge los nuevos archivos y añade los idiomas a supportedLocales en la próxima compilación.

Los mensajes plurales y select de ICU se dividen en sus ramas, se traducen y se vuelven a unir con las formas que necesita el idioma. Las coincidencias exactas como =0 permanecen, y el mensaje se analiza antes de escribirlo.

Antes y después

Salida real de localize-dev translate --locales ar en el primer archivo. El árabe utiliza seis formas plurales, por lo que el plural itemCount recibe cero, uno, dos, pocos, muchos y otros junto a su rama =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 · árabe
{
  "@@locale": "ar",
  "cartTitle": "عربتك",
  "greeting": "مرحباً {name}، هل أنت مستعد للدفع؟",
  "itemCount": "{count, plural, =0 {عربتك فارغة} zero {0 عناصر} one {عنصر واحد} two {عنصران} few {{count} عناصر} many {{count} عناصر} other {{count} عناصر}}"
}

Lo que se mantiene intacto

  • Marcadores de posición {name}, verificados
  • Plurales de ICU con cada forma CLDR que usa el idioma
  • Ramas exactas de =0 y =1 y ramas select
  • Los nombres de archivo con guion bajo que espera gen-l10n (app_pt_BR.arb)

Errores comunes y cómo se evitan

Solo one y other en cada idioma

El árabe tiene seis formas plurales y el polaco cuatro. Una other traducida sola hace que los recuentos como 2 o 5 se lean mal. Las formas que usa cada idioma se escriben para cada plural.

Una llave faltante

Un } no coincidente en un mensaje ICU detiene flutter gen-l10n. Cada mensaje traducido se analiza antes de escribirlo; uno que no se analiza se reintenta y luego se omite y se informa.

Sin contexto para cadenas cortas

“Book” puede ser un sustantivo o un verbo. Agregue una descripción debajo de @book en la plantilla y se enviará con el mensaje, para que la traducción se ajuste a la pantalla en la que se encuentra.

Ejecutar

En la carpeta que contiene tus archivos de localización. Los idiomas que aún no tienen archivo obtienen uno. --dry-run muestra qué cambiaría primero.

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

Luego mantenlo completo en CI. Esto no necesita una clave API y falla cuando a un idioma le faltan traducciones:

npx localize-dev check --only translations

Gratis para 1000 cadenas al mes. Una cadena cuenta una vez sin importar en cuántos idiomas se incluya. Crea una cuenta gratuita

Guías para aplicaciones que usan este formato

Cuando el texto todavía está codificado en tu código, localize-dev run lo mueve a este formato primero.