针对YoYoBoot 前端多语言配置兼容性升级指南

本文档是针对YoYoBoot从V5的前端多语言兼容性升级,主要包括以下内容:

  • ant-design-vue 3.x
  • dayjs 时间处理库
  • moment 时间处理库

环境说明

后端多语言配置说明

在YoYoBoot V6中,后端多语言配置没有变化,仍然使用Abp框架提供的多语言配置方式,具体配置方式请参考多语言配置文档

注意!资源必须是dotnet支持的多语言编码,如:zh-Hans、en等。可以在添加多语言的时候查看,如下图:

1725625183312

如果需要默认增加多语言,请在路径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文件为嵌入资源

1725625377151

前端多语言配置说明

在vue文件夹路径:src\shared\i18n 中,如下图

1725625486327

需要对应配置多语言文件,以及文本内容,涉及的组件地址如下:

涉及到的前端多语言配置组件为:

注意!

后端多语言编码映射不同的前端库多语言

特别说明

后端与前端代码需要一致性对应;如后端多语言编码为zh-Hans,前端多语言编码为zh-CN,需要在前端代码中进行映射。可以参考custom1自定义前端库的多语言内容代码路径:src\shared\i18n\app-i18n.service.ts

1725625690372