• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.application.Configuration (Configuration)
2
3定义环境变化信息。Configuration是接口定义,仅做字段声明。
4
5> **说明:**
6>
7> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8> 本模块从API version 9废弃,替换模块为[@ohos.app.ability.Configuration (Configuration)](js-apis-app-ability-configuration.md)
9
10## 导入模块
11
12```ts
13import Configuration from '@ohos.app.application.Configuration';
14```
15
16**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
17
18  | 名称 | 类型 | 可读 | 可写 | 说明 |
19| -------- | -------- | -------- | -------- | -------- |
20| language<sup>8+</sup> | string | 是 | 是 | 表示应用程序的当前语言。 |
21| colorMode<sup>8+</sup> | [ColorMode](js-apis-application-configurationConstant.md#configurationconstantcolormode) | 是 | 是 | 表示深浅色模式,取值范围:浅色模式(COLOR_MODE_LIGHT),深色模式(COLOR_MODE_DARK)。默认为浅色。 |
22
23具体字段描述参考ohos.application.Configuration.d.ts文件
24
25**示例:**
26
27  ```ts
28import Ability from '@ohos.app.ability.UIAbility';
29import Window from '@ohos.window'
30
31export default class MainAbility extends Ability {
32    onCreate(want, launchParam) {
33    }
34
35    onDestroy() {
36    }
37
38    onWindowStageCreate(windowStage: Window.WindowStage) {
39        let envCallback = {
40            onConfigurationUpdated(config) {
41                console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`);
42                let language = config.language;
43                let colorMode = config.colorMode;
44            },
45            onMemoryLevel(level){
46                console.log('onMemoryLevel level: ${JSON.stringify(level)}');
47            }
48        };
49
50        let applicationContext = this.context.getApplicationContext();
51        applicationContext.on('environment',envCallback);
52
53        windowStage.loadContent('pages/index', (err, data) => {
54            if (err.code) {
55                console.error('failed to load the content, error: + ${JSON.stringify(err)}');
56                return;
57            }
58            console.info('Succeeded in loading the content, data: + ${JSON.stringify(data)}');
59        });
60    }
61}
62  ```
63
64