OpenHarmony国际化I18n开发范例

想了解更多关于开源的内容，请访问：

本站开源基础软件社区

概念介绍

在开发应用中可能会遇到多国家多地区场景，应用要提供不同的语言、时间、时区给目标用户和市场，开发者往往需要提供多个不同版本以保证不同地区用户方便使用。

本例基于国际化示例应用，为大家介绍I18n组件，该组件提供系统相关的或者增强的国际化能力。

接口

I18n官方文档@ohos.i18n。

具体实现

配置文件

应用需要在项目的module.json5配置文件中逐个声明所需的权限，否则应用将无法获取授权。

在配置文件的requestPermissions属性数组中配置所需的权限，包含3个属性。

{
  ...
  "requestPermissions": [
    {
      "name": "ohos.permission.UPDATE_CONFIGURATION"
    },
    {
      "name": "ohos.permission.SET_TIME_ZONE"
    },
    {
      "name": "ohos.permission.SET_TIME"
    }
  ]
}

• 更新配置权限：ohos.permission.UPDATE_CONFIGURATION
• 设置时区权限：ohos.permission.SET_TIME_ZONE
• 设置系统时间权限：ohos.permission.SET_TIME

引入I18n模块

import i18n from '@ohos.i18n';

语言和地区

• 使用getSystemRegion和getSystemLocale分别获取当前系统地区和系统区域，并传入getDisplayCountry获取指定国家的本地化显示文本。

this.currentRegion = i18n.System.getDisplayCountry(i18n.System.getSystemRegion(), i18n.System.getSystemLocale());

• 使用getSystemLanguage获取当前系统支持的语言列表。

this.localLanguage = i18n.System.getSystemLanguage();

• 使用getSystemCountries方法获取针对输入语言系统支持的国家或地区列表，随后可以遍历列表，并且调用isSuggested方法判断当前语言和地区是否匹配。

try {
  this.countryIds = i18n.System.getSystemCountries(this.currentRegion);
  } catch (err) {
  Logger.error(`getSystemCountries failed, code is ${err.code}, message is ${err.message}`);
  }
this.countryIds.forEach(id => {
  let country = i18n.System.getDisplayCountry(id, this.localLanguage);
  this.countries.push({ key: country, value: '' });
  let isSuggested: boolean;
  try {
    isSuggested = i18n.System.isSuggested(this.localLanguage, id);
  } catch (err) {
    Logger.error(`isSuggested failed, code is ${err.code}, message is ${err.message}`);
  }
  if (isSuggested) {
    this.suggestIds.push(id);
    this.suggestCounties.push({ key: country, value: '' });
  }
})

实现某时区城市在该区域的本地化显示列表：

使用getAvailableZoneCityIDs获取系统支持的时区城市ID。

使用getCityDisplayName格式化。

getTimeZoneSrc() {
  this.timeZoneSrc = [];
  let zoneCityIDs = i18n.TimeZone.getAvailableZoneCityIDs();
  for (let zoneCityId of zoneCityIDs) {
    let cityDisplayName = i18n.TimeZone.getCityDisplayName(zoneCityId, "zh-Hans");
    let timeZone = i18n.TimeZone.getTimezoneFromCity(zoneCityId);
    this.timeZoneSrc.push({
      key: timeZone.getID(),
      timeZone: timeZone,
      display: cityDisplayName
    });
  };
}

日期和时间

• 引入systemDateTime模块获取当前系统时间和时区。
• 引入Intl模块，该模块提供基础的应用国际化能力，包括时间日期格式化、数字格式化、排序等。

import systemDateTime from '@ohos.systemDateTime';
import Intl from '@ohos.intl';

systemDateTime模块官方文档@ohos.systemDateTimeintl模块官方文档@ohos.intl。

• 编写格式化时间方法。
  Intl.DateTimeFormat方法用来创建时间日期格式化对象。
  使用时间日期格式化对象的format方法格式化时间日期字符串。

getDateString() {
    let locale = i18n.System.getSystemLocale();
    let language = i18n.System.getSystemLanguage();
    let params = [language, locale];
    let dateFormat = new Intl.DateTimeFormat(params, options);
    let date = new Date();
    let formatString = dateFormat.format(date);
    if (language === 'zh-Hans') {
      let format = formatString.split(' ');
      return [format[0], format[1]];
    } else {
      let format = formatString.split(', ');
      return [`${format[0]}, ${format[1]}`, format[2]];
    }
  }

• 格式化时区:
  getRawOffset方法用来获取时区对象表示的时区与UTC时区的偏差。
  getSystemLanguage方法获取系统语言。
  getDisplayName方法用来获取时区对象的本地化表示。

