I18n 多语言

UltiTools 提供了一个易用的多语言 API，让你可以轻松的为你的插件添加多语言支持。

创建语言文件

在 resources 文件夹中创建一个 lang 文件夹。按照你的需求放入你的插件语言文件。

json

{
  "test": "测试",
  "test2": "测试2"
}

将文件名命名为 zh.json，其中 zh 为语言代码。

语言代码可参照此表。

实际使用的语言由 UltiTools 主插件配置决定

实际使用的语言取自 UltiTools 主插件配置中的 language 键，由 getLanguageCode() 读取。v6.3.0 起，构造该语言之前会先查询 supported()：配置的语言码不受支持时会输出警告，并退回一个确实存在的语言，而不再静默加载空字典。

supported() 的默认实现取自模块自身的 lang/*.json 文件，因此只要把语言文件命名为 lang/<语言码>.json 就无需重写它。重写它依然有效并优先生效，适用于模块想声明支持某个语言码、却没有对应文件的少数情形。

UltiTools 需要知道你的插件支持哪些语言，因此你需要在你的插件继承了 UltiToolsPlugin 的类进行注册

一种很简便的方法就是在继承了 UltiToolsPlugin 的类添加 @I18n 并添加语言代码：

java

@I18n({"zh", "en"})

当然你也可以重写 supported() 方法，返回一个含有语言代码的 List<String> 即可：

java

@Override
public List<String> supported() {
    return Arrays.asList("zh", "en");
}

在你的插件继承了 UltiToolsPlugin 的类中，有一个 i18n 方法，用于获取多语言字符串。

java

String test = i18n("test");

// 输出：测试

如果语言文件中不存在该字符串，将会返回该字符串本身。

java

String test3 = i18n("test3");

// 输出：test3

TIP

在仅有两种语言的情况下，你可以仅创建一个语言文件，其中的键值对的键为原文，值为译文。

Ling Bao

最后编辑于 3 分钟前

查看完整历史