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

Возьмите один изменяемый экран и выпишите его сообщения. Для каждого отметьте старый клиент, новый клиент и версию каталога. На стенде воспроизведите сочетание старого приложения с новым переводом до выпуска. В примерах используйте искусственные имена и суммы; реальные данные пользователей для такой проверки не нужны.

Ключ живёт дольше текста кнопки

Документация i18next описывает namespaces — отдельные группы ресурсов перевода, например по разделам приложения. Источник проверен 12 октября 2026 года. Это удобная организация каталога, но она сама по себе не обеспечивает совместимость мобильных версий. Ниже предложена схема выпуска; это рекомендация, а не обязательный протокол библиотеки.

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

Условный контракт сообщения:
namespace: checkout
key: delivery_summary
params: city, deliveryDate
consumers: web-current, mobile-supported
meaning: итог выбранной доставки
revision: <версия каталога>

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

Четыре сочетания вместо одного красивого экрана

КлиентКаталогВопрос приёмки
СтарыйСтарыйСохранилась ли базовая работа
СтарыйНовыйОстались ли старые ключи и параметры
НовыйСтарыйЕсть ли согласованный резерв при задержке
НовыйНовыйПравилен ли новый сценарий

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

Условный пример: сайт уже использует новый текст статуса заказа, а поддерживаемое приложение распознаёт прежний код статуса. Нужен совместимый вывод для этого кода или отдельный контракт нового клиента. Добавление новой подписи не должно тайно менять бизнес-значение, которое приложение использует для выбора следующего действия.

Снятие старого ключа откладываем до проверки потребителей

  1. Добавить новый ключ и перевод, сохранив действующий старый.
  2. Выпустить клиенты с новым контрактом.
  3. Сверить оставшиеся поддерживаемые версии и их ресурсы.
  4. Удалять устаревший ключ только по согласованной политике поддержки.

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

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

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

Проверенные источники