HarmonyOS NEXT - 类型定义和国际化

Resource 资源引用类型，用于设置组件属性的值。

可以通过rawfile创建Resource类型对象，不可以修改Resource中的各属性的值。

$r('belonging.type.name')
- belonging：系统资源或者应用资源，相应的取值为'sys'和'app'；
- type：资源类型，支持'string'、'color'、'boolean'、'float'、'intarray'、'integer'、'pattern'、'plural'、'strarray'、'media'；
- name：资源名称，在资源定义时确定。

$rawfile('filename')
filename：工程中resources/rawfile目录下的文件名称。

推荐大家优先使用Resource类型，将资源文件（字符串、图片、音频等）统一存放于resources目录下，便于开发者统一维护。同时系统可以根据当前配置加载合适的资源，例如，开发者可以根据屏幕尺寸呈现不同的布局效果，或根据语言设置提供不同的字符串。

代码实例：ResourcePage

@Entry
@Component
struct ResourcePage {
  @State message: string = 'Resource';

  build() {
    Column() {
      Text(this.message)
        .fontSize(30)
        .fontWeight(FontWeight.Bold)

      Button($r('app.string.label_login')).backgroundColor($r('app.color.btn_color'))

      Image($rawfile('cat.jpg')).size({width:100})
    }
    .height('100%')
    .width('100%')
  }
}

国际化@ohos.i18n 本模块提供系统相关的或者增强的国际化能力，包括区域管理、电话号码处理、日历等，相关接口为ECMA 402标准中未定义的补充接口。Intl模块提供了ECMA 402标准定义的基础国际化接口，与本模块共同使用可提供完整地国际化支持能力。

导入模块

import { i18n } from **********';

文本按指定国家进行本地化显示。

static getDisplayCountry(country: string, locale: string, sentenceCase?: boolean): string

代码实例

import { BusinessError } from **********';

try {
    let displayCountry: string = i18n.System.getDisplayCountry("zh-CN", "en-GB"); // displayCountry = "China"
} catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
}

文本按指定语言进行本地化显示。

static getDisplayLanguage(language: string, locale: string, sentenceCase?: boolean): string

代码示例

import { BusinessError } from **********';

try {
  let displayLanguage: string = i18n.System.getDisplayLanguage("zh", "en-GB"); // 用英文形式显示中文，displayLanguage = Chinese
} catch(error) {
  let err: BusinessError = error as BusinessError;
  console.error(`call System.getDisplayLanguage failed, error code: ${err.code}, message: ${err.message}.`);
}

针对输入语言，系统支持的国家或地区列表。

static getSystemCountries(language: string): Array<string>

代码实例

import { BusinessError } from **********';

try {
  let systemCountries: Array<string> = i18n.System.getSystemCountries('zh'); // systemCountries = [ "ZW", "YT", "YE", ..., "ER", "CN", "DE" ]
} catch(error) {
  let err: BusinessError = error as BusinessError;
  console.error(`call System.getSystemCountries failed, error code: ${err.code}, message: ${err.message}.`);
}

判断当前语言和地区是否匹配。

static isSuggested(language: string, region?: string): boolean

代码实例

import { BusinessError } from **********';

try {
  let res: boolean = i18n.System.isSuggested('zh', 'CN');  // res = true
} catch(error) {
  let err: BusinessError = error as BusinessError;
  console.error(`call System.isSuggested failed, error code: ${err.code}, message: ${err.message}.`);
}

设置应用的偏好语言。设置偏好语言为"default"后，应用语言将跟随系统语言，应用冷启动生效。

static setAppPreferredLanguage(language: string): void

代码实例

import { BusinessError } from **********';

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