Как локализовать интерфейс с помощью Редактора переводов

В редакторе переводов можно просматривать и редактировать все строковые ресурсы, как стандартные, так и переведенные.

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

Редактор переводов с текстом приложения до перевода.
Рисунок 1. Редактор переводов с текстом приложения до перевода

Строковые ресурсы

Строковые ресурсы проекта содержатся в файлах strings.xml. В вашем проекте есть файл strings.xml по умолчанию, который содержит строковые ресурсы на языке по умолчанию для вашего приложения, то есть на языке, на котором, как вы ожидаете, говорит большинство пользователей вашего приложения. Вы также можете создать переведенные файлы strings.xml, содержащие строковые ресурсы для других языков, которые должно поддерживать ваше приложение.

После того как вы создадите файл strings.xml по умолчанию, вы можете добавить переводы самостоятельно или воспользоваться услугами профессионального переводчика. В любом случае вы можете использовать функции Android Studio, которые помогают управлять локализуемым текстом и тестировать его. Подробнее о профессиональных услугах перевода…

Как открыть Редактор переводов

Открыть редактор переводов в Android Studio можно несколькими способами.

Как открыть приложение из режима Android

  1. На панели Project (Проект) > Android слева выберите ModuleName > res > values.
  2. Нажмите правой кнопкой мыши на файл strings.xml и выберите Open Translations Editor (Открыть редактор переводов).

    В редакторе переводов появятся пары "ключ-значение" из файла strings.xml.

На рисунке 1 показан текст приложения на языке по умолчанию (в данном случае на английском) в редакторе переводов до начала работы над переводом. Содержимое переведенных файлов strings.xml появится справа от столбца Untranslatable (Непереводимые). Каждому языку будет соответствовать отдельный столбец, как показано на рисунке 2.

Откройте файл strings.xml.

Открыть редактор переводов можно из любого файла strings.xml.

  1. На панели Project (Проект) > Android слева выберите ModuleName > res > values.
  2. Нажмите дважды на файл strings.xml, чтобы открыть его для редактирования.
  3. В файле strings.xml нажмите на ссылку Open editor (Открыть редактор) в правом верхнем углу.

Настроить непереводимые строки

В редакторе переводов можно выбрать Не переводить, чтобы указать, что текст в этой строке не нужно переводить. К тексту, который не нужно переводить, могут относиться названия товаров, торговые наименования и товарные знаки, а также технические термины, у которых нет перевода.

Если вы выберете Untranslatable (Не переводить), в соответствующую строку файла strings.xml по умолчанию будет добавлен атрибут translatable="false". В примере ниже EasyApp в верхней строке не переводится, потому что это название продукта.

<resources>
    <string name="app_name" translatable="false">EasyApp</string>
    <string name="action_settings">Settings</string>
    <string name="easy_app">I am a Simple App!</string>
    <string name="next_page">Next Page</string>
    <string name="second_page_message">I am the Second Page!</string>
    <string name="title_activity_second">SecondActivity</string>
</resources>

Как добавлять и удалять языки

Редактор переводов поддерживает стандарт BCP 47 и объединяет коды языка и региона (страны) в единый параметр для целевых локализаций. Региональные настройки определяют не только язык. Региональные настройки включают зависящее от страны форматирование для таких вещей, как дата и время, валюты и десятичные дроби.

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

  1. В Редакторе переводов нажмите на значок глобуса .
  2. В раскрывающемся списке выберите язык, который хотите добавить.

    Новый язык появится в редакторе переводов, а в проект будет добавлена папка values-* с файлом strings.xml. Например, values-es для испанского языка.

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

Удалить язык в редакторе переводов можно, удалив все значения в столбце (см. раздел Как редактировать, добавлять и удалять текст) или удалив папку проекта для этого языка, как описано ниже.

  1. На панели Project (Проект) > Android слева выберите ModuleName > res.
  2. Нажмите правой кнопкой мыши на папку values-* для языка, который хотите удалить. Например, values-hi для хинди.
  3. В списке выберите Delete (Удалить), чтобы удалить папку и файл strings.xml.

Как редактировать, добавлять и удалять текст

Вы можете изменять настройки текста непосредственно в файле strings.xml или в редакторе переводов. В этом разделе описывается подход с использованием редактора переводов. В редакторе переводов можно добавлять, изменять и удалять текст в списке или в поле Перевод в нижней части окна.

В верхней части экрана находится список, а в нижней – поле перевода.
Рисунок 2. Вверху находится список, а внизу – поле Перевод.

Список

Чтобы добавить или изменить текст, выполните следующие действия:

  1. Дважды нажмите на ячейку, в которой нужно изменить или добавить текст.
  2. Скопируйте и вставьте текст с помощью клавиатуры или, если ваша клавиатура поддерживает диакритические знаки, введите текст непосредственно в списке.
  3. Нажмите клавишу Tab или переместите курсор за пределы поля.

Чтобы удалить текст, выполните следующие действия:

  1. Нажмите дважды на ячейку, которую нужно удалить.
  2. В режиме просмотра списка выберите текст и нажмите Удалить.
  3. Нажмите клавишу Tab или переместите курсор за пределы поля.

Поле перевода

Чтобы добавить или изменить текст, выполните следующие действия:

  1. В режиме списка нажмите на ячейку, в которой нужно изменить или добавить текст.
  2. В поле Перевод вставьте скопированный текст или введите его, если ваша клавиатура поддерживает диакритические знаки.
  3. Нажмите клавишу Tab или переместите курсор за пределы поля.

Чтобы удалить текст, выполните следующие действия:

  1. Нажмите на ячейку, которую нужно удалить.
  2. В поле Перевод выделите текст и нажмите Удалить.

