ArkUI Environment：设备环境查询指南文档示例

介绍

本示例通过使用ArkUI指南文档中各场景的开发示例，展示在工程中，帮助开发者更好地理解ArkUI提供的组件及组件属性并合理使用。该工程中展示的代码详细描述可查如下链接：
1. Environment：设备环境查询。

具体实现

基本功能与原理核心作用：查询设备环境信息，使应用能根据运行环境动态调整行为实现机制： Environment 是 ArkUI 框架创建的单例对象提供不可变的基本类型属性，反映应用运行时状态通过 AppStorage 访问环境变量主要特性：系统环境变化时自动更新，支持多种设备环境参数
支持的环境参数 colorMode：颜色模式（ColorMode.LIGHT/DARK） languageCode：系统语言代码（如 'zh'、'en'） layoutDirection：布局方向（LayoutDirectionction.LTR/RTL） fontScale：字体缩放比例 fontWeightScale：字体粗细比例 accessibilityEnabled：是否启用屏幕阅读器辅助功能
使用方式与代码示例将环境变量存储到 AppStorage： Environment.envProp('languageCode', 'en'); 在 UI 中访问环境参数： @StorageProp('languageCode') languageCode: string = 'en';

build() { Column() { Text(当前语言: ${this.languageCode}) } } 在应用逻辑中使用： const lang = AppStorage.prop('languageCode'); if (lang.get() === 'en') { console.info('Hello!'); }

项目结构

EnvironmentProject
├─ AppScope
│  ├─ app.json5
│  └─ resources
│     └─ base
│        ├─ element
│        │  └─ string.json
│        └─ media
│           ├─ background.png
│           ├─ foreground.png
│           └─ layered_image.json
├─ code-linter.json5
├─ entry
│  ├─ hvigorfile.ts
│  ├─ obfuscation-rules.txt
│  ├─ oh-package.json5
│  └─ src
│     ├─ main
│     │  ├─ ets
│     │  │  ├─ entryability
│     │  │  │  └─ EntryAbility.ets
│     │  │  ├─ entrybackupability
│     │  │  │  └─ EntryBackupAbility.ets
│     │  │  └─ pages
│     │  │     └─ Index.ets                  // 导航页
│     │  │     └─ AppliedLogic.ets           // 应用逻辑使用Environment页面
│     │  │     └─ ShowDetails.ets            // 额外代码块页面
│     │  │     └─ UiEnvironment.ets          // 从UI中访问Environment参数页面
│     │  ├─ module.json5
│     │  └─ resources
│     │     ├─ base
│     │     │  ├─ element
│     │     │  │  ├─ color.json
│     │     │  │  ├─ float.json
│     │     │  │  └─ string.json
│     │     │  ├─ media
│     │     │  │  ├─ background.png
│     │     │  │  ├─ foreground.png
│     │     │  │  ├─ layered_image.json
│     │     │  │  └─ startIcon.png
│     │     │  └─ profile
│     │     │     ├─ backup_config.json
│     │     │     └─ main_pages.json
│     │     ├─ dark
│     │     │  └─ element
│     │     │     └─ color.json
│     │     └─ rawfile
│     ├─ mock
│     │  └─ mock-config.json5
│     ├─ ohosTest
│     │  ├─ ets
│     │  │  └─ test
│     │  │     ├─ Ability.test.ets
│     │  │     └─ List.test.ets
│     │  └─ module.json5
│     ├─ screenshots  // 预览截图
│     │  └─ device
│     │     └─ image1.jpeg
│     └─ test
│        ├─ List.test.ets
│        └─ LocalUnit.test.ets
├─ hvigor
│  └─ hvigor-config.json5
├─ hvigorfile.ts
├─ oh-package-lock.json5
├─ oh-package.json5
└─ README.md

使用说明

需在 UIContext 明确时调用，可借 runScopedTask 指定上下文。
UI 访问需用 envProp 存 AppStorage，再绑 @StorageProp。
应用逻辑从 AppStorage 取已存的环境参数判断场景。
环境参数只读，修改 @StorageProp 不回传 AppStorage。

依赖

不涉及。

约束与限制

本示例仅支持标准系统上运行, 支持设备：华为手机。
HarmonyOS系统：HarmonyOS 5.0.5 Release及以上。
DevEco Studio版本：6.0.0 Release及以上。
HarmonyOS SDK版本：HarmonyOS 6.0.0 Release SDK及以上。

下载

如需单独下载本工程，执行如下命令：

git init
git config core.sparsecheckout true
echo ArkUISample/EnvironmentProject > .git/info/sparse-checkout
git remote add origin https://gitcode.com/harmonyos_samples/guide-snippets.git
git pull origin master

ArkUI Environment：设备环境查询指南文档示例

介绍

具体实现

项目结构

使用说明

相关权限

依赖

约束与限制

下载