快應(yīng)用 應(yīng)用配置

接口聲明

無需聲明

導(dǎo)入模塊

import configuration from '@system.configuration' 或 const configuration = require('@system.configuration')

接口定義

configuration.getLocale()

獲取應(yīng)用當(dāng)前的語言環(huán)境。默認(rèn)使用系統(tǒng)的語言環(huán)境，會因為設(shè)置或系統(tǒng)語言環(huán)境改變而發(fā)生變化

參數(shù)：

無

返回值：

示例：

const locale = configuration.getLocale()
console.log(locale.language)

configuration.setLocale(OBJECT)

設(shè)置應(yīng)用的語言環(huán)境。設(shè)置完成后，應(yīng)用會按照新的語言環(huán)境來更新頁面，并回調(diào) onConfigurationChanged?1060+?生命周期函數(shù)。當(dāng)系統(tǒng)語言發(fā)生變化或應(yīng)用重新進(jìn)入時，當(dāng)前語言環(huán)境會重置為系統(tǒng)語言；Web 組件與 Fetch 接口在請求 Header 中會攜帶對應(yīng)的 Accept-Language

參數(shù)：

示例：

configuration.setLocale({
  language: 'zh',
  countryOrRegion: 'CN'
})

configuration.getThemeMode() 

獲取應(yīng)用當(dāng)前的主題模式。

參數(shù)：

無

返回值：

返回當(dāng)前主題模式值，類型為 Number，返回值是以下列表的其中一個：

PS:獲取主題模式值會有兩種情況：

1.如果?manifest.json?的?display?屬性下的?themeMode?值為?-1??（跟隨系統(tǒng)主題模式）?，則此時快應(yīng)用主題模式會跟隨系統(tǒng)。

此時返回值也跟隨系統(tǒng)主題模式，返回?0（日間模式）?或?1（夜間模式）?

2.如果?manifest.json?的?display?屬性下的?themeMode?值為?0（日間模式）?、?1（夜間模式）?或沒有設(shè)置（此時主題模式為默認(rèn)值?0（日間模式）?），則此時快應(yīng)用主題模式會設(shè)置為固定模式，不跟隨系統(tǒng)主題模式

此時返回值會與?manifest.json?的?display?屬性下的?themeMode?值保持一致（沒有設(shè)置?themeMode?值則返回 0 ）。

示例：

const themeMode = configuration.getThemeMode()
console.log(`Theme mode is ${themeMode} now~`)

后臺運行限制

無限制。 后臺運行詳細(xì)用法參見 后臺運行腳本。