添加新语言,无需重新翻译全部内容
新增目标语言区域,保留已接受的译文,并验证应用能否使用新资源。
添加语言需要衔接三项工作:选择要翻译的语言、创建资源,以及让应用加载这些资源。在界面中新增语言选项,并不会自动创建对应的资源目录。资源目录翻译完成,也不意味着路由会使用它。
开始前,确保源内容和已接受的目标译文都可恢复。记录计划添加的语言区域,必要时注明地区或文字体系。pt-BR 和 pt-PT 面向不同受众,对措辞的要求也可能不同。
检查现有结构和指导规则 #
列出源文件匹配模式、当前目标语言区域和预期输出路径。独立的目标文件可以分别添加;共享的 Xcode 字符串目录则在一个文件中存储多个语言区域,因此仅凭文件是否存在,无法判断覆盖情况。
针对新受众,检查模型覆盖情况、术语、语体和品牌语调。相近语言区域的指导规则,只在适用时复用。术语可以共用,称呼习惯却可能不同。支持从右向左书写的语言,还需要调整应用的显示方向和布局,而不只是翻译字符串。
将目标语言区域添加到当前 CLI 项目 #
当前 CLI 的目标语言区域由 .lingo/config.json 中的 targetLocales 指定。push 没有 --target-locale 或 --locale 选项。在单体仓库中,请确认当前工作目录选用的是哪个项目配置。
添加目标语言区域前,先使用 lingo push --wait 完成现有语言尚未处理的常规源内容更新。完成审核、获取输出,再对照当前源内容检查这些目标译文。添加新语言期间,保持这一源内容版本不变。
回填不会更改现有目标文件。如果只创建新语言的文件,回填会保留已有的源内容基线,让后续常规推送仍能处理其他语言尚未处理的修改。先完成这些更新,可确保现有译文和新语言译文都与同一个已审核的源内容版本保持一致。
然后,在已安装、已完成身份验证且已关联的项目配置中添加目标语言区域,并检查计划补齐哪些缺失文件:
lingo push --backfill-missing --estimate
lingo push --backfill-missing --wait估算不会翻译任何内容,也不会创建任务,但会上传服务器缺少的文件,用于制定计划。它并非离线操作,也不保证最终价格。回填会遍历已配置的匹配模式,补齐缺失的目标文件,但不会补齐现有目标文件中的新增键。新语言区域的译文更新到最新状态后,后续常规源内容变更会使用 lingo push --wait,对照已保存的基线进行处理。
共享的 XCStrings 目录会在同一个文件中按语言区域制定计划;请按照 iOS 工作流检查新增条目。
如果请求必须仅针对一个语言区域,请在受控分支或任务配置中缩小 targetLocales 的范围,完成后再恢复完整列表。不要仅为处理新语言而添加强制选项:它会重新翻译范围内的现有目标内容,并可能替换已审核的措辞。推送说明了这些区别;CLI v0 语言区域参考则介绍了旧版的标志选项。
为助手设定相同的边界 #
智能体可以检查结构、提出语言区域指导规则,并准备配置变更。请明确它可以修改本地文件、组织的本地化引擎设置,还是两者都可以修改。委派说明了这些权限的区别。
请它解释适用的主模型和回退模型,以及哪些指导规则共用、哪些专用于某个语言区域。比较输出前,请确认已保存的状态。语言区域解析说明了选择机制;模型偏好并不等于语言质量基准。
验证面向新受众的结果 #
对照预期范围检查返回的路径和变更差异。现有已接受的目标译文应保持不变,除非变更源于源内容更新或经授权的修正。使用应用的资源工具验证变量、复数分支和语言区域元数据。
使用新的语言区域加载有代表性的内容。除了含义,还要检查回退、溢出和显示方向。扩大覆盖范围前,保留源内容版本和结果,以便进行衡量。
从配置中移除语言区域后,新任务将不再选择它,但这不会删除资源或运行时路由。是否进行这些更改,需要单独决定,尤其是当一个共享目录同时包含源内容和多种语言时。