國際化

如今越來的越多的應用都走向了海外，應用走向海外需要支持不同國家的語言，這就意味著應用資源文件需要支持不同語言環境下的顯示。本節就介紹一下設備語言環境變更后，如何讓應用支持多語言。

應用支持多語言

ArkUI開發框架對多語言的支持比較友好，只需要在 resources 目錄下創建對應國家的文件夾，名稱對國家簡碼，例如中國為 zh ，則在 resources 下創建 zh 文件夾，然后在 zh 文件下創建對應的類別文件，筆者以文本資源支持多語言為例。

添加多語言數據

• 在resources目錄下創建 zh / element 文件夾目錄后，添加 string.json 文件：
  
  筆者分別在 zh 目錄下的 string.json 和 base 目錄下的 string.json 中添加了一個 json 數據， name 都是 calculator ， value 一個是英文一個中文。

使用多語言數據

|

使用 resources 目錄下的資源，ArkUI開發框架給我們提供了快捷方法： () ，比如要訪問 string.json 中的資源，可以簡寫 ('app.string.name') ，筆者在第 3 節有介紹 [$()] 的使用，讀者請自行查看。

• 在 index.ets 里使用添加的多語言，代碼如下：

  @Entry @Component struct Index {
  
    build() {
      Column({space: 10}) {
        Text('多語言測試：')
          .fontSize(22)
        Text($r("app.string.calculator")) // 使用多語言
          .fontSize(22)
      }
      .padding(10)
      .width('100%')
      .height('100%')
    }
  }
  

i18n和intl簡介

讓APP支持多語言可以采取資源本地化的操作，當設備語言環境變更后系統會自動讀取對應的資源，當需要手動獲取語言環境相關信息時，可以使用 @ohos.i18n 和 @ohos.intl 模塊提供的相關 API 實現。

• i18n模塊

  declare namespace i18n {
    // 獲取設備系統語言
    export function getSystemLanguage(): string;
    // 設置設備系統語言
    export function setSystemLanguage(language: string): boolean;
    // 獲取設備系統地區
    export function getSystemRegion(): string;
    // 獲取時區ID對應的時區對象
    export function getTimeZone(zoneID?: string): TimeZone;
  
    // 省略部分API
  }
  export default i18n;
  

  i18n 主要提供的是獲取系統信息，比如當前系統語言，系統區域等，預了解更多信息讀者可參考官方文檔或者源碼，

  aboutToAppear() {
    let language = i18n.getSystemLanguage();
    console.log(language);// 輸出：zh-Hans-CN
  }
  

• intl模塊

  declare namespace intl {
  
    // 區域初始化選項。
    export interface LocaleOptions {
    }
  
    // 區域信息設置對象
    export class Locale {
    }
  
    // 時間日期格式化選項。
    export interface DateTimeOptions {
    }
  
    // 日期格式化對象
    export class DateTimeFormat {
    }
  
    // 數字格式化選項
    export interface NumberOptions {
    }
  
    // 數字格式化對象
    export class NumberFormat {
    }
  
    // 省略相關 API
  }
  export default intl;
  

  @ohos.intl 模塊提供了信息在不同區域的差異化能力，比如日期顯示，在不同的國家顯示格式是不一樣的，可以采用DateTimeFormat 獲取不同的顯示方式：

  aboutToAppear() {
    let date = new Date(2022, 5, 1, 17, 45, 30);   // 創建日期
    var datefmt= new intl.DateTimeFormat("en-GB"); // 格式化對象
    console.log(datefmt.format(date));             // 輸出01/06/2022
  }
  

審核編輯 黃宇