应用配置 configuration 1060+

接口声明

无需声明

导入模块

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

接口定义

configuration.getLocale()

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

参数：

无

返回值：

示例：

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

configuration.setLocale(OBJECT)

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

参数：

示例：

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

configuration.getThemeMode() 1070+

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

参数：

无

返回值：

返回当前主题模式值，类型为 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~`)

configuration.setGrayMode(OBJECT) 1100+

设置灰色模式相关配置。通过该方法设置的配置项会覆盖manifest.json中的相应配置

参数：

duartion参数：

返回值：

无

示例：

configuration.setGrayMode({
    enable: true,
    duration: {
        regular: ["12/13"],
        temporary: ['2020/09/12']
    },
    excludedPages: ["/ImageDemo"]
})

后台运行限制

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