1# wukong部件
2
3## 简介
4
5OpenHarmony稳定性测试自动化工具，通过模拟用户行为，对OpenHarmony系统及应用进行稳定性压力测试。<br>
6
7wukong部件架构图<br>
8![架构图](figures/wukong部件架构图.png)<br>
9
10部件内子模块职责：<br>
111. 命令行解析：支持命令行获取参数并解析命令行参数。<br>
122. 运行环境管理：根据命令行初始化wukong整体运行环境。<br>
133. 系统接口管理：检查并获取指定的mgr，注册controller和dfx的faultlog的回调函数。<br>
144. 随机事件生成：通过random函数生成指定种子数的随机序列，生成事件。<br>
155. 事件注入：根据支持的事件类型向系统注入事件，依赖窗口、多模、安全等子系统。<br>
166. 异常捕获处理/报告生成：通过DFX子系统获取运行中的异常信息并记录log，生成报告。<br>
17
18## 目录
19
20```
21├── wukong                              # wukong主要代码文件
22|   └── common                          # 提供应用管控能力，随机事件注入能力，多模事件注入能力
23|   └── component_event                 # 定义ability、page、Component树，提供添加节点、遍历树、依据NodeId查找子节点等能力
24|   └── input_factory                   # 实现屏幕点击、滑动、拖拽、键盘等事件注入能力    
25|   └── report                          # 监听异常信息，对其进行收集、统计、显示功能
26|   └── shell_command                   # 用来创建命令行map,解析命令行参数并执行命令行               
27|   └── test_flow                                  
28│       └── include                     # 定义头文件
29│       └── src                     
30│           ├── random_test_flow.cpp    # 继承TestFlow,是随机测试的执行流
31│           ├── special_test_flow.cpp   # 继承TestFlow,是顺序专项测试的执行流
32│           ├── focus_test_flow.cpp     # 继承TestFlow,是专注测试的执行流
33│           ├── test_flow.cpp           # 检查命令行参数是否符合规范
34│   ── BUILD.gn                         # 存放wukong构建的配置，具体包括构建对象、方式、依赖、硬件架构、文件格式
35│   ── README_zh.md                     # readme文件
36```
37
38## 约束
39
401. wukong在3.2系统版本后开始预置使用。<br>
412. wukong在3.2系统版本之前的版本不随版本编译，使用时需自行编译后推送至被测OpenHarmony设备，步骤如下：        
42    2.1. 构建方式
43    ```
44    ./build.sh --product-name rk3568 --build-target wukong
45    ```
46    2.2. 推送方式
47    ```
48    hdc_std shell mount -o rw,remount /
49    hdc_std file send wukong /
50    hdc_std shell chmod a+x /wukong
51    hdc_std shell mv /wukong /bin/
52    ```
53
54## 使用说明
55
56### 功能特性及命令说明
57
58
59| 命令           | 说明                                           | 备注          |
60| -------------- | ---------------------------------------------- | ------------- |
61| version | 获取wukong版本信息。                             | -v, --version。 |
62| help    | 获取wukong帮助信息。                             |              |
63| appinfo | 查询支持拉起应用bundleName和对应的mainAbility名。 |               |
64| special | wukong专项测试。                                   |               |
65| exec    | wukong随机测试。                                   |               |
66| focus   | wukong专注测试。                                   |               |
67
68
69### wukong special描述
70
71| 命令                | 功能                   | 必选 | 备注                |
72| :------------------ | ---------------------- | ---- | :------------------ |
73| -h, --help          | 获取当前测试的帮助信息。 | 否   | 专项测试帮助信息。    |
74| -k, --spec_insomnia | 休眠唤醒专项测试。       | 否   | -                   |
75| -c, --count         | 设置执行次数。           | 否   | 默认10次。            |
76| -i, --interval      | 设置执行间隔。           | 否   | 单位ms，默认1500ms。  |
77| -S, --swap          | 滑动测试。               | 否   | -                   |
78|-s, --start[x,y]    | 设置滑动测试起点坐标。   | 否   | -                   |
79| -e, --end[x,y]      | 设置滑动测试终点坐标。   | 否   | -                   |
80| -b, --bilateral     | 设置往返滑动。           | 否   | 默认不往返滑动。      |
81| -t, --touch[x,y]    | 点击测试。               | 否   | -                   |
82| -T, --time          | 设置测试总时间。         | 否   | 单位分钟，默认10分钟。 |
83| -C, --component     | 控件顺序遍历测试。       | 否   | 需要设置测试应用名称。 |
84| -r, --record     | 录制。       | 否   | 需要指定录制文件。 |
85| -R, --replay    |  回放。      | 否   | 需要指定回放文件。 |
86| -p, --screenshot    |  控件测试截图。      | 否   | - |
87
88#### wukong special 专项测试使用示例
89
90```bash
91
92> hdc_std shell
93# wukong special -C [bundlename] -p
94
95```
96
97专项测试示例解析：
98| 命令           | 参数值           | 说明                                           |
99| -------------- |-------------- | ---------------------------------------------- |
100| wukong special |  | 主命令。                             |
101| -C [bundlename]    |[bundlename] | 控件顺序遍历测试参数设置，bundlename为测试应用名称。            |
102| -p |  | 表示截图。                             |
103
104### wukong random描述
105
106| 命令            | 功能                                 | 必选 | 备注                                     |
107| --------------- | ------------------------------------ | ---- | ---------------------------------------- |
108| -h,--help       | 获取当前测试的帮助信息。               | 否   | 随机测试帮助信息。                         |
109| -c,--count      | 设置执行次数，与-T冲突。                         | 否   | 单位次数，默认10次。                       |
110| -i,--interval   | 设置执行间隔。                         | 否   | 单位ms，默认1500ms。                       |
111| -s,--seed       | 设置随机种子。                         | 否   | 配置相同随机种子，会生成相同随机事件序列。 |
112| -b,--bundle[bundlename,……,bundlename]     | 设置本次测试的允许应用名单，与-p冲突。 | 否   | 默认测试当前设备所有应用(应用名称用逗号隔开)。                 |
113| -p,--prohibit[bundlename,……,bundlename]   | 设置本次测试的禁止应用名单，与-b冲突。 | 否   | 默认不禁止任何应用(应用名称用逗号隔开)。                       |
114| -d,--page[page,……,page]                   | 设置本次测试的禁止页面名单 | 否  | 系统默认禁止pages/system页面(页面名称用逗号隔开)。 |
115| -e,--allow[ability,……,ability]            | 设置本次测试的允许ability页面 | 否 | 若配置此参数，需同时增加-b参数来限定应用 |
116| -E,--block[ability,……,ability]            | 设置本次测试的禁止ability页面 | 否 | 若配置此参数，需同时增加-b参数来限定应用 |
117| -a,--appswitch  | 设置应用随机拉起测试比例。             | 否   | 默认10%。                                  |
118| -t,--touch      | 设置屏幕随机touch测试比例。            | 否   | 默认10%。                                  |
119| -S,--swap       | 设置屏幕随机swap测试比例。             | 否   | 默认3%。                                   |
120| -m,--mouse      | 设置屏幕随机mouse测试比例。            | 否   | 默认1%。                                   |
121| -k,--keyboard   | 设置屏幕随机keyboard测试比例。         | 否   | 默认2%。                                   |
122| -H,--hardkey    | 设置随机hardkey测试比例。              | 否   | 默认2%。                                   |
123| -r,--rotate     | 设置随机rotate测试比例。               | 否   | 默认2%。                                   |
124| -C, --component | 设置随机控件测试比例。                 | 否   | 默认70%。                                  |
125| -I, --screenshot | 控件测试截图。                 | 否   | - |
126| -T,--time       | 设置测试总时间，与-c冲突。              | 否   | 单位分钟，默认10分钟。                      |
127| -U, -uri        |  设置应用拉起页面uri             | 否   | -   |
128| -x, -uriType        |  设置应用拉起页面uriType     | 否   | -   |
129
130> 说明：配置相同随机种子，会生成相同随机事件序列
131
132#### wukong exec 随机测试使用示例
133
134##### 1.wukong随机测试
135
136```bash
137> hdc_std shell
138# wukong exec -s 10 -i 1000 -a 0.28 -t 0.72 -c 100
139```
140
141随机测试示例解析：
142| 命令           | 参数值           | 说明                                           |
143| -------------- | -------------- | ---------------------------------------------- |
144| wukong exec |           | 主命令。                             |
145| -s     | 10           | 参数设置随机种子，10为种子值。            |
146| -i  | 1000           | 参数设置应用拉起间隔，1000单位ms。 |
147| -a  | 0.28          | 参数设置应用随机拉起测试比例28%。          |
148| -t  | 0.72           | 参数设置屏幕随机touch测试比例为72%。    |
149| -c  | 100           | 参数设置执行次数为100次。                |
150
151##### 2.wukong指定页面压测
152
153> 显示启动
154
155```bash
156> hdc_std shell
157# wukong exec -b bundlename -a abilityname -U uri
158```
159
160随机测试示例解析：
161| 命令            | 参数值         | 说明                                           |
162| --------------- | -------------- | ---------------------------------------------- |
163| wukong exec |      | 主命令。                             |
164| -b  | bundlename   | 参数设置指定bundlename            |
165| -a  | abilityname  | 参数设置指定abilityname          |
166| -U  | uri          | 参数设置应用拉起页面uri          |
167
168> 隐式启动
169
170```bash
171> hdc_std shell
172# wukong exec -b bundlename -U uri -x uriType
173```
174
175随机测试示例解析：
176| 命令            | 参数值         | 说明                                           |
177| --------------- | -------------- | ---------------------------------------------- |
178| wukong exec |      | 主命令。                             |
179| -b  | bundlename   | 参数设置指定bundlename            |
180| -U  | uri          | 参数设置应用拉起页面uri            |
181| -x  | uriType      | 参数设置应用拉起页面uriType          |
182
183##### 2.wukong允许ability页面、禁止ability页面
184
185```bash
186> hdc_std shell
187# wukong exec -b com.ohos.settings -e com.ohos.settings.MainAbility -E com.ohos.settings.AppInfoAbility
188```
189
190随机测试示例解析：
191| 命令           | 参数值           | 说明                                           |
192| -------------- | -------------- | ---------------------------------------------- |
193| wukong exec |           | 主命令。                             |
194| -b     | com.ohos.settings | 设置本次测试的允许应用名单            |
195| -e  | com.ohos.settings.MainAbility | 设置本次测试的允许ability页面 |
196| -E  | com.ohos.settings.AppInfoAbility | 设置本次测试的禁止ability页面          |
197
198> 说明：若配置-e、-E则必须配置-b参数来指定应用
199
200### wukong focus描述
201
202| 命令            | 功能                                 | 必选 | 备注                                     |
203| --------------- | ------------------------------------ | ---- | ---------------------------------------- |
204| -n,--numberfocus       | 设置每个控件注入的次数。               | 否   |                         |
205| -f, --focustypes       | 设置需要专注的控件类型。               | 否   | 以英文逗号隔开。                         |
206其余参数继承自exec。
207
208## 版本说明
209
2103.2.0.0 版本发布内容：预置wukong，支持以下功能：<br>
2111. 支持整机应用拉起、设置随机种子、设置应用拉起间隔、设置应用拉起次数、支持查询应用拉起bundle名和ability名。<br>
2122. 支持随机注入事件、支持随机注入控件、支持休眠唤醒专项测试、支持控件顺序遍历截图专项测试。<br>
2133. 支持wukong运行日志打印。<br>
2144. 支持应用白、黑名单。