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

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

article 2024/10/28 1:22:25

【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");

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": "中文"
    }
  ]
}