针对YoYoBoot 前端多语言配置兼容性升级指南
本文档是针对YoYoBoot从V5的前端多语言兼容性升级,主要包括以下内容:
- ant-design-vue 3.x
- dayjs 时间处理库
- moment 时间处理库
环境说明
- .NET 6.0
- Yoyo.Abp 7.3.0.12
- Vue 3.0
- ant-design-vue 3.x
后端多语言配置说明
在YoYoBoot V6中,后端多语言配置没有变化,仍然使用Abp
框架提供的多语言配置方式,具体配置方式请参考多语言配置文档。
注意!资源必须是dotnet支持的多语言编码,如:zh-Hans、en等。可以在添加多语言的时候查看,如下图:
如果需要默认增加多语言,请在路径YoyoBoot.Template.EntityFrameworkCore\Seed\Host\DefaultLanguagesCreator.cs
种子数据中添加如下:
private static List<ApplicationLanguage> GetInitialLanguages()
{
return new()
{
new(null, AppConsts.DefaultLanguage, "简体中文", "famfamfam-flags cn"),
new(null, "en", "English", "famfamfam-flags us"),
};
}
记得配置*.json文件为嵌入资源
前端多语言配置说明
在vue文件夹路径:src\shared\i18n 中,如下图
需要对应配置多语言文件,以及文本内容,涉及的组件地址如下:
涉及到的前端多语言配置组件为:
- ant-design-vue 3.x
- dayjs 时间处理库
- moment 时间处理库
注意!
后端多语言编码映射不同的前端库多语言
特别说明
后端与前端代码需要一致性对应;如后端多语言编码为zh-Hans
,前端多语言编码为zh-CN
,需要在前端代码中进行映射。可以参考custom1自定义前端库的多语言内容代码路径:src\shared\i18n\app-i18n.service.ts