Apple stringsdict
翻译受支持的复数资源字符串,同时保留 plist 控制字段和格式选择结构。
Apple 复数资源既包含呈现给读者的文字,也包含用于选择正确形式的指令。xcode-stringsdict 文件处理器会翻译 plist 中受支持的字符串槽位,并保留 Apple 格式化器使用的控制值。
文本槽位与控制键 #
以下片段定义了一条根据数量变化的消息:
<plist version="1.0">
<dict>
<key>items</key>
<dict>
<key>NSStringLocalizedFormatKey</key>
<string>%#@count@</string>
<key>count</key>
<dict>
<key>NSStringFormatSpecTypeKey</key>
<string>NSStringPluralRuleType</string>
<key>NSStringFormatValueTypeKey</key>
<string>d</string>
<key>one</key><string>%d item</string>
<key>other</key><string>%d items</string>
</dict>
</dict>
</dict>
</plist>NSStringFormatSpecTypeKey 和 NSStringFormatValueTypeKey 存储控制数据,不参与翻译。其他受支持的 <string> 值(包括 NSStringLocalizedFormatKey)则作为文本槽位处理。审核译文时,请保持 %#@count@ 和 %d 等格式化标记不变。
槽位根据其在字典和数组中的 plist 键路径进行匹配。空的 <string/> 元素也会被读取为字符串值,并可在写入替换内容时展开为 <string>...</string>。
重建与复数形式 #
当前源文件提供 plist 结构。旧版源值用于识别变更,匹配的现有目标槽位则可提供已认可的译文。替换时,编码后的文本会嵌入源文件,同时保留这些受支持片段周围的文件头和格式。
处理器会保留现有的复数形式选择结构,但不会自动生成目标语言的所有复数类别,也不会验证译文是否适用于所有数量。请使用实际读取该资源的 Apple 格式化器进行测试,而不要仅单独检查 one 和 other。
配置和测试复数资源 #
CLI 会根据 .stringsdict 推断 xcode-stringsdict;不支持按键限定范围的模式。请通过 CLI 配置或 GitHub 选择文件。
请将这些按语言区域划分的资源与字符串表一同存放在应用的 .lproj 目录中。验证 plist,并在应用中加载该资源,使用能触发不同形式的数量进行测试。字符串目录采用不同的布局,将多个语言区域存放在同一个共享文件中。