Apple stringsdict

翻译受支持的复数资源字符串,同时保留 plist 控制字段和格式选择结构。

Apple 复数资源既包含呈现给读者的文字,也包含用于选择正确形式的指令。xcode-stringsdict 文件处理器会翻译 plist 中受支持的字符串槽位,并保留 Apple 格式化器使用的控制值。

文本槽位与控制键 #

以下片段定义了一条根据数量变化的消息:

xml
<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,并在应用中加载该资源,使用能触发不同形式的数量进行测试。字符串目录采用不同的布局,将多个语言区域存放在同一个共享文件中。