Управление переводами

Обновления по беспроводной сети (Strings)

Контент автоматически переведен с английского языка с помощью Phrase Language AI.

Обновления по беспроводной сети (OTA) — гибкий способ обновлять переводы в мобильных и веб-приложениях без выпуска новой версии в App Store, Google Play или на других платформах распространения. Этот подход поддерживает непрерывную локализацию и гибкие процессы разработки, сокращая задержки и объем ручной работы.

Функция OTA в Phrase Strings интегрируется с платформами iOS, Android, React Native, Flutter, i18next и Rails. Обновления текстовых меток мгновенно отправляются в мобильные приложения.

Схема взаимодействия OTA с устройством пользователя

Для применения обновленных настроек необходимо создать новый релиз. Весь контент, включенный в релиз, должен быть доступен в Phrase Strings, которая передает переводы непосредственно в приложение. Если контент отсутствует, переводы не будут доставлены.

Для работы OTA в мобильных приложениях необходимо интегрировать в приложение соответствующий комплект разработки программного обеспечения (SDK), чтобы получать переводы из Phrase Strings во время выполнения.

Рекомендации

Подробную информацию о распространении, релизах и справочных материалах по API см. в Центре разработчиков.

При первом запуске приложения, использующего SDK для iOS, Android, React Native или Flutter, на устройстве создается уникальный случайный идентификатор устройства. Этот идентификатор используется для подсчёта активных пользователей за определённый период. Он не используется для отслеживания в других целях и не содержит сведений о пользователе или устройстве.

Количество OTA-запросов и число ежемесячных активных пользователей (MAU) ограничены в зависимости от выбранного тарифного плана.

MAU — это количество уникальных устройств, с которых запрашиваются переводы. Каждому устройству присваивается случайный ID. MAU рассчитывается на основе количества уникальных ID, присвоенных за последние 30 дней. Любое взаимодействие с серверами Phrase считается запросом.

Данные, отправляемые с OTA-запросами

SDK взаимодействует со службой OTA для проверки обновлений и передает в каждом запросе следующие сведения:

  • Идентификатор устройства (например, "F3AFCB10-80A2-84CB-94C0-27F5EF58876D"). уникальный для этого приложения и потому не позволяющий отслеживать конкретное устройство)

  • Версия приложения (например, «1.2.0»)

  • Последнее обновление файла перевода (например, "1542187679")

  • Версия SDK (например, «1.0.0»)

  • Локаль (например, «de-DE»)

  • Формат файла (например, «strings»)

  • Клиент (например, «ios»)

  • конфигурации распространения ID (идентификатор конфигурации распространения)

  • Секретный ключ среды (для разграничения среды разработки и рабочей среды)

Домены, используемые SDK:

Центр обработки данных в ЕС

  • ota.eu.phrase.com

  • cdn.eu.phrase.com

  • ota.phraseapp.com

  • cdn.phraseapp.com

Центр обработки данных в США

  • ota.us.phrase.com

  • cdn.us.phrase.com

SDK Phrase OTA разработаны таким образом, чтобы приложения оставались функциональными, даже если API OTA недоступен. В таких случаях SDK переключается на последние успешно полученные переводы, сохраненные на устройстве, или на встроенные переводы, включенные в пакет приложения. Это помогает избежать ошибок и отсутствующих строк в приложении у конечных пользователей. Чтобы резервные переводы были актуальными, обновляйте встроенные переводы при каждом выпуске приложения.

Конфигурации распространения OTA-обновлений

Конфигурации распространения определяют, как и куда доставляются OTA-обновления для конкретной платформы или проекта.

Целевые платформы задаются в конфигурации распространения:

  • iOS

  • Android

  • Флаттер

  • i18next

  • Rails

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

Разрешения

Права на управление конфигурациями распространения OTA-обновлений и релизами зависят от того, к каким проектам назначен пользователь. Пользователи управляют ими только в тех проектах, к которым они прикреплены.

Роли «Владелец», «Администратор», «Менеджер проекта», «Разработчик» и «Дизайнер» по умолчанию имеют полный доступ к конфигурациям распространения OTA-обновлений и релизам. Роль «Переводчик» не имеет доступа.

Владельцы и администраторы имеют доступ ко всем проектам.

Перед созданием конфигурации распространения пользователям необходимо получить разрешение на управление такими конфигурациями на уровне учётной записи. Новая конфигурация распространения привязывается только к тем проектам, к которым у пользователя есть доступ.

Для более детального контроля корпоративные клиенты могут связаться со службой поддержки по поводу создания пользовательской роли.

Резервные языки

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

Если используется специфический для страны язык (например, en-GB), но он не является частью релиза, система может использовать стандартную версию (например, en) этого языка, если она существует в проекте. Если запрашиваемый язык не найден, вместо него может быть использована локаль проекта по умолчанию.

Резервные языки не будут работать для связанных ключей.

Настройка проекта Использовать резервный язык для непроверенных переводов применяется при создании файла релиза. Это не зависит от параметра Использовать резервный язык на вкладке Резервные языки.

Параметр Использовать резервный язык в конфигурации распространения применяется, когда устройство запрашивает релиз. Это касается только отсутствующих или непереведенных ключей, а не непроверенных переводов.

Создание конфигурации распространения

