Apple stringsdict
Переводите поддерживаемые строки в ресурсах множественного числа, сохраняя управляющие поля plist и структуру выбора форм.
Ресурсы множественного числа Apple содержат и текст для читателя, и инструкции по выбору нужной формы. Обработчик файлов xcode-stringsdict переводит поддерживаемые текстовые поля в plist и сохраняет управляющие значения, которые использует форматтер Apple.
Текстовые поля и управляющие ключи #
Этот фрагмент задаёт сообщение, текст которого зависит от количества:
<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 и загрузите его в приложении, используя значения количества, при которых выбираются разные формы. Каталоги строк устроены иначе: несколько локалей хранятся в одном общем файле.