Перекласти ARB-файли Flutter і перевірити результат
app_de.arb відстає від app_en.arb: бракує ключа, загублено гілку ICU. Для відсутнього ключа gen-l10n бере текст шаблону, і пропуск іде в реліз. Нижче одна команда його знаходить, інша заповнює.
KAERIS переклав цю сторінку та перевірив кожен рядок зворотним перекладом. Носій мови ще не переглядав її. Оригінал англійською
Приклад проєкту
Невеликий проєкт на Flutter 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" } }
}
}
{
"@@locale": "de",
"greeting": "Hallo, {name}!",
"unreadCount": "{count, plural, =0{Keine neuen Nachrichten} other{Neue Nachrichten}}",
"signOut": "Abmelden"
}
1. Знайти, чого бракує
kaeris check порівнює кожен переклад із вихідним файлом. Він працює офлайн, без ключа й акаунта, і завершується з кодом 1, якщо знаходить проблему, тож завдання CI може на ньому зупинитися.
$ 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.
$ 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. Перевірити ще раз
Відсутні ключі заповнено. Лишилося те, що було зламано до цього запуску: виправте ці рядки вручну або перекладіть увесь файл заново з --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
Запуск 2 листопада 2026 року на безкоштовному тарифі, без ключа: npx kaeris 0.2.42 для перевірки, kaeris 0.2.42 з PyPI для перекладу. Вивід як надруковано, крім рядків прогресу й локального шляху до теки.
Що kaeris check ловить у Flutter ARB
Відсутні ключі
Ключ з
app_en.arb, якого немає вapp_de.arb. Метадані@keyу перекладі не обов'язкові.Точні гілки ICU
Загублена гілка
=1знаходиться, як і число, що в ній було.Перейменовані плейсхолдери
{userName}замість{name}рахується як один загублений і один вигаданий.Немає гілки
otherplural або select без гілки
otherвважається помилкою.
Скільки це коштує
kaeris checkбезкоштовнийПрацює на вашій машині: без ключа, без акаунта, без ліміту.
Переклад можна почати безкоштовно
Без ключа: 10 000 символів на файл, 300 000 на день, до 8 мов за запуск. Безкоштовний ключ підіймає ліміт до 50 000 символів на файл і 1,5 млн на місяць. Обсяг рахує символи по разу на кожну цільову мову.
Понад безкоштовний тариф
Lifetime коштує $79 один раз і працює на вашому ключі OpenRouter, тож модель оплачується окремо. Pro коштує $19 на місяць або $190 на рік, 12 млн символів на місяць. Ціни
Запитання
Чи потрібні записи @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