Apple stringsdict

Переводите поддерживаемые строки в ресурсах множественного числа, сохраняя управляющие поля plist и структуру выбора форм.

Ресурсы множественного числа Apple содержат и текст для читателя, и инструкции по выбору нужной формы. Обработчик файлов xcode-stringsdict переводит поддерживаемые текстовые поля в plist и сохраняет управляющие значения, которые использует форматтер Apple.

Текстовые поля и управляющие ключи #

Этот фрагмент задаёт сообщение, текст которого зависит от количества:

xml
<plist version="1.0">
<dict>
  <key>items</key>
  <dict>
    <key>NSStringLocalizedFormatKey</key>
    <string>%#@count@</string>
    <key>count</key>
    <dict>
      <key>NSStringFormatSpecTypeKey</key>
      <string>NSStringPluralRuleType</string>
      <key>NSStringFormatValueTypeKey</key>
      <string>d</string>
      <key>one</key><string>%d item</string>
      <key>other</key><string>%d items</string>
    </dict>
  </dict>
</dict>
</plist>

NSStringFormatSpecTypeKey и NSStringFormatValueTypeKey содержат управляющие данные и не переводятся. Другие поддерживаемые значения <string>, в том числе NSStringLocalizedFormatKey, обрабатываются как текстовые поля. При проверке переводов сохраняйте токены форматтера, например %#@count@ и %d, без изменений.

Поля сопоставляются по путям ключей plist внутри словарей и массивов. Пустые элементы <string/> тоже считываются как строковые значения и при записи замены могут разворачиваться в <string>...</string>.

Восстановление структуры и формы множественного числа #

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

Обработчик сохраняет существующую структуру выбора форм множественного числа. Он не создаёт все категории множественного числа для целевого языка и не гарантирует, что формулировки подойдут для любого количества. Тестируйте ресурс с форматтером Apple, который его использует, а не ограничивайтесь проверкой one и other по отдельности.

Как настроить и протестировать ресурсы множественного числа #

CLI определяет xcode-stringsdict по .stringsdict. Режим работы с отдельными ключами недоступен. Выберите файлы через конфигурацию CLI или GitHub.

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