当前位置：首页 > news >正文

【HarmonyOS】应用实现APP国际化多语言切换

news 2025/9/15 17:27:02

【HarmonyOS】应用实现APP国际化多语言切换

前言

在鸿蒙中应用国际化处理，与Android和IOS基本一致，都是通过JSON配置不同的语言文本内容。在UI展示时，使用JSON配置的字段key进行调用，系统选择对应语言文本内容。

跟随系统多语言切换

最常见的处理，只需要配置不同语言的JSON配置，以最常见的中英文举例：
我们需要先在资源文件对应的语言json文本string配置表中，进行key，val的配置：
在这里插入图片描述
zh_CN为中文，en_US为英文，base-element中的string.json是默认配置。默认配置是必填，只要你创建了对应语言文件夹，没有在默认配置对应字段节点，系统就会提示报错：

如下图所示，配置好字段文本内容：

当我们配置好字段，只需要在UI中进行引用即可：

$r("app.string.xxx");
例如：
$r("app.string.test_content");

创建语言资源文件夹

1.在资源文件夹resources右键如下图所示，新增资源文件夹
在这里插入图片描述
2.在显示的弹框中选择Locale，点击右侧按钮，显示语言和地区

3.以英语为例，在语言列表，使用英文输入法可以触发筛选搜索框，选择对应该的语言和地区，点击OK即可生成。
在这里插入图片描述

APP独立多语言切换

当我们需要APP应用的语言独立于系统，不跟随系统语言设置进行改变。例如系统是中文，设置应用为英文的需求。这时我们需要设置应用优先语言来实现该效果：
在这里插入图片描述
语言ID列表见文章最下方。

        try {i18n.System.setAppPreferredLanguage("zh"); // 设置应用偏好语言为zh-Hans} catch(error) {let err: BusinessError = error as BusinessError;console.error(`call System.setAppPreferredLanguage zh failed, error code: ${err.code}, message: ${err.message}.`);}

DEMO示例：
启动页测试代码

import { i18n } from '@kit.LocalizationKit';
import { BusinessError } from '@kit.BasicServicesKit';@Entry
@Component
struct Index {@State message: string | Resource = $r("app.string.test_content");build() {Column() {Text(this.message).fontSize(50)Text("切换中文").fontSize(50).onClick(()=>{// 设置语言偏好try {i18n.System.setAppPreferredLanguage("zh"); // 设置应用偏好语言为zh-Hans} catch(error) {let err: BusinessError = error as BusinessError;console.error(`call System.setAppPreferredLanguage zh failed, error code: ${err.code}, message: ${err.message}.`);}})Text("切换英文").fontSize(50).onClick(()=>{// 设置语言偏好try {i18n.System.setAppPreferredLanguage("en");} catch(error) {let err: BusinessError = error as BusinessError;console.error(`call System.setAppPreferredLanguage en                                                                                                                                                                                                                                                                                                                       failed, error code: ${err.code}, message: ${err.message}.`);}})}.height('100%').width('100%')}
}

英文：

{"string": [{"name": "module_desc","value": "module description"},{"name": "EntryAbility_desc","value": "description"},{"name": "EntryAbility_label","value": "label"},{"name": "test_content","value": "English"}]
}

中文：

{"string": [{"name": "module_desc","value": "模块描述"},{"name": "EntryAbility_desc","value": "描述"},{"name": "EntryAbility_label","value": "标签"},{"name": "test_content","value": "中文"}]
}

默认：

{"string": [{"name": "module_desc","value": "模块描述"},{"name": "EntryAbility_desc","value": "描述"},{"name": "EntryAbility_label","value": "标签"},{"name": "test_content","value": "中文"}]
}