Traducir archivos ARB de Flutter y comprobar el resultado
app_de.arb se queda atrás respecto a app_en.arb: falta una clave, se perdió una rama ICU. Para una clave que falta, gen-l10n usa el texto de la plantilla, así que el hueco llega a producción. Abajo, un comando lo encuentra y otro lo rellena.
KAERIS ha traducido esta página y revisado cada línea traduciéndola de vuelta. Un hablante nativo aún no la ha revisado. Original en inglés
El proyecto de ejemplo
Un pequeño proyecto Flutter ARB: la fuente en inglés y un archivo alemán que se quedó atrás. Los comandos de abajo se ejecutaron exactamente sobre estos archivos.
{
"@@locale": "en",
"greeting": "Hi, {name}!",
"@greeting": {
"placeholders": { "name": { "type": "String" } }
},
"unreadCount": "{count, plural, =0{No new messages} =1{1 new message} other{{count} new messages}}",
"@unreadCount": {
"placeholders": { "count": { "type": "int" } }
},
"signOut": "Sign out",
"lastSeen": "Last seen {date}",
"@lastSeen": {
"placeholders": { "date": { "type": "DateTime", "format": "yMMMd" } }
}
}
{
"@@locale": "de",
"greeting": "Hallo, {name}!",
"unreadCount": "{count, plural, =0{Keine neuen Nachrichten} other{Neue Nachrichten}}",
"signOut": "Abmelden"
}
1. Encontrar lo que falta
kaeris check compara cada traducción con el archivo fuente. Funciona sin conexión, sin clave ni cuenta, y termina con código 1 si encuentra un problema, así que un job de CI puede detenerse en él.
$ npx kaeris check --source lib/l10n/app_en.arb --langs de
✗ de: 1 missing key(s): lastSeen
✗ de: 2 translation fault(s):
unreadCount: number 1 from the source is missing or changed in the translation
unreadCount: ICU exact-match branch =1 {…} was dropped in the translation
✗ 1 missing key, 2 translation faults
2. Traducir solo las claves que faltan
--only-new envía solo las claves que le faltan al archivo alemán y las añade. Las líneas que ya están en el archivo se quedan como están, incluidas las rotas. El comando está en el paquete de Python: pip install kaeris.
$ kaeris translate lib/l10n/app_en.arb --langs de --only-new
→ no key: free demo limits 10,000 chars per file, 8 languages per run, get a key: kaeris.dev/developer
→ de: 1 new key(s) to translate
→ Run: openai/gpt-6-luna · Free · 1/1 languages · 1 strings · 3.5s
16 charged
✓ Translation QA: no placeholder loss, no overflow risks
→ Project memory: +1 · 1 strings, 1 translations in kaeris-tm.json
✓ de: merged 1 key(s) → lib/l10n/app_de.arb
→ 3 key(s) already exist in de but nothing in kaeris.lock vouches for them, so they were left alone AND left unlocked. If the source changed after those files were made, those edits are NOT translated. Re-run once with --no-only-new to rebuild them, or with --assume-current if the files are known to match.
{
"@@locale": "de",
"greeting": "Hallo, {name}!",
"unreadCount": "{count, plural, =0{Keine neuen Nachrichten} other{Neue Nachrichten}}",
"signOut": "Abmelden",
"lastSeen": "Zuletzt gesehen {date}"
}
3. Comprobar de nuevo
Las claves que faltaban están rellenas. Lo que queda ya estaba roto antes de esta ejecución: corrija esas líneas a mano o vuelva a traducir todo el archivo con --no-only-new.
$ npx kaeris check --source lib/l10n/app_en.arb --langs de
✗ de: 2 translation fault(s):
unreadCount: number 1 from the source is missing or changed in the translation
unreadCount: ICU exact-match branch =1 {…} was dropped in the translation
✗ 2 translation faults
Ejecutado el 2 de noviembre de 2026 en el plan gratuito, sin clave: npx kaeris 0.2.42 para la comprobación, kaeris 0.2.42 de PyPI para la traducción. Salida tal como se imprimió, salvo las líneas de progreso y la ruta de la carpeta local.
Qué detecta kaeris check en Flutter ARB
Claves que faltan
Una clave de
app_en.arbque no está enapp_de.arb. Los metadatos@keyno son obligatorios en una traducción.Ramas ICU exactas
Una rama
=1perdida se detecta, igual que el número que contenía.Placeholders renombrados
{userName}en lugar de{name}cuenta como uno perdido y uno inventado.Falta
otherUn plural o select sin la rama
otheres un error.
Cuánto cuesta
kaeris checkes gratisSe ejecuta en su máquina: sin clave, sin cuenta, sin límite.
Traducir empieza gratis
Sin clave: 10.000 caracteres por archivo, 300.000 al día, hasta 8 idiomas por ejecución. Una clave gratuita lo sube a 50.000 caracteres por archivo y 1,5 M al mes. El volumen cuenta los caracteres una vez por idioma de destino.
Más allá del plan gratuito
Lifetime cuesta $79 una sola vez y funciona con su propia clave de OpenRouter, así que el modelo se paga aparte. Pro cuesta $19 al mes o $190 al año, por 12 M de caracteres al mes. Precios
Preguntas
¿Hacen falta las entradas @metadata en app_de.arb?
No. Los placeholders se describen una vez, en app_en.arb. La comprobación no pide entradas @key en una traducción, y la ejecución de arriba no añadió ninguna.
¿Funciona con gen-l10n?
Sí. Los archivos conservan los nombres app_<lang>.arb que flutter gen-l10n lee de lib/l10n. Vea también archivos ARB.
¿Puede ejecutarse en CI?
Sí. npx kaeris check termina con código 1 si encuentra un problema. Recetas: GitHub Actions, GitLab CI, pre-commit.
Seguir adelante
Referencia de check · Referencia de la CLI · Comprobación gratuita en el navegador · Traducir en el navegador
Otros stacks: react-i18next · next-intl · vue-i18n · iOS · Android