國際化

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

應用支持多語言

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

添加多語言數(shù)據(jù)

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

使用多語言數(shù)據(jù)

|

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

• 在 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支持多語言可以采取資源本地化的操作，當設備語言環(huán)境變更后系統(tǒng)會自動讀取對應的資源，當需要手動獲取語言環(huán)境相關信息時，可以使用 @ohos.i18n 和 @ohos.intl 模塊提供的相關 API 實現(xiàn)。

• i18n模塊

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

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

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

• intl模塊

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

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

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

審核編輯 黃宇