Apple 字符串
翻译 Apple 字符串表中的值,保留查找键,并对重建后的文本进行转义。
Apple 字符串表将固定的查找键映射到显示文本。xcode-strings 文件处理器会翻译右侧的值,保留查找键,并将转义后的字符串字面量写回各语言区域的 .strings 文件。
键和值 #
例如:
/* Checkout heading */
"checkout.title" = "Complete your order";
"delivery.estimate" = "Delivery within %d days";右侧的两个值是文本单元,checkout.title 和 delivery.estimate 则仍作为查找键。注释会随条目一并保留,但此处理器不会将注释内容转换为译者提示。如果简短标签存在歧义,请使用翻译工作流支持的上下文机制。
支持的字符串表语法包括带引号的键和值、赋值符号及分号。解析器会解码受支持的转义序列;输出时会对引号、反斜杠、换行符、制表符和回车符进行转义。替换值时,会保留周围的注释和条目间距。
合并与资源存放位置 #
系统根据上一版源文件,按键判断哪些值发生了变化,并从现有目标文件中保留译文。当前源文件决定条目集合和注释。消息有变动时,按常规方式更新源文件;调整翻译指导后,如需刷新整个文件,请明确执行全文件刷新。请参阅 CLI 作用范围。
请将语言区域资源放在应用加载这些资源的位置,例如 en.lproj/Localizable.strings 和 de.lproj/Localizable.strings。源文件位于 Base.lproj 中和位于以语言区域命名的目录中,在路径推导时有不同的含义。请通过所选工具检查目标位置;翻译字符串表并不会配置应用的开发语言或资源归属。
配置并加载字符串表 #
CLI 会根据 .strings 推断 xcode-strings。有关选择和路径规则,请参阅 CLI 配置;有关托管仓库输出,请参阅 GitHub。
在应用中加载目标字符串表,并用实际值测试格式说明符。复数选择资源请使用 stringsdict。如果项目使用 字符串目录,则应遵循其共享文件合并规则:为每个语言区域各自重命名一份字符串目录,会形成不同的资源布局。