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

接口聲明

無(wú)需聲明

導(dǎo)入模塊

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

接口定義

configuration.getLocale()

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

參數(shù)：

無(wú)

返回值：

示例：

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

configuration.setLocale(OBJECT)

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

參數(shù)：

示例：

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

configuration.getThemeMode() 

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

參數(shù)：

無(wú)

返回值：

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

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

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

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

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

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

示例：

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

后臺(tái)運(yùn)行限制

無(wú)限制。 后臺(tái)運(yùn)行詳細(xì)用法參見(jiàn) 后臺(tái)運(yùn)行腳本。