Как локализовать приложение для Android
Переведите ресурсы Android, разместите их в каталогах нужных локалей и проверьте сообщения в приложении.
Android берёт локализованный текст из каталогов ресурсов, а код приложения продолжает использовать те же имена ресурсов. Lingo.dev переводит эти ресурсы и сохраняет их в целевых каталогах. Для начала возьмите из файла ресурсов по умолчанию одно приветствие, один список и один ресурс с формами множественного числа. Выведите их на экран приложения, запущенного с другой локалью.
Эта инструкция подходит для нативных XML-ресурсов Android. Для Flutter см. Ресурсы ARB и сгенерированный код локализации, а для каталогов JSON — Локализация React Native.
Подготовьте ресурсы, которые загружает экран #
Храните ресурсы по умолчанию в app/src/main/res/values/strings.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 и настройте привязку:
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 оставьте ИД привязанных организации и движка локализации, затем явно укажите формат файла:
{
"pattern": "app/src/main/res/values/strings.xml",
"format": "android"
}Используйте этот объект как запись для файла. Одного расширения .xml недостаточно, чтобы отличить XML-ресурсы Android от другого формата XML. Добавьте записи для других исходных файлов ресурсов, например arrays.xml. Не включайте в них сгенерированные целевые каталоги.
Текущая версия CLI распознаёт каталог values/ без квалификаторов и формирует целевые пути с квалификаторами Android:
| Целевая локаль | Целевой каталог |
|---|---|
es | values-es |
pt-BR | values-pt-rBR |
zh-Hans | values-b+zh+Hans |
При такой структуре символическая ссылка values-en не нужна. Если она использовалась в старой конфигурации, обновите и проверьте конфигурацию, прежде чем удалять ссылку. В имени каталога вида values-pt-BR нет ожидаемого регионального квалификатора. О том, как явно задать целевые пути и записать локали, см. Конфигурация CLI.
Переведите и загрузите ресурсы для первой целевой локали #
Чтобы создать недостающие целевые файлы, выполните:
lingo push --backfill-missing --waitДождитесь завершения запуска, включая проверку, если она настроена, и изучите полученный XML. Сравните с исходником имена ресурсов, порядок элементов массива, атрибуты количества, неизменяемое название продукта и спецификаторы формата. Если вы не использовали --wait, получите результаты завершённого запуска с помощью lingo pull в том checkout, из которого отправляли запрос.
Соберите приложение с конфигурацией Gradle из проекта, затем запустите его на устройстве или эмуляторе с целевой локалью. Откройте экран, передайте имя и несколько значений количества. Успешная сборка подтверждает корректность синтаксиса ресурсов и ссылок, а проверка на устройстве — что Android действительно выбрал каталог с переводом.
Проверьте текст для значений количества, которые охватывают категории множественного числа целевого языка. Обработчик сохраняет исходную структуру форм множественного числа, поэтому английские one и other не обеспечивают полный набор форм целевого языка. Проверьте длинные подписи, текст для специальных возможностей и, где нужно, вёрстку справа налево. lingo check не заменяет проверку ресурсов Android и полноты перевода.
Продолжайте переводить изменения в исходниках #
Сохраните в одном коммите исходники, принятые переводы, конфигурацию привязки и .lingo/lock.json. После редактирования исходных строк переведите изменения:
lingo push --waitЧтобы заново создать все переводы одного исходного файла после изменения инструкций движка, сохраните принятые переводы и выполните:
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 получает результаты отправки, записанной локально.