Traducir

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.

Fuentelib/l10n/app_en.arb
{
  "@@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" } }
  }
}
Alemán, anteslib/l10n/app_de.arb
{
  "@@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.

Terminalexit code 1
$ 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.

Terminalexit code 0
$ 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.
Alemán, despuéslib/l10n/app_de.arb
{
  "@@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.

Terminalexit code 1
$ 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

Cuánto cuesta

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