.XML - Android (Strings)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Идентификатор	escape_android_chars
Тип	булевский
Загрузить	Нет
Скачать	Да
По умолчанию	false
Описание	Экранирует `@`, `?` и `Tab` специальные символы 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">Проверьте это! This key has a description! (По крайней мере, в некоторых форматах)</string>
    <string name="key_with_line-break">Это перевод содержит
перенос строки.</string>
    <string name="nested.deeply.key">Привет, этот ключ вложен еще глубже.</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>

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

Для множественных значений назначьте специальный <plurals> тег, как этот:

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