Android 资源
翻译受支持的字符串、数组和复数形式,同时保留 Android 资源名称和语言区域目录规则。
Android 通过资源名称将界面文本与应用代码关联起来。android 文件处理器会保留这些名称,并翻译 <resources> 根元素内受支持的字符串、字符串数组项和复数项。数量属性和数组位置仍用于标识 Android 加载的值。
资源选择 #
资源文件中可以同时包含待翻译的文本和固定不变的产品名称:
<resources>
<string name="checkout_title">Complete your order</string>
<string name="brand" translatable="false">Acme</string>
<string-array name="delivery_methods">
<item>Standard delivery</item>
<item>Express delivery</item>
</string-array>
<plurals name="items">
<item quantity="one">%d item</item>
<item quantity="other">%d items</item>
</plurals>
</resources>资源名称、数组位置和复数数量用于标识可翻译的值。brand 带有 translatable="false",因此会被跳过。数组项的标识包含位置信息,因此调整数组顺序会改变其文本与现有目标译文的匹配方式。当前 CLI 不支持 Android --key 选择;请改为选择整个源文件。
处理器会读取每个条目中的字符数据,并跳过包含 <b> 或 <xliff:g> 等子元素的条目。请为这些富文本资源单独提供经过审核的目标译文,并在其所在文件处理完成后检查译文覆盖情况。行内 XML 注释两侧的文本会合并后送去翻译;替换该值时可能会移除行内注释,注释内容也不会用作翻译提示。
当 CDATA 构成单一文本值时,处理器会将其解析为文本,并在重建时保留其包裹结构。CDATA 内的标记会作为文本的一部分送去翻译,而不会作为子元素结构受到保护。请使用应用实际采用的渲染代码检查这些资源。
语言区域文件位置 #
源文件通常为 res/values/strings.xml;德语目标文件应放在 res/values-de/strings.xml 中。地区和文字系统限定符必须采用 Android 规定的写法,例如 values-pt-rBR 或 values-b+zh+Hans,而不能在 values- 后随意粘贴语言区域字符串。
显式指定 Android 格式后,CLI 路径推导便可识别不带限定符的 values 目录。对于这种受支持的目录布局,无需额外创建 values-en 符号链接。该格式所隐含的 Android 语言区域写法,以及任何显式指定的目标路径,都应在 CLI 配置中设置。接受输出前,请先检查推导出的路径。
复用与部分输出 #
处理器会按资源标识比对先前的源文本,并在重建时使用现有目标文件中匹配的值。源文本发生变化时,请使用常规的 lingo push --wait;强制刷新整个文件前,请先保留已认可的目标译文。固定文本应放在标有 translatable="false" 的资源中;CLI lockedKeys 并不是 Android 资源控制项。
处理器会保留源文件中的复数类别,但不保证这些类别对每个目标语言区域都完整,也不保证相应措辞都正确。请使用应用的资源加载器测试数量和格式化变量。
配置并验证 Android 资源 #
对于 .xml CLI 源,请显式设置 format: "android"。仅凭 XML 无法识别 Android 资源词汇体系。GitHub App 也支持配置中指定的类型。
使用 Android 工具构建获取到的资源,然后打开一个同时使用字符串、数组和复数形式的界面。本地化 Android 应用介绍了完成这一工作流程的方法。lingo check 报告的是源文件发生变化或目标文件缺失,而不是文件内部缺少 Android 资源。