Apple 字符串目录

更新 XCStrings 目录中的目标语言值,同时保留源语言和其他语言区域。

.xcstrings 目录将源文本和译文保存在一起。xcode-xcstrings 文件处理器会填充目录中的目标语言条目,并保留同一文件中的其他语言区域。输出的是源路径下更新后的目录,而不是为每种语言创建一个新文件。

源值与变体 #

明确指定英语源值的条目如下所示:

json
{
  "sourceLanguage": "en",
  "strings": {
    "checkout.title": {
      "localizations": {
        "en": {
          "stringUnit": {
            "state": "translated",
            "value": "Complete your order"
          }
        }
      }
    }
  },
  "version": "1.0"
}

源语言的 stringUnit.value 提供文本。受支持的复数或设备变体各自提供独立的叶节点值,并带有对应变体的专属标识。如果条目缺少源语言的本地化内容,就会将其键用作源文本。这种回退机制适用于以源文本为键的情况,但 checkout.title 这样的技术键不能代替实际要表达的英语文本。

带有 shouldTranslate: false 的条目会被跳过。目录注释可以保留在共享结构中,但处理器提供的提示用于标识格式和变体,并不意味着每条注释都会用作翻译指导。

按语言区域检查完整性 #

完整性检查针对请求的语言区域进行。处理器会选取受支持的源文本槽位中已更改或缺少目标值的部分。因此,即使共享目录已经存在,新语言仍可获得译文。

即使使用 CLI 的 --force,目录中已有的译文仍可复用。清空单独的目标输入不会移除源目录中的值。如果源文本未更改,但需要调整译文措辞,请按下方流程修正。

组装时以当前源目录为基础,在适用时保留其中条目已有的语言区域数据,并将请求的译文写入当前条目及其变体。请审核整个共享文件的差异,包括源内容的更改和未修改的语言区域。新的目标单元采用 translated 状态;人工是否接受译文,仍需另行审核决定。

复数和设备变体的结构以受支持的源叶节点为准。不要据此认定每种目标语言的所有语法形式都已生成或验证。请检查变体集合,并在应用中展示有代表性的用例。

配置共享文件输出 #

CLI 根据 .xcstrings 推断 xcode-xcstrings,并将输出写入源路径。此类型的配置不允许设置单独的 targetPath。请按照 CLI 文件快速入门操作,直至获取结果,或使用 GitHub 进行托管式仓库翻译。

修正现有译文 #

如果需要精确调整措辞,请在 Xcode 中编辑对应语言区域的值,并在应用中验证。如果需要在更改引擎的指导说明后重新生成译文,请先完成待处理的翻译工作,并保留整个目录。保留 CLI 的现有基线,并在 targetLocales 中包含所需语言。

只移除需要重新生成的目标条目。以上面的示例为例,如果目标语言是德语,应移除 strings["checkout.title"].localizations.de;保留 en、其他语言区域和相邻条目。保存文件,然后执行一次普通的增量推送:

sh
lingo push --wait

提交更改后的目录时,该目标条目缺失,因此所选条目需要翻译。等待期间请勿编辑文件。接受结果前,请检查新的德语值和整个目录的差异。如果条目包含复数或设备变体,移除其语言区域条目会重新生成所有受支持的源变体。

执行此流程时,请使用已保存的基线并进行普通推送。位置参数模式、--backfill-missing 和 --key 会选取不同的处理任务;purge 会跳过共享文件。

审核整个目录的更改 #

替换或清理目录前,请保留已提交的目录或一份本地副本。CLI 清理会跳过此格式,因为其源文件与输出共用同一路径。重新生成单条译文时,请按上述方法移除对应的语言区域条目。

CLI 的目录检查无法确认 XCStrings 的语言区域是否完整。请通过 Xcode 和应用检查,验证资源归属、开发语言、多个目录、占位符以及显示的变体。具体流程请参阅本地化 iOS 应用。旧版 strings 和 stringsdict 仍采用每个语言区域对应独立文件的方式。