文档管理中心
我的

您当前正在浏览HarmonyOS最新文档,覆盖已发布的所有API版本,可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。

指南与API参考API参考应用框架Ability Kit(程序框架服务)ArkTS API已停止维护的接口@ohos.application.Configuration (Configuration)

@ohos.application.Configuration (Configuration)

Phone12+PC/2in113+Tablet12+TV19+Wearable18+

定义环境变化信息。Configuration是接口定义,仅做字段声明。

说明

本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

本模块从API version 9废弃,替换模块为@ohos.app.ability.Configuration (环境变量)。

导入模块

收起
自动换行
深色代码主题
复制
  1. import Configuration from '@ohos.application.Configuration';

Configuration

Phone12+PC/2in113+Tablet12+TV19+Wearable18+

系统能力:SystemCapability.Ability.AbilityBase

展开
名称 类型 只读 可选 说明
language8+ string 否 是 表示应用程序的当前语言。例如:zh。
colorMode8+ ConfigurationConstant.ColorMode 否 是 表示深浅色模式,取值范围:浅色模式(COLOR_MODE_LIGHT),深色模式(COLOR_MODE_DARK)。默认为浅色。

示例:

收起
自动换行
深色代码主题
复制
  1. import UIAbility from '@ohos.app.ability.UIAbility';
  2. import AbilityConstant from '@ohos.app.ability.AbilityConstant';
  3. import EnvironmentCallback from '@ohos.app.ability.EnvironmentCallback';
  4. import Want from '@ohos.app.ability.Want';
  5. import Window from '@ohos.window';
  6. import { BusinessError } from '@ohos.base';
  7. export default class EntryAbility extends UIAbility {
  8. onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
  9. }
  10. onDestroy() {
  11. }
  12. onWindowStageCreate(windowStage: Window.WindowStage) {
  13. let envCallback: EnvironmentCallback = {
  14. onConfigurationUpdated(config) {
  15. console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`);
  16. let language = config.language;
  17. let colorMode = config.colorMode;
  18. },
  19. onMemoryLevel(level) {
  20. console.info(`onMemoryLevel level: ${JSON.stringify(level)}`);
  21. }
  22. };
  23. let applicationContext = this.context.getApplicationContext();
  24. try {
  25. applicationContext.on('environment', envCallback);
  26. } catch (paramError) {
  27. console.error(`error: ${(paramError as BusinessError).code}, ${(paramError as BusinessError).message}`);
  28. }
  29. windowStage.loadContent('pages/index', (err, data) => {
  30. if (err.code) {
  31. console.error(`failed to load the content, error: ${JSON.stringify(err)}`);
  32. return;
  33. }
  34. console.info(`Succeeded in loading the content, data: ${JSON.stringify(data)}`);
  35. });
  36. }
  37. }