.XML - Android Strings

Контент автоматически переведен с английского языка с помощью Phrase Language AI.

Расширения файлов	.xml
Расширение API	xml
Импорт	Да
Экспорт	Да
Поддержка форм множественного числа	Да
Поддержка описания	Да
Варианты формата Эти параметры можно указать при загрузить и/или Скачать файл. В зависимости от метода загрузить/Скачать (интерфейс приложений API, CLI, синхронизация репозитория и т. д.), их можно указать в запрос параметрах `загрузить`, `Скачать` или в файле конфигурации `phrase.yml`.	convert_placeholder escape_linebreaks unescape_linebreaks enclose_in_cdata indent_size indent_style unescape_tags include_tools_ignore include_tools_locale_definition escape_android_chars unescape_android_chars

Android XML — это специфический для Android вариант XML, который можно использовать для загрузки переводимый контент в приложения Android. Его корневым элементом является <resources> с многочисленными вложенными элементами <string>, в которых хранятся Strings, ожидающие перевода. Вы можете использовать Android Studio для создания этих файлов ресурсов и использовать Phrase для управления переводом.

Android Studio использует свойства translatable, чтобы указать, нужно ли переводить контент. В Phrase это свойства игнорируется. Нет необходимости отправлять эти Strings в Phrase. Если строка не должна переводиться, определите ее в отдельном файле ресурсов со всеми непереводимый Strings (например, donottranslate.xml).

Параметры формата

Идентификатор	convert_placeholder
Тип	булевский
Загрузить	Нет
Скачать	Да
По умолчанию	false
Описание	заполнитель будет преобразован в соответствии с требованиями формат. Пример: `$s' => '$@`

Идентификатор	escape_linebreaks
Тип	Булевский тип данных
Загрузить	Нет
Скачать	Да
По умолчанию	false
Описание	Все разрывы строк будут экранированы как `\\n`

Идентификатор	unescape_linebreaks
Тип	булевский
Загрузить	Да
Скачать	Нет
По умолчанию	false
Описание	Все `\\n` будут импортированы как настоящие разрывы строк

Идентификатор	enclose_in_cdata
Тип	булевский
Загрузить	Нет
Скачать	Да
По умолчанию	false
Описание	Заключает переводы, содержащие HTML-теги, в CDATA

Идентификатор	indent_size
Тип	integer
Загрузить	Нет
Скачать	Да
По умолчанию	4
Описание	Указывает количество символов отступа

Идентификатор	indent_style
Тип	строка
Загрузить	Нет
Скачать	Да
По умолчанию	каталог
Описание	Указывает символ отступа. Допустимые значения: `каталог` и `вкладка`.

Идентификатор	unescape_tags
Тип	булевский
Загрузить	Да
Скачать	Нет
По умолчанию	false
Описание	Все символы `<` будут преобразованы из экранированного вида в `<`, а все символы `>` — в `>` для тегов.

Идентификатор	include_tools_locale_definition
Тип	булевский
Загрузить	Нет
Скачать	Да
По умолчанию	false
Описание	Включить `Инструменты:языковой стандарт` атрибуты в результирующий XML.

Идентификатор	include_tools_ignore
Тип	булевский
Загрузить	Нет
Скачать	Да
По умолчанию	false
Описание	Включить `Инструменты:пропустить` атрибуты в результирующий XML. Если отключено (по умолчанию), атрибут `Инструменты:пропустить` опускается в экспортируемых файлах. Это помогает поддерживать чистоту файлов ресурсов и позволяет избежать включения атрибутов подавления предупреждений, специфичных для разработки.

Идентификатор	preserve_cdata
Тип	булевский
Загрузить	Нет
Скачать	Да
По умолчанию	false
Описание	Если контент перевода уже содержит тег CDATA, этот переключатель предотвращает дополнительное экранирование контента.

Идентификатор	escape_android_chars
Тип	булевский
Загрузить	Нет
Скачать	Да
По умолчанию	false
Описание	Экранирует `@`, `?` и `вкладка` специальные символы Android с помощью префикса обратной косой черты.

Идентификатор	unescape_android_chars
Тип	булевский
Загрузить	Да
Скачать	Нет
По умолчанию	false
Описание	Убирает экранирование `\\@`, `\\?`, `\\t` и `\\uXXXX` (Unicode символ с кодом XXXX).

Образец кода

<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<resources>
    <string name="boolean_key">--- true
</string>
    <string name="empty_string_translation"/>
    <!-- Это прекрасное описание для этого ключа! -->
    <string name=\"key_with_description\">Check it out! This key has a description! (At least in some formats)</string>
    <string name=\"key_with_line-break\">This translations contains
a line-break.</string>
    <string name=\"nested.deeply.key\">Hey, this key is nested even deeper.</string>
    <string name="nested.key">Этот ключ вложен в пространство имен.</string>
    <string name="null_translation"/>
    <plurals name="pluralized_key">
        <item quantity="one">Найдена только одна форма множественного числа.</item>
        <item quantity="other">Эй, у вас %s форм множественного числа!</item>        
    </plurals>
    <string-array name="sample_collection">
        <item>первый элемент</item>
        <item>второй элемент</item>
        <item>третий элемент</item>
    </string-array>
    <string name="simple_key">Просто ключ с сообщением.</string>
    <string name="unverified_key">Эта строка не проверено и ожидает проверки." (В некоторых форматах мы также экспортируем этот статус)</string>
</resources>

Множественные числа для файлов Android XML

Для значений множественного числа назначьте специальный тег <plurals> следующим образом:

<plurals name="messages">
        <item quantity="one">Получено одно сообщение.</item>
        <item quantity="other">Получено сообщений: %s.</item>        
</plurals>