Добавление локализации в Flow Builder

Локализация флоу делает их доступными на нескольких языках. В Flow Builder локализация организована по экранам — каждый из них показывает процент выполнения для отслеживания прогресса перевода.

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

Добавление и настройка локализации

  1. На левой панели нажмите . Затем нажмите Add locale. Выберите языки для добавления.
Add locale dialog
  1. Каждый добавленный язык отображается в виде столбца в таблице локализации, предзаполненного значениями языка по умолчанию.

  2. Чтобы сосредоточиться только на незаполненных полях, включите переключатель Missing only на левой панели. Таблица отфильтруется и покажет только непереведённые строки.

Localization table

Установите язык по умолчанию

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

Значок булавки обозначает язык по умолчанию. Удалить язык по умолчанию нельзя, пока другой язык не будет назначен языком по умолчанию.

Чтобы изменить язык по умолчанию, откройте контекстное меню в заголовке столбца нужного языка и выберите Set as default.

Меню колонки языка с выбранным пунктом «Установить по умолчанию»

Экспорт и импорт для внешнего перевода

Вы можете экспортировать файл локализации, чтобы передать его переводчикам, и затем импортировать переведённый результат.

На верхней панели инструментов нажмите Import / Export.

import-export.webp

Формат экспортируемого файла

При экспорте создаётся файл .tsv (значения, разделённые табуляцией), где каждая строка соответствует одному переводимому элементу. Столбцы:

СтолбецОписание
ScreenЭкран, которому принадлежит элемент (например, Welcome, Quiz)
ElementАвтоматически сгенерированный идентификатор элемента на этом экране. Его можно изменить в Interactions > Element ID.
PropertyТип свойства (например, content)
[default_locale]Код языка по умолчанию (например, en)
[locale]По одному столбцу на каждую добавленную локаль (например, fr, es)

Пример:

Оставляйте столбцы локалей пустыми для непереведённых строк — Adapty будет считать их отсутствующими.

Требования к файлу импорта

  • Формат: .tsv (значения, разделённые табуляцией)
  • Заголовки: должны содержать столбцы Screen, Element, Property и хотя бы один столбец с локалью
  • Названия столбцов с локалями: должны совпадать с кодами локалей, уже добавленных во флоу. Если файл содержит коды локалей, отсутствующие во флоу, импорт завершится ошибкой.
  • Частичный импорт: можно включить только часть строк — строки, не вошедшие в файл, сохранят текущие значения

Ограничения

  • При экспорте переменные удаляются из строк. Если вы повторно импортируете эти данные, переменные придётся добавить вручную.
  • Экспортируемый файл содержит только строки — для локализации медиафайлов см. Локализация изображений и видео.

Переводите вручную

Вы также можете вводить переводы прямо в любую ячейку таблицы локализации.

Чтобы управлять конкретной строкой, откройте её контекстное меню :

  • Reset to default: Сбрасывает перевод строки до значений языка по умолчанию.

Локализация изображений и видео

Изображения и видео можно локализовать, загружая разные файлы для каждой локали.

  1. Активируйте нужную локаль — под канвасом или в панели локализации.
  2. Выберите элемент с изображением или видео.
  3. Загрузите локализованный файл в панели свойств.

Медиаэлементы без локализованных файлов будут отображать файл локали по умолчанию.

Canvas image changing as the active locale changes

Предварительный просмотр локализации

Чтобы проверить переводы, переключите активную локаль в Flow Builder и просмотрите каждый экран.

Предварительный просмотр локали в Flow Builder