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.application.Configuration'; 14``` 15 16## 属性 17 18**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase 19 20 | 名称 | 类型 | 可读 | 可写 | 说明 | 21| -------- | -------- | -------- | -------- | -------- | 22| language<sup>8+</sup> | string | 是 | 是 | 表示应用程序的当前语言。例如:zh。 | 23| colorMode<sup>8+</sup> | [ColorMode](js-apis-application-configurationConstant.md#configurationconstantcolormode) | 是 | 是 | 表示深浅色模式,取值范围:浅色模式(COLOR_MODE_LIGHT),深色模式(COLOR_MODE_DARK)。默认为浅色。 | 24 25具体字段描述参考ohos.application.Configuration.d.ts文件 26 27**示例:** 28 ```ts 29import UIAbility from '@ohos.app.ability.UIAbility'; 30import AbilityConstant from '@ohos.app.ability.AbilityConstant'; 31import EnvironmentCallback from '@ohos.app.ability.EnvironmentCallback'; 32import Want from '@ohos.app.ability.Want'; 33import Window from '@ohos.window'; 34 35export default class EntryAbility extends UIAbility { 36 onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { 37 } 38 39 onDestroy() { 40 } 41 42 onWindowStageCreate(windowStage: Window.WindowStage) { 43 let envCallback: EnvironmentCallback = { 44 onConfigurationUpdated(config) { 45 console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`); 46 let language = config.language; 47 let colorMode = config.colorMode; 48 }, 49 onMemoryLevel(level){ 50 console.log(`onMemoryLevel level: ${JSON.stringify(level)}`); 51 } 52 }; 53 54 let applicationContext = this.context.getApplicationContext(); 55 applicationContext.on('environment',envCallback); 56 57 windowStage.loadContent('pages/index', (err, data) => { 58 if (err.code) { 59 console.error(`failed to load the content, error: ${JSON.stringify(err)}`); 60 return; 61 } 62 console.info(`Succeeded in loading the content, data: ${JSON.stringify(data)}`); 63 }); 64 } 65} 66 ``` 67 68