Строки Apple
Переводите значения в таблицах строк Apple, сохраняя ключи поиска и экранируя текст при записи.
Таблица строк Apple связывает фиксированные ключи поиска с текстом, который видят пользователи. Обработчик файлов xcode-strings переводит значения справа, сохраняет ключи и записывает экранированные строковые литералы обратно в отдельный файл .strings для каждой локали.
Ключи и значения #
Например:
/* Checkout heading */
"checkout.title" = "Complete your order";
"delivery.estimate" = "Delivery within %d days";Два значения справа — это единицы текста для перевода. checkout.title и delivery.estimate остаются ключами поиска. Комментарии сохраняются вместе с записями, но обработчик не превращает их в подсказки для перевода. Если короткая надпись неоднозначна, используйте способы передачи контекста, которые поддерживает рабочий процесс перевода.
Ключи и значения в кавычках, знаки присваивания и точки с запятой — часть поддерживаемого синтаксиса таблицы строк. Парсер декодирует поддерживаемые последовательности экранирования. При записи экранируются кавычки, обратные косые черты, переводы строк, символы табуляции и возврата каретки. При замене значений сохраняются окружающие комментарии и интервалы между записями.
Слияние и размещение ресурсов #
Предыдущая версия исходного файла позволяет определить по ключам, какие значения изменились, а существующий целевой файл — сохранить готовые переводы. Текущая версия исходного файла задаёт набор записей и комментарии. Для изменённых сообщений используйте обычное обновление исходного файла. После изменения рекомендаций по переводу вы можете намеренно обновить весь файл. См. Области действия CLI.
Размещайте ресурсы локалей там, откуда приложение их загружает, например en.lproj/Localizable.strings и de.lproj/Localizable.strings. Для исходного файла в Base.lproj путь определяется иначе, чем для файла в каталоге с именем локали. Проверьте путь назначения с помощью выбранного инструмента. Перевод таблицы не настраивает язык разработки приложения и не определяет, в какие целевые сборки входят ресурсы.
Как настроить и загрузить таблицу строк #
CLI определяет xcode-strings по .strings. Правила выбора и формирования путей описаны в разделе Конфигурация CLI, а управляемая запись результатов в репозиторий — в разделе GitHub.
Загрузите целевую таблицу в приложении и проверьте спецификаторы формата с реальными значениями. Для ресурсов с выбором формы множественного числа используйте stringsdict. Если в проекте используются каталоги строк, следуйте правилам слияния для общих файлов: если переименовать каталоги, создав по одному для каждой локали, структура ресурсов изменится.