.XML - Android (字符串)

文本由 Phrase Language AI 从英语机器翻译而得。

文件扩展名	.xml
API 扩展	xml
导入	是
导出	是
复数形式支持	是
描述支持	是
格式选项这些选项可以在文件上传和/或下载时指定。根据上传/下载方法（API、CLI、Repo同步等），它们可以在查询参数 `上传`、`下载` 或 `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> 元素，用于存储待翻译的字符串。您可以使用 Android Studio 生成这些资源文件，并使用 Phrase 管理翻译。

Android Studio 使用属性 可译的 来指示内容是否需要翻译。在 Phrase 中，此属性会被忽略。无需将这些字符串推送到 Phrase。如果字符串不应被翻译，请在一个单独的资源文件中定义所有非可译字符串（例如 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 中包含 `tools:locale` attribute。

标识符	include_tools_ignore
类型	布尔值
上传	否
下载	是
默认	false
说明	在生成的 XML 中包含 `tools:ignore` attribute。当禁用时（默认），`tools:ignore` 属性将从导出的文件中省略。这有助于保持资源文件的整洁，避免包含特定于开发的 lint 抑制属性。

标识符	preserve_cdata
类型	布尔值
上传	否
下载	是
默认	false
说明	如果翻译内容已经包含 CDATA 标签，则此开关可防止内容被额外转义。

标识符	escape_android_chars
类型	布尔值
上传	否
下载	是
默认	false
说明	用反斜杠前缀转义 `@`、`?` 和 `Tab` Android 特殊字符。

标识符	unescape_android_chars
类型	布尔值
上传	是
下载	否
默认	false
说明	取消转义 `\@`、`\?`、`\t` 和 `\uXXXX`（代码为 XXXX 的 Unicode 字符）。

代码示例

<?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>(在某些格式中，我们也导出此状态)</string>
</resources>

Android XML 文件的复数形式

对于复数值，请分配一个特殊的<plurals>标签，如下所示：

<plurals name="messages">
        <item quantity="one">收到一条消息。</item>
        <item quantity="other">收到 %s 条消息。</item>        
</plurals>