快应用 应用配置

接口声明

无需声明

导入模块

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

接口定义

configuration.getLocale()

获取应用当前的语言环境。默认使用系统的语言环境，会因为设置或系统语言环境改变而发生变化

参数：

无

返回值：

示例：

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

configuration.setLocale(OBJECT)

设置应用的语言环境。设置完成后，应用会按照新的语言环境来更新页面，并回调 onConfigurationChanged​1060+​生命周期函数。当系统语言发生变化或应用重新进入时，当前语言环境会重置为系统语言；Web 组件与 Fetch 接口在请求 Header 中会携带对应的 Accept-Language

参数：

示例：

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

configuration.getThemeMode() 

获取应用当前的主题模式。

参数：

无

返回值：

返回当前主题模式值，类型为 Number，返回值是以下列表的其中一个：

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~`)

后台运行限制

无限制。 后台运行详细用法参见 后台运行脚本。