OpenHarmony开发者论坛
标题:
游戏自动化工具操作手册
[打印本页]
作者:
carol445
时间:
2025-3-5 15:05
标题:
游戏自动化工具操作手册
[md]# 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
[/md]
欢迎光临 OpenHarmony开发者论坛 (https://forums.openharmony.cn/)
Powered by Discuz! X3.5