Чтобы создать конфигурацию распространения, выполните следующие действия:

  1. В блоке Обновления по беспроводной сети (OTA) на странице Интеграции нажмите Настроить или число конфигураций, если они уже созданы.

    Откроется страница Обновления по беспроводной сети, на которой отображаются существующие конфигурации.

  2. Нажмите Новая конфигурация распространения. Откроется окно Добавить конфигурацию распространения.

  3. На вкладке Общие укажите Название, Проект, с которым связана конфигурация распространения, необходимые Языки и Платформы.

    • Для конфигураций распространения Android перейдите на вкладку Android, чтобы при необходимости выбрать параметр формата, заключающий любой перевод, в том числе содержащий HTML-теги, в CDATA.

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

  4. На вкладке Резервные языки при необходимости настройте резервные языки для этой конфигурации распространения. Приоритет параметров резервных языков соответствует порядку их отображения в списке.

  5. При необходимости перейдите на вкладку Переводы, чтобы выбрать параметр использования последней проверенной версии переводов. Включайте этот параметр только при работе с расширенным процессом проверки.

  6. Нажмите Сохранить.

    Отобразятся сведения о конфигурации распространения и идентификаторы, необходимые для работы SDK. Чтобы снова просмотреть эти сведения, выберите конфигурацию распространения на странице Обновления по беспроводной сети.

OTA-релизы

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

Чтобы создать релиз, выполните следующие действия:

  1. На странице «Обновления по беспроводной сети» нажмите Добавить релиз рядом с нужной конфигурацией распространения.

    Откроется окно Новый релиз.

  2. Укажите Описание, требуемую Платформу, Ветку, Локали и Версии приложения.

    Локали, которые еще не добавлены в список языков дистрибутива, отображаются невыбранными и недоступными для выбора. Добавьте необходимые языки в дистрибутив, чтобы сделать их доступными для выбора в будущих релизах.

    Если при создании релиза локали не выбраны вручную, все локали, настроенные в дистрибутиве, включаются в релиз по умолчанию.

    При необходимости введите теги, чтобы включить в релиз только ключи с определенными тегами. Добавление фильтра тегов к релизу включает только те ключи, которые содержат этот тег. Ключи без этого тега полностью исключаются из релиза, и подключенное приложение для таких ключей использует статические файлы переводов, встроенные локально в его кодовую базу. Фильтрация по тегам и ветвление работают независимо друг от друга: если ветвление включено, выберите ветку и нужные теги; если нет — только нужные теги.

  3. Нажмите Сохранить.

    Релиз добавляется в список в нижней части страницы сведений о дистрибутиве.

Планирование OTA-релизов

Чтобы настроить регулярное расписание для выпуска дистрибутива, выполните следующие действия:

  1. На странице «Over the air» нажмите значок шестерёнки «Изменить» рядом с нужным дистрибутивом.

    Отображается окно «Редактирование дистрибутива».

  2. Выберите вкладку «Запланировать релиз» и нажмите «Включить планирование».

    Отобразятся параметры планирования релиза.

    Примечание

    Параметры планирования также доступны при создании нового дистрибутива.

  3. В раскрывающемся списке «Создавать релизы каждые» выберите один из доступных вариантов частоты выпуска релизов:

    • День

    • Неделя

      Выберите нужные дни недели для запланированных релизов.

  4. Укажите время и соответствующий часовой пояс в поле «Часовой пояс».

  5. При необходимости выберите ветку, теги и языки в полях «Ветка», «Теги» и «Языки» для запланированных релизов.

    • Поле «Ветка» отображается только в том случае, если в проекте включено ветвление. Выбор ветки обновляет список локалей и языков.

  6. При необходимости укажите версии приложения в полях «Мин. версия» и «Макс. версия».

    Оставьте поля пустыми, чтобы запланированные релизы распространялись на все версии приложения.

  7. Нажмите «Сохранить».

    Настройки дистрибутива обновляются с учётом расписания выпуска релизов.

Отключение расписания останавливает автоматический выпуск дистрибутива, но настроенные параметры сохраняются.

Примечание

Из-за постоянных доработок пользовательский интерфейс может быть не совсем таким, как представлено в видео.

Примечание

В пользовательском интерфейсе Strings нет возможности приостановить или временно отключить OTA. Чтобы приложение перестало получать переводы, удалите идентификатор дистрибутива из конфигурации OTA приложения; чтобы возобновить получение переводов по OTA, верните идентификатор. В крайнем случае удалите дистрибутив и создайте новый.

Отчёты мобильного SDK и веб-библиотеки для OTA

Интеграция соответствующего мобильного SDK или веб-библиотеки позволяет обновлять переводы одним щелчком мыши и получать метрики использования. Отчёты мобильного SDK и веб-библиотеки содержат полезную информацию об активных пользователях приложения и используемых ими языках. Этот набор отчетов доступен для каждого дистрибутива, а данные обновляются дважды в день.

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

Отчёты по каждому дистрибутиву можно открыть с помощью значка «Открыть отчёты» на странице «Over the air».

Количество активных пользователей, указанное в этих отчетах, рассчитывается за скользящий 30-дневный период, отсчитываемый от текущей даты, а не за фиксированный календарный или расчетный период.

Интеграция OTA SDK

Техническая документация по интеграции OTA SDK доступна в файле README каждого репозитория проекта:

Была ли эта статья полезной?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.