目录

如何定位单独设置APP偏好语言失败的问题

问题现象

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

问题代码示例参考如下：

import I18n from '@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'));
    };
  }
}

背景知识

问题定位

  1. 排查资源文件中语言信息是否配置正确。
  2. 排查切换语言过程中，语言状态status是否正确。

分析结论

通过setAppPreferredLanguage接口实现单独设置应用偏好语言。主要实现思路有以下三步：

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

修改建议

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

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

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

    • base目录中的string.json如下：
      {
  "string": [
    {
      "name": "module_desc",
      "value": "模块描述"
    },
    {
      "name": "language_button",
      "value": "改变语言"
    },
    {
      "name": "EntryAbility_desc",
      "value": "description"
    },
    {
      "name": "EntryAbility_label",
      "value": "label"
    }
  ]
}
    • en_US目录中的string.json如下：
      {
  "string": [
    {
      "name": "module_desc",
      "value": "module description"
    },
    {
      "name": "language_button",
      "value": "Change Language"
    }
  ]
}
    • zh_CN目录中的string.json如下：
      {
  "string": [
    {
      "name": "module_desc",
      "value": "模块描述"
    },
    {
      "name": "language_button",
      "value": "改变语言"
    }
  ]
}
  2. 点击按钮切换语言。
    • 进入页面后，显示的语言将跟随系统偏好语言进行设置。
    • 设置语言状态status，当系统偏好语言为中文时，status设置为-1，英文时，status设置为1。
    • 因为本例子中仅有中英两种语言，所以点击按钮后status将切换状态。
    import I18n from '@ohos.i18n';
import { BusinessError } from '@kit.BasicServicesKit';

@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) {
          try {
            I18n.System.setAppPreferredLanguage('zh-Hans');
          } catch (error) {
            let err: BusinessError = error as BusinessError;
            console.error(`zh-Hans call System.setAppPreferredLanguage failed, error code: ${err.code}, message: ${err.message}.`);
          }
        } else {
          try {
            I18n.System.setAppPreferredLanguage('en-Latn-US');
          } catch (error) {
            let err: BusinessError = error as BusinessError;
            console.error(`en-Latn-US call System.setAppPreferredLanguage failed, error code: ${err.code}, message: ${err.message}.`);
          }
        }
        this.status = -this.status;
      })
    }
  }
}

总结

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

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

另附跟随系统切换语言相关指南：多语言支持。