getTimeZoneString(timeZone: i18n.TimeZone) {
  let offset = timeZone.getRawOffset();
  return `GMT${offset > 0 ? '+' : '-'}${this.getTimeString(offset)}  ${timeZone.getDisplayName(i18n.System.getSystemLanguage())}`;
}

上述代码中通过判断偏差来格式化时区显示。

• 获取系统时间后调用I18n的getTimeZone方法获取系统时区并使用上述方法格式化。

getTimeDisplay() {
    let timeZone = await systemTime.getTimezone();
    let zone = i18n.getTimeZone(timeZone);
    this.timeZone = this.getTimeZoneString(zone);
    let timeInfo = this.getDateString();
    this.date = timeInfo[0];
    this.time = timeInfo[1];
  }

区域格式示例

本模块进入界面展示当前区域，当前系统语言下的时间、数字、货币、百分比、单复数、屏幕方向等信息的格式化显示。

build() {
    Column() {
      TitleBar({ hasBackPress: true, title: $r('app.string.format_example') })
      this.TextView({ text: this.language })
      Column() {
        this.TextView({ text: this.date })
        this.TextView({ text: this.time })
        ForEach(this.numberFormat, (item, index) => {
          this.TextView({ text: item });
        }, item => item)
        this.TextView({ text: this.pluralFormat })
        this.TextView({ text: this.timeZoneDetect })
        this.TextView({ text: this.normalizer })
        this.TextView({ text: this.mDirection })
      }

页面代码中的language、data和time已经在上述方法中获取到，下面分别看一下剩下的数据如何获取。

• numberFormat

getNumberFormatString() {
    let currentLocale = new Intl.Locale();
    let locale = i18n.System.getSystemLocale();
    let numfmt = new Intl.NumberFormat();
    let options = numfmt.resolvedOptions();
    options.locale = locale;
    options.numberingSystem = currentLocale.numberingSystem;
    options.currency = 'CNY';
    options.currencySign = 'symbol';
    options.localeMatcher = 'best fit';
    options.style = 'decimal';
    let params = [i18n.System.getSystemLanguage(), locale];
    let numberFormat = new Intl.NumberFormat(params, options);
    options.style = 'currency';
    let currencyFormat = new Intl.NumberFormat(params, options);
    options.style = 'percent';
    let percentFormat = new Intl.NumberFormat(params, options);
    // 此处返回的只是一个示例，因此1234567，123456，78.9并不具有实际意义
    return [numberFormat.format(1234567), currencyFormat.format(123456), percentFormat.format(78.9)];
  }

该方法主要使用Intl.NumberFormat()方法创建数字格式化对象。
示例：

// 使用 en-GB locale创建NumberFormat对象，style设置为decimal，notation设置为scientific
let numfmt = new Intl.NumberFormat("en-GB", {style:'decimal', notation:"scientific"});

NumberFormat对象中resolvedOptions方法用来获取该对象的格式化选项。

• NumberFormat对象的部分选项

pluralFormat 复数字符串。

首先引入common模块。

import common from '@ohos.app.ability.common';

调用getPluralStringValue，根据指定数量获取指定ID字符串表示的单复数字符串。

getPluralString(id: number, num: number) {
    let context = getContext(this) as common.UIAbilityContext;
    let plural = await context.resourceManager.getPluralStringValue(id, num);
    return pluralFormat;
  }

resourceManager官方文档@ohos.resourceManager。

• timeZoneDetect
  调用getTimezonesByLocation创建某经纬度对应的时区对象数组。

const LONGITUDE = 116.20;
const LATITUDE = 39.56;
getTimeZoneDetect() {
    this.timeZoneDetect = await ResourceUtil.getString($r('app.string.coordinate').id);
    this.timeZoneDetect += '(' + LONGITUDE + ',' + LATITUDE + ') ' +
      i18n.TimeZone.getTimezonesByLocation(LONGITUDE, LATITUDE)[0].getDisplayName();
  }

• normalizer
  调用Normalizer.getInstance获取文本正则化对象。

getNormalizer() {
    let nl = i18n.Normalizer.getInstance(i18n.NormalizerMode.NFC);
    this.normalizer = '\u1100 +\u1161 +\u11A8 = ' + nl.normalize('\u1100\u1161\u11A8');
  }

• mDirection
  调用getDirection方法获取设备的配置，拿到屏幕方向属性。

async getDirection() {
  let context = getContext(this) as common.UIAbilityContext;
  let configuration = await context.resourceManager.getConfiguration();
  if (configuration.direction === 1) { // 1代表Horizontal，0代表Vertical
    return 'Horizontal';
  } else {
    return 'Vertical';
  }
}
}

想了解更多关于开源的内容，请访问：

本站开源基础软件社区