Как локализовать приложение для Android

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

Android берёт локализованный текст из каталогов ресурсов, а код приложения продолжает использовать те же имена ресурсов. Lingo.dev переводит эти ресурсы и сохраняет их в целевых каталогах. Для начала возьмите из файла ресурсов по умолчанию одно приветствие, один список и один ресурс с формами множественного числа. Выведите их на экран приложения, запущенного с другой локалью.

Эта инструкция подходит для нативных XML-ресурсов Android. Для Flutter см. Ресурсы ARB и сгенерированный код локализации, а для каталогов JSON — Локализация React Native.

Подготовьте ресурсы, которые загружает экран #

Храните ресурсы по умолчанию в app/src/main/res/values/strings.xml:

xml
<resources>
  <string name="welcome">Welcome, %1$s!</string>
  <string name="product_name" translatable="false">ExampleApp</string>
  <string-array name="delivery_options">
    <item>Standard delivery</item>
    <item>Express delivery</item>
  </string-array>
  <plurals name="items_count">
    <item quantity="one">%d item</item>
    <item quantity="other">%d items</item>
  </plurals>
</resources>

Подключите эти ресурсы к экрану через уже используемые в приложении вызовы ресурсов. welcome определяет сообщение, а %1$s принимает имя, переданное из кода. Для выбора и форматирования формы множественного числа ресурсу нужно передать количество. translatable="false" исключает название продукта из перевода.

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

Настройте выбор исходных файлов и пути для локалей #

В корне проекта установите CLI и настройте привязку:

sh
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,pt-BR,zh-Hans --files 'app/src/main/res/values/strings.xml' --yes
lingo link

В .lingo/config.json оставьте ИД привязанных организации и движка локализации, затем явно укажите формат файла:

json
{
  "pattern": "app/src/main/res/values/strings.xml",
  "format": "android"
}

Используйте этот объект как запись для файла. Одного расширения .xml недостаточно, чтобы отличить XML-ресурсы Android от другого формата XML. Добавьте записи для других исходных файлов ресурсов, например arrays.xml. Не включайте в них сгенерированные целевые каталоги.

Текущая версия CLI распознаёт каталог values/ без квалификаторов и формирует целевые пути с квалификаторами Android:

Целевая локальЦелевой каталог
esvalues-es
pt-BRvalues-pt-rBR
zh-Hansvalues-b+zh+Hans

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

Переведите и загрузите ресурсы для первой целевой локали #

Чтобы создать недостающие целевые файлы, выполните:

sh
lingo push --backfill-missing --wait

Дождитесь завершения запуска, включая проверку, если она настроена, и изучите полученный XML. Сравните с исходником имена ресурсов, порядок элементов массива, атрибуты количества, неизменяемое название продукта и спецификаторы формата. Если вы не использовали --wait, получите результаты завершённого запуска с помощью lingo pull в том checkout, из которого отправляли запрос.

Соберите приложение с конфигурацией Gradle из проекта, затем запустите его на устройстве или эмуляторе с целевой локалью. Откройте экран, передайте имя и несколько значений количества. Успешная сборка подтверждает корректность синтаксиса ресурсов и ссылок, а проверка на устройстве — что Android действительно выбрал каталог с переводом.

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

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

Сохраните в одном коммите исходники, принятые переводы, конфигурацию привязки и .lingo/lock.json. После редактирования исходных строк переведите изменения:

sh
lingo push --wait

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

sh
lingo push "app/src/main/res/values/strings.xml" --force --wait

Эта команда заменит переводы выбранного файла для всех настроенных целевых локалей. О выборе файлов и повторном создании переводов см. Области действия CLI.

Сохраните сравнение целевых файлов до и после изменений. Помечайте ресурсы Android, которые не нужно переводить, с помощью translatable="false", как в примере с названием продукта выше. Перед обновлением сохраните уже внесённые исправления. Чтобы обнаружить изменения целевых файлов, сделанные после отправки, не используйте --wait и проверьте lingo pull --dry-run перед получением результатов. Подробнее об этой проверке и разрешении конфликтов см. Как сохранить проверенные переводы.

Когда один экран заработает, используйте GitHub App или среду выполнения CI для регулярного перевода. Среда выполнения отвечает за аутентификацию и запись результатов, которые можно проверить. Перед принятием переводов по-прежнему нужно собирать приложение Android и проверять типовые экраны. Переводы, сохранённые в коммитах в другом месте, поступают через систему контроля версий, а lingo pull получает результаты отправки, записанной локально.