Перекласти

Перекласти ARB-файли Flutter і перевірити результат

app_de.arb відстає від app_en.arb: бракує ключа, загублено гілку ICU. Для відсутнього ключа gen-l10n бере текст шаблону, і пропуск іде в реліз. Нижче одна команда його знаходить, інша заповнює.

KAERIS переклав цю сторінку та перевірив кожен рядок зворотним перекладом. Носій мови ще не переглядав її. Оригінал англійською

Приклад проєкту

Невеликий проєкт на Flutter ARB: англійський вихідний файл і німецький, що відстав. Команди нижче запускалися саме на цих файлах.

Вихідний файлlib/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" } }
  }
}
Німецька, доlib/l10n/app_de.arb
{
  "@@locale": "de",
  "greeting": "Hallo, {name}!",
  "unreadCount": "{count, plural, =0{Keine neuen Nachrichten} other{Neue Nachrichten}}",
  "signOut": "Abmelden"
}

1. Знайти, чого бракує

kaeris check порівнює кожен переклад із вихідним файлом. Він працює офлайн, без ключа й акаунта, і завершується з кодом 1, якщо знаходить проблему, тож завдання CI може на ньому зупинитися.

Терміналexit 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. Перекласти лише відсутні ключі

--only-new надсилає лише ключі, яких немає в німецькому файлі, і вписує їх туди. Рядки, що вже є у файлі, лишаються як були, зламані теж. Команда входить до пакета Python: pip install kaeris.

Терміналexit 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.
Німецька, післяlib/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. Перевірити ще раз

Відсутні ключі заповнено. Лишилося те, що було зламано до цього запуску: виправте ці рядки вручну або перекладіть увесь файл заново з --no-only-new.

Терміналexit 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

Запуск 2 листопада 2026 року на безкоштовному тарифі, без ключа: npx kaeris 0.2.42 для перевірки, kaeris 0.2.42 з PyPI для перекладу. Вивід як надруковано, крім рядків прогресу й локального шляху до теки.

Що kaeris check ловить у Flutter ARB

Скільки це коштує

Запитання

Чи потрібні записи @metadata в app_de.arb?

Ні. Плейсхолдери описуються один раз, в app_en.arb. Перевірка не вимагає записів @key у перекладі, і запуск вище їх не додав.

Чи працює це з gen-l10n?

Так. Файли зберігають імена app_<lang>.arb, які flutter gen-l10n читає з lib/l10n. Див. також файли ARB.

Чи може він працювати в CI?

Так. npx kaeris check завершується з кодом 1, якщо знаходить проблему. Рецепти: GitHub Actions, GitLab CI, pre-commit.

Продовжуйте

Довідка з check · Довідка з CLI · Безкоштовна перевірка в браузері · Переклад у браузері

Інші стеки: react-i18next · next-intl · vue-i18n · iOS · Android