Обновление по воздуху (OTA) предлагают гибкий способ Сдать обновления переводов для мобильных и веб-приложений без необходимости выпуска новой версии в App Store, Google Play или на других платформах развертывания. Этот подход поддерживает непрерывная локализация и гибкие рабочие процессы разработки за счет сокращения задержек и ручных процессов.
Функция обновление по воздуху (OTA) в Phrase Strings интегрируется с платформами iOS, Android, React Native, Flutter, i18next и Rails. Обновления для текстовых меток мгновенно отправляются в мобильные приложения.
Необходимо создать новый выпуск, чтобы применить обновленные настройки. Весь контент, включенный в выпуск, должен быть доступен в Phrase Strings, который передает переводы напрямую в приложение. Если контент отсутствует, переводы не будут Сдать.
Для мобильные приложения обновление по воздуху (OTA) требует интеграции соответствующего комплекта для разработки программного обеспечения (SDK) в приложение для получения переводов из Phrase Strings во время выполнения.
При первом запуске приложения, использующего SDK для iOS, Android, React Native или Flutter на устройстве, создается уникальный случайный идентификатор устройства. Этот Идентификатор отслеживает активных пользователей за определенный период времени. Он не используется для каких-либо иных форм или средств отслеживания и не содержит никакой информации о пользователе или устройстве.
Количество запросов обновление по воздуху (OTA) и количество активных пользователей в месяц (MAU) ограничены в зависимости от выбранного тарифного плана.
MAU — это количество уникальных устройств, с которых запрашиваются переводы. Каждому устройству присваивается случайный Идентификатор. MAU рассчитывается на основе количества уникальных Идентификаторов, назначенных за последние 30 дней. Каждое взаимодействие с серверами Phrase считается запросом.
Данные, отправляемые с запросами обновление по воздуху (OTA)
SDK связывается с услугой обновление по воздуху (OTA), чтобы проверить наличие обновлений, и включает следующие сведения в каждый запрос:
-
Идентификатор устройства (например, "F3AFCB10-80A2-84CB-94C0-27F5EF58876D". Уникален для этого приложения и поэтому не позволяет отслеживать конкретное устройство.)
-
Версия приложения (например, "1.2.0")
-
Последнее обновить файла перевода (например, "1542187679")
-
Версия SDK (например, "1.0.0")
-
Языковой стандарт (например, "de-DE")
-
Формат файла (например, "Strings")
-
Клиент (например, "ios")
-
Распределение Идентификатор (Идентификатор распределения)
-
Секрет среды (для различения разработки и производства)
Домены, используемые 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 переключается на последние успешно полученные переводы, сохраненные на устройстве, или на встроенные переводы, включенные в пакет приложения. Это предотвращает ошибки или отсутствие Strings для конечных пользователей. Чтобы гарантировать надежный резервный вариант, встроенные переводы следует обновлять при каждом выпуске приложения.
Распределения — это настроенная настройка, которая определяет, как и где обновления обновление по воздуху (OTA) доставляются для конкретной платформы или проект.
Целевые платформы определяются в рамках распределения:
-
iOS
-
Android
-
Флаттер
-
i18next
-
Rails
Возможно создание нескольких дистрибутивов, но в идеале на один проект должен приходиться один дистрибутив. При использовании одного дистрибутива для iOS и Android заполнители для двух формат автоматически преобразуются.
Резервные языки
Если в настройки язык проект, к которому подключен дистрибутив, заданы резервные языки, то при запросе существующего язык, для которого ключ не переведен, будут отображаться Strings из выбранного язык.
Если используется специфический для страны язык (например, en-GB), но он не является частью выпуска, система может использовать стандартную версию (например, en) этого язык, если она существует в проект. Если запрошенный язык не найден, вместо него может быть предоставлен языковой стандарт по умолчанию для проект.
Резервные языки не будут работать с linked keys.
Создать дистрибутив
Чтобы Создать дистрибутив, выполните следующие действия:
-
В поле на странице нажмите Configure или количество конфигураций, если они уже существуют.
Откроется страница , на которой отображаются существующие конфигурации.
-
Нажмите New distribution. Откроется окно .
-
На вкладке General укажите , с каким связан дистрибутив, необходимые и необходимые .
-
Для дистрибутивов Android перейдите на вкладку Android, чтобы Выбрать формат, который при необходимости заключает любые переводы, включая HTML-теги, в CDATA.
-
После выбора проект, с которым будет связан дистрибутив, станет доступна вкладка Scheduling. При необходимости используйте эту вкладка, чтобы настроить обновление по воздуху (OTA) запланированные выпуски в дистрибутиве.
-
-
На вкладке Fallback languages Выбрать настройки языкового стандарта для конкретного дистрибутива по мере необходимости. Параметры языкового стандарта имеют приоритет в том порядке, в котором они отображаются в список.
-
При желании перейдите на вкладка Translations, чтобы Выбрать опцию использовать последнюю проверено версию переводов. Включить эту опцию только при работе с расширенным рабочим процессом проверки.
-
Нажмите «Сохранить».
Сведения о распространении отображаются с идентификаторами, требуемыми SDK. Сведения можно просмотреть снова, нажав на дистрибутив на странице .
Чтобы обновить переводы, создайте новый выпуск в рамках дистрибутива. Текущее состояние проекта экспортируется и становится доступным для подключенных клиентов.
Чтобы создать выпуск, выполните следующие действия:
-
На странице обновление по воздуху нажмите Добавить выпуск рядом с нужным дистрибутивом.
Откроется окно .
-
Укажите , требуемую , , и .
При необходимости введите теги, чтобы включить в выпуск только ключи с определенными тегами.
-
Нажмите «Сохранить».
Выпуск добавляется в список в нижней части страницы сведений о распространении.
Чтобы настроить повторяющееся расписание для выпуска дистрибутива, выполните следующие действия:
-
На странице нажмите на значок шестеренки
рядом с нужным дистрибутивом.
Отобразится окно .
-
Выбрать вкладку Запланировать выпуск и нажать .
Отобразятся параметры планирования выпуска.
Примечание
Параметры планирования также доступны при создании нового дистрибутива.
-
В раскрывающемся списке выберите частоту выпуска, выбрав один из доступных вариантов:
-
-
Выбрать желаемые дни недели для запланированных релизов.
-
-
Укажите время и соответствующий .
-
При необходимости выберите , и для запланированных релизов.
-
Поле отображается только в том случае, если в проект включено ветвление. Выбор ветвь обновляет список локалей и языков.
-
-
При необходимости укажите версии приложения в полях и .
Оставьте пустым, чтобы применить запланированный релиз ко всем версиям приложения.
-
Нажмите «Сохранить».
Дистрибутив обновляется информацией о планировании релизов.
Отключение расписания останавливает автоматический релиз дистрибутива, но настроенные настройки сохраняются.
Интеграция соответствующего мобильного SDK или веб-библиотеки позволяет обновлять переводы одним нажатием, а также предоставляет метрики для измерения использования. Отчеты по мобильному SDK и веб-библиотеке дают ценную информацию об активных пользователях приложения и используемых ими языках. Этот набор отчетов доступен для каждого дистрибутива, данные обновляются дважды в день.
Предоставляются отчеты по количеству активных пользователей, общим запросам, запросам по языкам, запросам по платформам и по не предоставленным языкам устройств.
Отчеты для каждого дистрибутива доступны через значок на странице .
Техническая документация по интеграции SDK обновление по воздуху (OTA) доступна в файле README каждого хранилища проекта: