快应用 应用配置
接口声明
无需声明
导入模块
import configuration from '@system.configuration' 或 const configuration = require('@system.configuration')
接口定义
configuration.getLocale()
获取应用当前的语言环境。默认使用系统的语言环境,会因为设置或系统语言环境改变而发生变化
参数:
无
返回值:
参数名 | 类型 | 说明 |
---|---|---|
language | String | 语言 |
countryOrRegion | String | 国家或地区 |
示例:
const locale = configuration.getLocale()
console.log(locale.language)
configuration.setLocale(OBJECT)
设置应用的语言环境。设置完成后,应用会按照新的语言环境来更新页面,并回调 onConfigurationChanged1060+
生命周期函数。当系统语言发生变化或应用重新进入时,当前语言环境会重置为系统语言;Web 组件与 Fetch 接口在请求 Header 中会携带对应的 Accept-Language
参数:
类型 | 必填 | 说明 |
---|---|---|
Object | 是 | 要设置的 Locale 对象 |
示例:
configuration.setLocale({
language: 'zh',
countryOrRegion: 'CN'
})
configuration.getThemeMode()
获取应用当前的主题模式。
参数:
无
返回值:
返回当前主题模式值,类型为 Number,返回值是以下列表的其中一个:
参数值 | 说明 |
---|---|
0 | 日间模式 |
1 | 夜间模式 |
PS:获取主题模式值会有两种情况:
1.如果manifest.json
的display
属性下的themeMode
值为-1
(跟随系统主题模式)
,则此时快应用主题模式会跟随系统。
此时返回值也跟随系统主题模式,返回0(日间模式)
或1(夜间模式)
2.如果manifest.json
的display
属性下的themeMode
值为0(日间模式)
、1(夜间模式)
或没有设置(此时主题模式为默认值0(日间模式)
),则此时快应用主题模式会设置为固定模式,不跟随系统主题模式
此时返回值会与manifest.json
的display
属性下的themeMode
值保持一致(没有设置themeMode
值则返回 0 )。
示例:
const themeMode = configuration.getThemeMode()
console.log(`Theme mode is ${themeMode} now~`)
后台运行限制
无限制。 后台运行详细用法参见 后台运行脚本。