游戏自动化工具操作手册

1 概述

华为标注工具通过场景和控件标记，提供基于图形比对的UI自动化能力，可支持游戏自动化测试。

工具	华为标注工具
自动化框架	华为自研
自动化方式	基于图片识别的UI测试
自动化语言	Python
准确性	高
支持平台	Android<br/>HormonyOS Next

2 环境部署

2.1 部署Windows执行机环境

1、 安装Python3.10，配置环境变量

2、 在window机器上，下载附件init-env-agent.sh脚本并执行，支持一键部署HyPium及GAFrame需要的python依赖

2.2 部署工具Server端

在Linux机器上，下载附件init-env-server.sh脚本并执行，支持一键部署

2.3 导入工程，完成IDE配置

1、 下载附件labelDemo工程样例

2、 启动PyCharm IDE，打开labelDemo工程，配置Python解释器

3、 修改启动参数

3 用例编写与执行

3.1 标注场景和控件

用于定义需要操作和校验的控件和场景

3.1.1 标注工具下载

下载附件Widget_label_39.tar.gz

3.1.2 工具设置

双击下图脚本，启动标注工具

完成工具设置

3.1.3 新建场景

a. 点击右侧新建场景，定义场景名称

b. 手机界面进入需要操作或校验的场景，点击抓取

3.1.4 新建控件

控件字段说明：

a. 控件类型：定义脚本需要操作和识别游戏元素，包括按钮（支持点击、拖动操作）、描述（仅展示）等等。

说明：场景下不能只有一个描述控件

b. 后继场景：定义该控件执行完后继续执行的场景。

可以多选，多选时，同时检测选中场景，如有匹配的，执行匹配场景，此场景结束；如未匹配，一直等待，直到后继场景出现或者用例超时失败。

c. 稳定场景：一般选是。

d. 定位方式：直接定位、伙伴定位（借助其他控件定位）

e. 辅助控件：选中伙伴定位时，需要根据辅助控件进行定位

f. 子控件：适用于地图控件，用于标记朝向

a) 导出文件并更新工程

文件-》导出。导出custom文件夹并替换base_env工程下的同名文件夹

3.2 用例编写

在用例中，定义每个场景需要操作或校验的步骤。参考样例：

步骤说明：

1、 定义需要拉起的包名

2、 定义开始测试的场景

3、 定义操作步骤和检查点

3.3 用例执行

在测试套定义需执行的用例范围，并在IDE中执行测试套

3.4 测试报告查看

报告位置：工程目录/reports