Как добавлять и удалять ключи

В столбце Ключ указаны уникальные идентификаторы для каждого элемента данных в файлах strings.xml. Вы можете добавлять и удалять ключи в редакторе переводов. При удалении ключа в Редакторе переводов удаляется сам ключ и все связанные с ним переводы. Редактор переводов использует рефакторинг Safe Delete для удаления ключа, чтобы вы знали, используется ли текст ключа в другом месте, и могли внести необходимые корректировки перед удалением ключа. Рефакторинг Safe Delete гарантирует, что ваш код будет компилироваться после удаления ключа.

Чтобы добавить ключ, выполните следующие действия:

  1. В редакторе переводов нажмите Добавить ключ .
  2. В диалоговом окне введите название ключа, значение по умолчанию и местоположение файла strings.xml по умолчанию.

    Диалоговое окно добавления ключа в Редакторе переводов.
    Рисунок 3. Добавить ключ

Чтобы удалить ключ, выполните следующие действия:

  1. В редакторе переводов выберите ключ, который нужно удалить.
  2. Нажмите Удалить ключи.
  3. В диалоговом окне Delete (Удалить) выберите, хотите ли вы выполнить безопасное удаление и нужно ли искать в комментариях и строках, а затем нажмите OK.

    Диалоговое окно удаления ключа в редакторе переводов.
    Рисунок 4. Диалоговое окно удаления

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

    Диалоговое окно &quot;Обнаружены случаи использования&quot; в редакторе переводов.
    Рисунок 5. Usages Detected (Обнаружено использование)
  4. Нажмите Посмотреть, где используется, чтобы проверить, что будет удалено. В диалоговом окне Find Safe Delete Conflicts (Найти конфликты безопасного удаления) будут показаны все случаи использования, которые нельзя удалить. Вы сможете изменить соответствующий код.

    Диалоговое окно &quot;Конфликты безопасного удаления&quot;, в котором показаны небезопасные варианты использования.
    Рисунок 6. Небезопасное использование
  5. Нажмите правой кнопкой мыши на вариант использования, чтобы открыть контекстное меню, и выберите Перейти к источнику, чтобы внести необходимые изменения.

  6. На панели Find Safe Delete Conflicts (Найти конфликты безопасного удаления) выберите Rerun Safe Delete (Повторить безопасное удаление), чтобы убедиться, что нет других использований, требующих внимания.

  7. После этого нажмите Do Refactor (Выполнить рефакторинг), чтобы удалить ключ.

Исправьте ошибки

На рисунке 7 показан редактор переводов с содержимым файлов strings.xml на английском, французском и испанском языках. Красный текст указывает на строки, в которых есть ошибки.

Редактор переводов, в котором ошибки выделены красным цветом.
Рисунок 7. Красным цветом выделены ошибки, которые необходимо исправить.

Чтобы исправить ошибку, наведите указатель мыши на красный текст. Появится объяснение проблемы и способ ее решения.

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

Примеры исправлений в Редакторе переводов:

  • На рисунке 7 показано, что в строке app_name установлен флажок Untranslatable, но при этом указан перевод на испанский язык. Удалите перевод на испанский, чтобы исправить ошибку.
  • На рисунке 7 показано, что в строке next_page отсутствует перевод на французский язык. Скопируйте с помощью клавиатуры текст Page Suivante в ячейку, чтобы исправить ошибку. При копировании и вставке с помощью клавиатуры текст копируется в ячейку со всеми диакритическими знаками.

Управление локализуемым текстом и его тестирование

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

Поддержка языков с письмом справа налево

Jetpack Compose поддерживает макеты с направлением письма справа налево. Модификаторы макета и API созданы на основе концепций направления, таких как start и end, а не абсолютных направлений, таких как left и right. Когда язык системы меняется на язык с письмом справа налево, Compose автоматически зеркально отражает эти макеты.

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

Чтобы включить поддержку письма справа налево, выполните следующие действия:

  1. Откройте файл AndroidManifest.xml.
  2. Добавьте атрибут android:supportsRtl="true" в элемент <application>:
<manifest ... >
    <application
        ...
        android:supportsRtl="true">
    </application>
</manifest>

Чтобы узнать больше о том, как Compose обрабатывает макет текста, зеркальное отображение и пользовательские конфигурации RTL, ознакомьтесь с разделом Работа с языками с направлением письма справа налево.

Как вручную задать направление текста

В Jetpack Compose вы не используете визуальное окно свойств, чтобы принудительно задать направление макета или текста. Compose автоматически обрабатывает зеркальное отображение справа налево на основе системной локали.

Однако если вам нужно вручную переопределить направление для определенного текстового элемента (например, отобразить строку LTR в макете RTL), вы можете передать объект TextDirection в TextStyle.

Допустимые значения:

  • TextDirection.Content: (Default) – направление определяется по первому символу с сильным направлением.
  • TextDirection.Ltr – принудительное направление слева направо.
  • TextDirection.Rtl – принудительное направление справа налево.

Подробнее о том, как настраивать стиль текста и вручную задавать направление текста в Compose, рассказывается в статье Стиль текста.

Используйте локализованные строки в приложении

После того как вы добавите и переведете строки в Редакторе переводов, файлы res/values/strings.xml будут автоматически обновлены и вы сможете использовать локализованные ресурсы в интерфейсе.

Чтобы узнать, как показывать локализованный текст, обрабатывать языки с письмом справа налево и использовать @Preview для тестирования разных языков и псевдоязыков, прочитайте раздел о строках в статье "Ресурсы в Compose".

Псевдолокали

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

Подробнее о том, как тестировать приложения с помощью псевдолокалей…

Дополнительные ресурсы

Просмотр контента