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.
{
"@@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" } } }
}{
"@@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
=0y=1y 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,deLuego mantenlo completo en CI. Esto no necesita una clave API y falla cuando a un idioma le faltan traducciones:
npx localize-dev check --only translationsGratis 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.