Каталоги строк Apple

Обновляйте значения на целевом языке в каталоге XCStrings, сохраняя исходный язык и другие локали.

Каталог .xcstrings хранит исходный текст вместе с переводами. Обработчик файлов xcode-xcstrings заполняет записи на целевом языке, сохраняя другие локали в том же файле. Результат — обновлённый каталог по исходному пути, а не отдельный файл для каждого языка.

Исходные значения и варианты #

Запись с явно заданным исходным значением на английском выглядит так:

json
{
  "sourceLanguage": "en",
  "strings": {
    "checkout.title": {
      "localizations": {
        "en": {
          "stringUnit": {
            "state": "translated",
            "value": "Complete your order"
          }
        }
      }
    }
  },
  "version": "1.0"
}

stringUnit.value на исходном языке задаёт текст. Поддерживаемые варианты форм множественного числа или устройств задают отдельные конечные значения, каждое со своим идентификатором варианта. Если у записи нет локализации на исходном языке, исходным текстом становится её ключ. Это удобно, когда ключ содержит сам текст, но технический ключ вроде checkout.title не заменит нужное сообщение на английском.

Запись с shouldTranslate: false пропускается. Комментарии каталога могут оставаться в общей структуре, но подсказки обработчика указывают формат и вариант. Это не означает, что каждый комментарий используется как рекомендация для перевода.

Полнота переводов проверяется для каждой локали #

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

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

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

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

Как настроить вывод в общий файл #

CLI определяет xcode-xcstrings по .xcstrings и записывает результат по исходному пути. Для этого типа файлов конфигурация не допускает отдельного targetPath. Следуйте краткому руководству по работе с файлами через CLI до шага получения результата или используйте GitHub для управляемого перевода репозитория.

Как исправить существующий перевод #

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

Удалите только ту целевую запись, которую хотите сгенерировать заново. В примере выше для перевода на немецкий это strings["checkout.title"].localizations.de. Оставьте en, другие локали и соседние записи без изменений. Сохраните файл, затем выполните обычный инкрементальный push:

sh
lingo push --wait

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

Следуйте этой инструкции с сохранённой базовой версией и обычным push. Позиционные шаблоны, --backfill-missing и --key выбирают другой набор задач, а purge пропускает общий файл.

Как проверить все изменения в каталоге #

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

Проверки каталога в CLI не подтверждают полноту локалей XCStrings. Используйте Xcode и проверки в приложении, чтобы проверить включение ресурсов, язык разработки, работу с несколькими каталогами, плейсхолдеры и отображаемые варианты. Этот рабочий процесс описан в руководстве Как локализовать приложение для iOS. Устаревшие форматы strings и stringsdict по-прежнему работают с отдельными файлами для каждой локали.