Ресурсы Android

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

Android связывает текст на экране с кодом приложения по именам ресурсов. Обработчик файлов android сохраняет эти имена и переводит поддерживаемые строки, элементы строковых массивов и формы множественного числа внутри корневого элемента <resources>. Атрибуты количества и позиции в массивах по-прежнему определяют, какие значения загружает Android.

Выбор ресурсов #

В одном файле ресурсов могут быть и переводимый текст, и неизменяемое название продукта:

xml
<resources>
  <string name="checkout_title">Complete your order</string>
  <string name="brand" translatable="false">Acme</string>
  <string-array name="delivery_methods">
    <item>Standard delivery</item>
    <item>Express delivery</item>
  </string-array>
  <plurals name="items">
    <item quantity="one">%d item</item>
    <item quantity="other">%d items</item>
  </plurals>
</resources>

Имена ресурсов, позиции в массивах и категории множественного числа определяют, какие значения нужно переводить. brand пропускается, так как у него есть translatable="false". Позиция входит в идентификатор элемента массива, поэтому при изменении порядка меняется и сопоставление текста с существующим переводом. Текущая версия CLI не поддерживает выбор --key для Android. Вместо этого выбирайте исходные файлы целиком.

Обработчик считывает текст из каждого элемента и пропускает элементы с дочерними элементами, такими как <b> или <xliff:g>. Для таких ресурсов с разметкой предоставляйте проверенные переводы отдельно. После обработки всего файла проверьте, все ли они переведены. Текст по обе стороны от встроенного XML-комментария объединяется для перевода. При замене значения этот комментарий может быть удалён. Его текст не используется как подсказка для перевода.

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

Расположение файлов локалей #

Обычно исходный файл находится в res/values/strings.xml, а перевод на немецкий — в res/values-de/strings.xml. Квалификаторы региона и письменности должны соответствовать правилам Android: например, values-pt-rBR или values-b+zh+Hans. Произвольная строка локали после values- не подойдёт.

CLI умеет определять пути для каталога values без суффикса, если формат Android указан явно. Для этой поддерживаемой структуры не нужна дополнительная символическая ссылка values-en. Обозначение локали Android, которое подразумевает формат, и любой явно заданный путь к переводу указываются в конфигурации CLI. Проверьте полученный путь, прежде чем принимать результат.

Повторное использование и частичный результат #

Предыдущий исходный текст сравнивается по идентификаторам ресурсов. При восстановлении файла соответствующие значения берутся из существующего перевода. Для изменений в исходном тексте используйте обычный lingo push --wait. Перед принудительным обновлением всего файла сохраните принятые переводы. Неизменяемый текст храните в ресурсах с пометкой translatable="false". lockedKeys в CLI не управляют ресурсами Android.

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

Как настроить и проверить ресурсы Android #

Для исходных файлов .xml в CLI явно задайте format: "android". Сам по себе XML не позволяет определить, что файл использует структуру ресурсов Android. GitHub App также принимает тип, указанный в конфигурации.

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