Flutter ARB

Переводите значения сообщений ARB, сохраняя метаданные ресурсов и определения плейсхолдеров.

Application Resource Bundle, или ARB, хранит сообщения Flutter вместе с описаниями и определениями плейсхолдеров. Обработчик файлов flutter переводит обычные строковые значения в этом плоском JSON-объекте, а ключи, начинающиеся с @, сохраняет как метаданные.

Сообщения и метаданные #

Например, в сообщении о доставке можно объявить числовой параметр, который оно принимает:

json
{
  "@@locale": "en",
  "delivery": "Delivery within {days} days",
  "@delivery": {
    "description": "Checkout estimate for the latest arrival date",
    "placeholders": {
      "days": { "type": "int" }
    }
  }
}

delivery становится единицей перевода. Соседний элемент @delivery.description служит подсказкой для перевода и остаётся метаданными в выходном файле. Определения плейсхолдеров переносятся без перевода. Обработчик не рассматривает произвольные вложенные объекты как дополнительные каталоги сообщений.

Если @@locale существует и указана целевая локаль, его значение обновляется при пересборке. Если @@locale отсутствует, он не добавляется автоматически. Остальные глобальные параметры набора сохраняют исходные значения.

Существующие значения и область обработки #

Предыдущая версия исходного файла позволяет определить по ключам, какие сообщения изменились. Существующий перевод может служить источником уже принятых значений. При пересборке используются метаданные текущего исходного файла. Поэтому изменения метаданных могут попасть в результат, даже если текст перевода используется повторно.

Если изменились сообщения, используйте обычное обновление исходного файла. Если изменились рекомендации по переводу, можно целенаправленно обновить весь файл — см. Области обработки CLI. Прежде чем запускать генерацию ресурсов Flutter, проверьте полученные сообщения и метаданные.

В выходном JSON используются отступы в два пробела и перевод строки в конце файла. Файл пересобирается по структуре — исходное форматирование не сохраняется побайтово.

Сначала переведите сообщения, затем сгенерируйте ресурсы Flutter #

CLI определяет flutter по .arb. Из исходного файла, например app_en.arb, создаются отдельные файлы для каждой локали, например app_de.arb. Убедитесь, что эти пути соответствуют настройкам локализации проекта. Для выбора файлов используйте конфигурацию CLI или GitHub.

После получения файлов запустите генератор локализации Flutter и проверки сборки проекта. Проверьте отображение сообщений с параметрами на реальных значениях и варианты множественного числа для каждой целевой локали. Сохранённые метаданные подсказывают генератору, чего ожидать, но в переводе сообщения всё равно нужно правильно использовать плейсхолдеры. В руководстве Как локализовать приложение Flutter описан весь путь работы с ресурсами вплоть до этой проверки в приложении.