• Home
Name Date Size #Lines LOC

..--

AppScope/06-May-2025-3633

common/06-May-2025-309258

entry/06-May-2025-1,7851,648

feature/06-May-2025-2,5412,348

hvigor/06-May-2025-2322

screenshots/devices/06-May-2025-

.gitignoreD06-May-2025121 1010

README_zh.mdD06-May-202511.3 KiB158121

build-profile.json5D06-May-20251.3 KiB5554

hvigorfile.tsD06-May-2025768 161

hvigorwD06-May-20252.1 KiB6228

hvigorw.batD06-May-20252 KiB7256

oh-package.json5D06-May-2025830 2525

ohosTest.mdD06-May-20255.1 KiB3027

README_zh.md

1# 设备管理合集（非系统特性）
2
3### 介绍
4
5本示例集合设备管理相关（非系统特性）不需要复杂功能展示的模块，展示了各个模块的基础功能，包含：
6
7- [@ohos.batteryInfo (电量信息)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-battery-info.md)
8- [@ohos.charger (充电类型)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-charger-sys.md)
9- [@ohos.deviceInfo (设备信息)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-device-info.md)
10- [@ohos.power (系统电源管理)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-power.md)
11- [@ohos.runningLock (Runninglock锁)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-runninglock.md)
12- [@ohos.settings (设置数据项名称)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-settings.md)
13- [@ohos.stationary (设备状态感知框架)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-multimodalawareness-kit/js-apis-stationary.md)
14- [@ohos.thermal (热管理)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-thermal.md)
15- [@ohos.usbManager (USB管理)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-usbManager.md)
16- [@ohos.multimodalInput.inputConsumer (组合按键)]https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-input-kit/js-apis-inputconsumer-sys.md)
17- [@ohos.multimodalInput.inputDevice (输入设备)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-input-kit/js-apis-inputdevice.md)
18- [@ohos.multimodalInput.inputEvent (输入事件)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-input-kit/js-apis-inputevent.md)
19- [@ohos.multimodalInput.inputEventClient (按键注入)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-input-kit/js-apis-inputeventclient-sys.md)
20- [@ohos.multimodalInput.inputMonitor (输入监听)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-input-kit/js-apis-inputmonitor-sys.md)
21- [@ohos.multimodalInput.keyCode (键值)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-input-kit/js-apis-keycode.md)
22- [@ohos.multimodalInput.keyEvent (按键输入事件)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-input-kit/js-apis-keyevent.md)
23- [@ohos.multimodalInput.mouseEvent (鼠标输入事件)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-input-kit/js-apis-mouseevent.md)
24- [@ohos.multimodalInput.pointer (鼠标指针)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-input-kit/js-apis-pointer.md)
25- [@ohos.multimodalInput.touchEvent (触摸输入事件)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-input-kit/js-apis-touchevent.md)
26
27### 效果预览
28
29|                   **主页**                   |                  **电量信息**                  |              **RunningLock锁**               |               **系统电源管理**               |
30|:------------------------------------------:|:------------------------------------------:|:-------------------------------------------:|:--------------------------------------:|
31|   ![home](screenshots/devices/home.jpg)    | ![power](screenshots/devices/battery.jpg)  | ![usb](screenshots/devices/runninglock.jpg) | ![home](screenshots/devices/power.jpg) |
32|                **设置数据项名称**                 |                **设备状态感知框架**                |                   **热管理**                   |               **USB管理**                |
33| ![power](screenshots/devices/settings.jpg) | ![usb](screenshots/devices/stationary.jpg) |  ![home](screenshots/devices/thermal.jpg)   | ![power](screenshots/devices/usb.jpg)  |
34
35使用说明
36
371.首页展示语言基础类库各个子模块菜单，点击进入对应的模块页面。
38
392.各个子模块界面中点击功能按钮完成各个功能。
40
413.电量信息：进入电量信息页面，展示设备电量相关信息。
42
434.RunningLock锁：点击按钮分别实现设备支持的休眠锁类型、设置屏幕休眠时间功能、设置是否通过接近或者远离状态来控制亮灭屏的锁功能。
44
455.系统电源管理：点击按钮分别实现获取亮灭屏状态、获取电源模式功能。
46
476.设置数据项名称：点击按钮分别实现获取数据项uri、开关飞行模式、检查应用是否能以悬浮形式显示功能。
48
497.设备状态感知框架：点击按钮分别实现订阅设备状态服务、取消订阅设备状态服务、查询设备状态并显示功能。
50
518.热管理：进入热管理页面，展示当前设备热档位信息、设备过热时提示用户。
52
539.USB管理：打开监听开关后插入USB设备，会有提示并刷新设备列表，关闭监听后插入USB设备不会提示和自动刷新，下拉设备列表可以手动刷新设备列表。
54
55### 工程目录
56
57```
58DeviceManagementCollection
59├── AppScope
60│   └── app.json5                               //APP信息配置文件
61├── entry/src/main                              //语言基础类库应用首页
62│   ├── ets
63│   │   ├── entryability
64│   │   ├── pages
65│   │   │   ├── Index.ets                       //主页入口
66│   │   │   ├── components
67│   │   │   │   └── Capabilities.ets            //根据点击的菜单，展示对应的子界面
68│   └── module.json5
69│
70├── common/src/main                             //公共组件及工具类
71│   ├── ets
72│   │   ├── components
73│   │   │   └── CustomDataSource.ets            //自定义DataSource，LazyForEach时使用
74│   │   ├── util
75│   │   │   ├── Logger.ets                      //日志工具类
76│   │   │   └── ResourceUtil.ets                //资源管理工具类
77│   └── module.json5
78│
79├── menuitems/src/main                          //菜单
80│   ├── ets
81│   │   ├── Index.ets                           //对外提供的接口列表
82│   │   ├── menulist                            //菜单组件
83│   │   │   └── MenuList.ets
84│   │   ├── components                          //菜单相关自定义组件
85│   └── module.json5
86│
87├── capabilities/src/main                       //功能集
88│   ├── ets
89│   │   ├── capabilities                        //各个子模块功能组件
90│   │   │   ├── BatteryInfo.ets                 //电量信息
91│   │   │   ├── PowerManager.ets                //系统电源管理
92│   │   │   ├── RunningLockManager.ets          //RunningLock锁
93│   │   │   ├── SettingsManager.ets             //设置数据项名称
94│   │   │   ├── StationaryManager.ets           //设置状态感知框架
95│   │   │   ├── Thermal.ets                     //热管理
96│   │   │   └── UsbManager.ets                  //USB管理
97│   │   ├── components                          //子模块相关组件
98│   │   │   ├── usbmanager                      //usbmanager相关组件
99│   │   │   ├── ColumnOperation.ets             //展示一列功能按钮的组件
100│   │   │   └── RadiusColumn.ets                //白色圆角的自定义Columm组件
101│   │   ├── model                               //相关数据模型
102│   │   └── utils                               //相关工具类
103│   └── module.json5
104```
105
106### 具体实现
107
1081.首页菜单展示：使用一个module，menuitems完成菜单组件的实现，传入要展示的菜单的strarray类型的资源和菜单点击对应的组件即可。使用Navigation和NavRouter组件实现菜单点击进入功能界面，使用LocalStorage实现应用内Ability内数据共享，点击菜单时标记selectedLabel，在entry中的Capabilities组件中，通过selectedLabel显示对应的功能组件。
109
1102.电量信息：使用[@ohos.batteryInfo.d.ts](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-battery-info.md)
111接口获取电池和充放电状态信息。
112
1133.RunningLock锁：使用[@ohos.runningLock.d.ts](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-runninglock.md)
114实现对Runninglock锁的创建、查询、持锁、释放等操作。
115
1164.系统电源管理：使用[@ohos.power.d.ts](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-power.md)
117实现获取亮灭屏状态、查询电源模式功能。
118
1195.设置数据项名称：使用[@ohos.settings.d.ts](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-settings.md)
120实现获取获取数据项uri、开关飞行模式、检查应用是否能以悬浮窗形式显示功能。
121
1226.设备状态感知框架：使用[@ohos.stationary.d.ts](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-multimodalawareness-kit/js-apis-stationary.md)
123接口提供设备状态感知能力。
124
1257.热管理：使用[@ohos.thermal.d.ts](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-thermal.md)
126提供热管理相关的接口，查询热档位以及注册温控等级回调。
127
1288.USB管理：使用[@ohos.usbManager.d.ts](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-usbManager.md)
129实现usb设备列表的获取，使用[@ohos.commonEventManager.d.ts](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-commonEventManager.md)
130订阅USB设备插入和拔出监听。
131
132### 相关权限
133
1341.允许应用获取运行锁权限：[ohos.permission.RUNNING_LOCK](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissionrunning_lock)
135
136### 依赖
137
138不涉及。
139
140### 约束与限制
141
1421.本示例仅支持标准系统上运行，支持设备：RK3568。
143
1442.本示例为Stage模型，支持API10版本SDK，SDK版本号(API Version 10 Release),镜像版本号(4.0 Release)
145
1463.本示例需要使用DevEco Studio 版本号(4.0 Release)及以上版本才可编译运行。
147
148### 下载
149
150如需单独下载本工程，执行如下命令：
151
152```text
153git init
154git config core.sparsecheckout true
155echo code/BasicFeature/DeviceManagement/DeviceManagementCollection/ > .git/info/sparse-checkout
156git remote add origin https://gitee.com/openharmony/applications_app_samples.git
157git pull origin master
158```