国际化集成常见问题分析纪要之语言包文件

更新记录

版本 日期 修改人 修改内容
1.0.0 2020年7月23日 蔺浪(510525) 新建文档
1.0.1 2020年7月28日 黄金民(171517) 新增前置知识

前置知识

应用端的国际化涉及应用本身UI的国际化、器材的国际化和组件国际化,因器材和组件的国际化都涉及到语言包的问题,故器材和组件的国际化都用器材国际化指代,后续不再赘述。

目前应用本身UI的国际化是由应用本身处理,逻辑上比较简单,所以这块基本不会存在问题。
器材国际化虽有设计方案,但这里有几个盲点和约定,没有参与的人不是很清楚,需要特别说明

  • 其一器材的国际化是逐步发生的,因此存在国际化和非国际化器材同时存在的情况;
  • 其二器材的国际化离不开服务端,也就是管理平台的支持,但是这块流程管理平台没有一直没有文档说明清楚,特别是管理平台有个隐含的约定是器材到发布阶段才会生成语言包;
  • 其三是资源下载组件,在下载器材后,是否需要下载语言包,是通过器材包中是否有Language目录来区分的,支持国际化的器材都至少有个中文的语言文件在这个目录下。
  • 其四目前国际化的器材的最低播放组件版本都设置为2.4.0及以上。

为什么下载不到多语言包?

1. 中文语言包不下载

  • 解决方案协定:器材如果需要语言包,则器材压缩包文件解压后,存在“Language”目录且自带中文语言包“zh_CN.json”;
  • 若器材存在“Language”目录,但该目录下无中文语言包,此属资源问题,联系器材生产同学。

2. 器材不需要语言包

  • 解决方案协定:器材压缩包文件解压后,不存在“Languge”目录,则表明该器材不需要语言包,不会进行语言包请求与下载。

3. 器材不存在“Languge”目录

  • 若器材目录下存在“Menu.json”文件且该文件中配置了形如 “I18N/[equipCode]/[languageKey]” 的文本,该文本翻译需要多语言包的支持,但器材目录下不存在“Languge”目录,则该器材不遵循解决方案协定,此属资源问题,联系器材生产同学。

4. 器材当前版本无对应版本的语言包

  • 解决方案协定:指定版本的器材,在管理平台上需要有对应版本的语言包且该语言包状态为“已发布”,则该器材才能下载到多语言包;反之则下载不到语言包;
  • 如下图所示则该版本器材下载不到语言包(图示旨在举例说明逻辑,因平台上资源更新变动,该例子可能不复见);此属器材翻译资源问题,联系器材生产同学。
    器材无在线资源包图示

为什么器材不自带中文语言包?

1. 器材不需要语言包

  • 解决方案协定:器材压缩包文件解压后,不存在“Languge”目录,则表明该器材不需要语言包。

2. 器材需要语言包但没有配置语言包文件

  • 器材需要语言包且器材目录下存在“Languge”目录,但该目录下无中文语言包“zh_CN.json”,此属资源问题,联系器材生产同学。
  • (图示旨在举例说明逻辑,因平台上资源更新变动,该例子可能不复见)
    器材无自带资源包图示

为什么平台上资源正常但还是下载不到语言包?

1. 根据资源中心报错信息自行排查

2. 提供资源中心报错日志让该组件同学排查

干系人清单

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

相关链接