键	数据类型	描述
accessibilityEnabled	string	是否启用无障碍屏幕阅读。'true'表示启用，'false'表示不启用。
colorMode	ColorMode	色彩模式类型。 - ColorMode.LIGHT：浅色。 - ColorMode.DARK：深色。
fontScale	number	字体大小比例。开发者需要配置configuration，设置fontSizeScale为"followSystem"，具体配置步骤可参考configuration使fontScale跟随系统变化。默认值跟随系统默认参数。
fontWeightScale	number	字体粗细缩放比例。在不同的系统或者机型中，fontWeightScale的取值范围可能会有所不同。默认值跟随系统默认参数。
layoutDirection	LayoutDirection	布局方向类型： - LayoutDirection.LTR：从左到右。 - LayoutDirection.RTL：从右到左。
languageCode	string	当前系统语言值，取值必须为小写字母（例如：zh）。默认值跟随系统默认参数。

限制条件

Environment和UIContext相关联，需要在UIContext明确的时候才可以调用Environment的接口，可以通过在runScopedTask里调用明确上下文。如果不是在UIContext明确的地方调用，将导致无法查询到设备环境数据。

收起
自动换行
深色代码主题
复制
import { UIAbility } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';

export default class EntryAbility extends UIAbility {
  onWindowStageCreate(windowStage: window.WindowStage) {
    windowStage.loadContent('pages/Index');
    let mainWindow = windowStage.getMainWindow();
    mainWindow.then(mainWindowInstance => {
      let uiContext = mainWindowInstance.getUIContext();
      // Environment在UIContext.runScopedTask里调用明确上下文
      uiContext.runScopedTask(() => {
        Environment.envProp('languageCode', 'en');
      });
    });
  }
}

使用场景

从UI中访问Environment参数

使用Environment.envProp将设备运行的环境变量存入AppStorage中。
收起
自动换行
深色代码主题
复制
```
// 将设备的languageCode存入AppStorage，默认值为en
Environment.envProp('languageCode', 'en');
```
ShowDetails.ets
在自定义组件中通过@StorageProp获取languageCode的值。
收起
自动换行
深色代码主题
复制
```
@StorageProp('languageCode') lang: string = 'en';
```
ShowDetails.ets

设备环境到Component的更新链：Environment --> AppStorage --> Component。

说明

应用无法修改环境变量参数，因此使用@StorageProp获取。这样即使在组件内修改，也不会同步回AppStorage中，影响其他组件处获取环境变量的结果。

收起
自动换行
深色代码主题
复制
// 将设备languageCode存入AppStorage中
Environment.envProp('languageCode', 'en');

@Entry
@Component
struct UiEnvironment {
  @StorageProp('languageCode') languageCode: string = 'en';

  build() {
    Row() {
      Column() {
        // 输出当前设备的languageCode
        Text(this.languageCode)
          .fontSize(20)
          .margin(10)
      }
      .width('100%')
    }
    .height('100%')
  }
}

应用逻辑使用Environment

收起
自动换行
深色代码主题
复制
import { hilog } from '@kit.PerformanceAnalysisKit';

const DOMAIN = 0x0001;
const TAG = 'environmentalProject';

// 使用Environment.envProp将设备运行languageCode存入AppStorage中
Environment.envProp('languageCode', 'en');
// 从AppStorage获取单向绑定的languageCode的变量
const lang: SubscribedAbstractProperty<string> = AppStorage.prop('languageCode');

if (lang.get() === 'zh') {
  // 请将$r('app.string.AppliedLogic_Hello')替换为实际资源文件，在本示例中该资源文件的value值为"你好"
  hilog.info(DOMAIN, TAG, `${$r('app.string.AppliedLogic_Hello')}`);
} else {
  hilog.info(DOMAIN, TAG, 'Hello!');
}
AppliedLogic.ets

PersistentStorage：持久化存储UI状态

状态管理（V2）

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问智能客服提问