多语言本地化（L10N）

多语言本地化（以下简称 L10N 或本地化）是 Cocos Creator 3.6 推出的功能，该功能整合了第三方译文服务商的翻译服务，同时运行将文本、音频和图片等资源的本地化功能整合到引擎内，并支持一键发布到不同语言。

L10N 是单词 Localization 的首字母以及尾字母的缩写，10 代表 Localization 中间有 10 个字母。

L10N 总览

在引擎顶部菜单中选择 面板 -> 本地化编辑器 中即可打开本地化编辑器面板。

首次启动时，用户需手动启用 L10N 功能：

enable

启动后即可进行编辑。

overview

在面板的右上角，L10N 提供了 关闭 L10N 以及 卸载数据 两项功能：

menu

  • 关闭 L10N：关闭 L10N 功能。在弹出的二级菜单内选择确认后，数据依旧保留，开发者可再次启用该功能：

    alert

  • 卸载数据：在弹出的二级菜单内选择确认后，L10N 的数据将会被清除，场景内相关的组件也会被删除：

    alert

    注意：卸载后的数据无法恢复，请谨慎操作。

译文服务商

overview

引擎整合了多家译文服务商的翻译服务，开发者可以选择不同的译文服务商以提供更完善和多样化的服务。详情请参考 译文服务商。

收集并统计

ovefview

收集并统计将项目中可能需要翻译的文本内容进行收集，方便进行翻译，开发者也可以通过指定特定的文件、目录或通过配置进行过滤。详情请参考 搜集和统计

语言编译

overview

语言编译可以查看当前已配置和翻译的语言，并查看其进度或删除操作。同时也提供对某些非文本资源的手动处理。详情请参考 语言编译

程序化使用

请参考 示例 以获取程序化使用 L10N 的示例。

API 参考请移步 Localization Editor Api。

发布

根据上述的步骤完成翻译后，可以在发布界面进行一键发布：

publish

  • 使用的语言：这里将包含所有在 本地化编辑 中设置的语言，开发者可根据版本不同按需选择
  • 默认语言：发布后，项目启动时所使用的语言
  • 备用语言：默认语言出现问题后使用的备用语言

Q & A

  • Q：若我不慎修改了数据文件导致数据文件损坏而无法打开 L10N 时，是否有解决办法？ A：可以通过在 “{项目地址}\localization-editor\translate-data” 搜索对应文件进行修改。

示例

大型项目的多语言解决方案通常会采用数据文件（PO、CSV、EXCEL 等）来解决，为此我们也准备一篇 示例 供开发者参考。

内容

本章将包含以下内容：