国际化集成常见问题分析纪要之文本翻译

更新记录

版本 日期 修改人 修改内容
1.0.0 2020年8月7 蔺浪(510525) 新建文档
1.0.1 2020年8月20 蔺浪(510525) 新增非法格式化key日志描述

空Key

[MultilingualUtility] Translate warning: The key is null or empty.

  • 若有日志输出上述格式内容,则说明传入期望翻译的key为空
  • 可取出日志(日志路径咨询应用负责人)反馈翻译组件负责人,快速确认该key来源和所属模块

无效Key

[MultiLanguageMr] Translate warning: Can not match the key {key} in the language content.

  • 若有日志输出上述格式内容,则说明本地语言文件(应用配置的多语言文件或PlayerCoreUI组件配置的多语言文件)中无该Key对应的配置内容
  • 可快速反馈应用开发同学或者PlayerCoreUI组件负责同学确认

[MultilingualUtility] TranslateEquipNormalKey warning: Can not match the key {key} in the languagePkg, code is {code}.

  • 若有日志输出上述格式内容,则说明器材多语言文件中无该key对应的配置内容
  • 将[code]和[key]反馈器材生产同学确认
  • 若存在异议,可反馈资源中心组件同学判定

非法Key

[MultilingualUtility] TranslateEquipNormalKey warning: The key {key} is not the same format as I18N/[code]/[wordKey].

  • 若有日志输出上述格式内容,则说明该key以“I18N”开头,但未遵循器材多语言key协定通式“I18N/[code]/[wordKey]”
  • 可快速反馈器材开发同学确认

[MultilingualUtility] TranslateEquipFormatKey warning: Can not find the format param tag {0} in the translate content {keyValue}, realKey is {realKey}, key is {key}.

  • 若有日志输出上述格式内容,则说明该key遵循“I18N”开头,遵循器材多语言格式化key协定通式“I18N/[code]/[wordKey],paramValue” ,但wordKey对应的翻译内容中并无“{0}”参数引用标识
  • 可快速反馈器材开发同学确认

无语言包

//找不到语言包对象
[MultilingualUtility] TranslateEquipNormalKey warning: Can not get languagePkg from VLabResourceCenter, code is {code}.

//语言包无本地资源
[MultilingualUtility] TranslateEquipNormalKey warning: The languagePkg does not exist local resource, code is {code}

未经翻译

  • 若无任何上述格式的日志输出,但UI显示文本依然没有翻译,则UI代码并没有调用翻译组件进行翻译
  • 反馈UI开发同学(不清楚开发人员则直接反馈应用负责人)

翻译有误

  • 若UI显示文本经过翻译,但翻译内容有误
  • 若器材相关的UI,则反馈器材生产同学确认
  • 其它UI反馈应用或者PlayerCoreUI组件同学确认

干系人清单

组件 描述 负责人 干系人
国际化解决方案 协定国际化解决方案 黄金民 黄金民 蔺浪 刘剑
MultilingualUtility 多语言翻译组件 蔺浪(510525) 蔺浪
ResourceCenter 资源中心组件,资源请求与下载 蔺浪(510525) 蔺浪 黄金民 杨循 刘剑
EquipmentPKG 器材资源包生产 徐强(790805) 唐绍军(635438) 朱毅博(258654)
EquipmentTranslate 器材语言包翻译 徐强(790805) 唐绍军(635438) 朱毅博(258654)

相关链接