HarmonyOS鸿蒙Next中如何定位单独设置APP偏好语言失败的问题

【问题现象】

单独设置APP偏好语言失败，APP语言必须和系统语言保持一致。

1. 预期效果

应用可以根据用户的选择，自行变换应用内的语言。

2. 实际效果

应用内语言只能与系统的偏好语言保持一致。

问题代码如下：

import I18n from '[@ohos](/user/ohos).i18n';
import { BusinessError } from '@kit.BasicServicesKit';

try {
  I18n.System.setAppPreferredLanguage('en-Latn-US'); // 设置应用当前的偏好语言为 "US"
} catch(error) {
  let err: BusinessError = error as BusinessError;
  console.error(`call System.setAppPreferredLanguage failed, error code: ${err.code}, message: ${err.message}.`);
}

@Component
@Entry
struct Index {

  build() {
    Column() {
      Text($r('app.string.module_desc'));
    }
  }
}

【背景知识】

• @ohos.i18n (国际化-I18n)：该模块提供系统相关的或者增强的国际化能力，包括区域管理、电话号码处理、日历等。
• 设置应用的偏好语言：static setAppPreferredLanguage(language: string): void。

【定位思路】

由于未找到能直接改变语言的接口，因此还是得通过setAppPreferredLanguage接口实现。主要实现思路有以下三步：

1. setAppPreferredLanguage接口需要从资源文件中获取语言信息，资源文件中需要提前声明准备提供给用户的不同语言；
2. 在用户界面提供可选语言的下拉框或按钮等交互组件，让用户进行自主选择；
3. 记录用户的选择，并设置进偏好语言中。

【解决方案】

根据上述思路，下文中将以“通过点击按钮，自主切换中英文”进行说明：

1. 在资源文件中添加中/英文的value值

默认语言（base文件）以及中文语言（zh_CN文件）写的是中文，英文语言（en_US文件）写的是英文。因此在偏好语言为英文时，显示en_US文件的内容；偏好语言为中文时，显示zh_CN文件的内容；偏好语言为其他语言时，显示base文件的内容。

代码示例如下：

// base
{
  "string": [
    {
      "name": "module_desc",
      "value": "模块描述"
    },
    {
      "name": "language_button",
      "value": "改变语言"
    }
  ]
}

// zh_CN
{
  "string": [
    {
      "name": "module_desc",
      "value": "模块描述"
    },
    {
      "name": "language_button",
      "value": "改变语言"
    }
  ]
}

// en_US
{
  "string": [
    {
      "name": "module_desc",
      "value": "module description"
    },
    {
      "name": "language_button",
      "value": "Change Language"
    }
  ]
}

2. 点击按钮切换语言

• 进入页面后，显示的语言将跟随系统偏好语言进行设置。
• 设置语言状态status，当系统偏好语言为中文时，status设置为-1，英文时，status设置为1。
• 因为本例子中仅有中英两种语言，所以点击按钮后status将切换状态。

代码示例如下：

import I18n from '[@ohos](/user/ohos).i18n';
@Component
@Entry
struct Index {
  // 获取当前系统语言。如果为中文，则设置status为-1；如果为英文，则设置status为1
  status: number = I18n.System.getSystemLanguage() === "zh-Hans" ? -1 : 1;

  build() {
    Column() {
      // 获取应用偏好语言
      Text($r('app.string.module_desc'));
      Button($r('app.string.language_button')).onClick(() => {
        if (this.status === 1) {
          I18n.System.setAppPreferredLanguage('zh-Hans');
        } else {
          I18n.System.setAppPreferredLanguage('en-Latn-US');
        }
        this.status = -this.status;
      })
    }
  }
}

效果：

点击按钮前：

点击按钮后：

即可实现当系统语言是中文时，用户仍然可以根据自己的喜好进行应用内的语言切换：

【总结】

无论是在APP内单独切换语言设置，还是跟随系统语言切换，多语言都需要通过两个步骤：

1. 定义资源文件
2. 引用资源文件

另附跟随系统切换语言相关指南。