HWAutoTool 自动化工具操作手机模拟器文档介绍 v1.x.x

HWAutoTool

自动化工具：源于AndroidDebugBridge 提供的命令接口操作模拟器与手机，每天重复做相同的事情，为了节省时间成本、提高工作效率，从而开发了此款工具。此工具支持用户自定义设计循环操作交互能力，开发初期会有不尽人意，但希望您给我们一次改过的机会，把您的宝贵建议告诉我们。

模块：我们将选择夹名称下所有列表功能集合称为模块。

方法：我们将选择夹名称下列表一行中相关信息集合成为方法。

下载地址：

https://bekz-my.sharepoint.com/:f:/g/personal/bishop_qllu_cn/EmQhPuBvAG1FubDArwGbahkB6kfjBD57Iy3GbrpbJtLc9Q?e=HNEKJg

模块窗口：

列表：

用来显示模块中每个图片相关的信息

1. img：模拟器或手机屏幕截取的图片、XML节点、找色。
   • 图片示例：581,1752,21,35_6A7E2D49_.bmp
   • 节点示例：
   • 找色示例：[R,G,B,X,Y,W,H] 根据设置颜色；指定坐标或区域查找，支持查找多个颜色点。
     • R：红色
     • G：绿色
     • B：蓝色
     • X：左边
     • Y：顶边
     • W：宽度；可以忽略；当没有设置宽度则指定X,Y位置取颜色比较
     • H：高度；可以忽略；当没有设置宽度则指定X,Y位置取颜色比较
2. count：页面出现次数触发什么动作。
   • 当动作设置包含【退出循环】；满足次数退出
   • 当动作设置包含【点击】；满足次数则点击
   • 当动作设置包含【首次点击】：满足次数点击1次后；不在点击
3. disable：禁止调用某个模块中一个图片、XML、找色方法
   • 设置格式为：[“主模块名称”,“子模块名称”,方法ID]
4. method：设置输入方法或调用子模块方法名称。
   • 设置格式为：[“主模块名称”,“子模块名称”] 或 [“主模块名称”,“输入模块名称”]
5. point：指定点击坐标、滑动坐标。
   • 当动作设置包含【点击】找到方法图片或节点或找色则点击指定位置。格式：[左,顶,宽,高,延时毫秒,点击次数]
     • 当勾选坐标偏移时；则按照找到的（图片或节点或找色）位置做偏移范围。
   • 当动作设置包含【滑动】找到方法图片或节点或找色则点击指定位置。
     • 当未勾选【坐标偏移】时；格式：[起点X,起点Y,终点X,终点Y,延时毫秒]
     • 当已勾选【坐标偏移】时；格式：[起点X,起点Y,终点X,终点Y,延时毫秒],[起点偏移X,起点偏移Y,终点偏移X,终点偏移Y,延时毫秒]
       当左=0 且 顶=0 时；按照找到（图片或节点或找色）的X,Y作为起点X,起点Y；
       当宽=0 且 高=0 时；按照找到（图片或节点或找色）的W,H作为终点X,终点Y；
6. content：对于方法描述信息。
7. rgbd：当方法【img】不同类型有不同的作用如下：
   • 当方法类型为图片：[红色,绿色,蓝色,相识度,找图左,找图顶,找图宽,找图高] 红色,绿色,蓝色,相识度值分别1-100范围。
     支持查找多个位置例如：[红色,绿色,蓝色,相识度,找图左,找图顶,找图宽,找图高,找图左,找图顶,找图宽,找图高]
     这代表找一个图片查找第一个区域找不到。就找第二个区域的。
   • 当方法类型为节点：待扩充功能。
   • 当方法类型为找色：待扩充功能。
8. type：对模块中的方法类型定义。
   • 图片类型为：1；节点类型为：2；找色类型为：8

动作设置：

以下动作都是基于找到（IMG、XML、RGB）方法时进行相对应功动作，支持多个动作。

1. 滑动：屏幕滑动坐标格式：x1 y1 x2 y2 sleep x1,y1：代表开始坐标 x2,y2：代表结束坐标 sleep：代表用时多少毫秒。
2. 点击：点击屏幕位置。
3. 首次点击：此参数针对进入某个页面后，限制（点击）只会在首次进行点击。
4. 退出线程：保留后期扩展功能使用，暂无具体功能。不建议勾选，目前与退出循环相同功能。
5. 退出循环：正在循环执行某模块，可以根据找到图片（img）符合条件退出循环。
6. 输入文本：当需要在屏幕输入文本内容时。可以右键菜单 > 输入模块方法 > 新建方法 >然后针对输入方法在窗口 >输入设置中设置相关信息。
7. 逐个删除：删除输入框内容，适用于包含中文或符号的输入框，以退格键的方式删除。
8. 选择删除：删除输入框内容，仅适用于字母或数字的输入框，以长按字符位置删除。
9. 每次删除：勾选后针对输入框是否每次进入页面都进行删除。
10. 找到退出：主要用于方法类型为图片和找色；多个位置查找时找到第一个位置继续查找。
11. 清除数据：APP清除数据。
12. 重启应用：重启APP。
13. 重启模拟器：符合则重启模拟器
14. 返回键：符合图片将按返回键。
15. 验证码：需要输入验证码识别。
16. 回调执行：触发此事件时指定调用模块。
17. 置剪贴板：当点击屏幕复制内容时需要剪切板内容时勾选会触发此事件接收内容。
18. 退回此页：用于一直按返回键直到找到你指定的页面。
19. 首次执行：当页面执行过一次模块方法后，下次找到此图将跳过此操作，仅在当前模块方法有效。
20. 坐标偏移：用于点击、和滑动动作坐标偏移详细见上面 【point】解释

输入模块设置：

输入框① 与 输入框②相同，下面介绍参考输入框①介绍，输入框①与输入框②可以理解为账号，和密码输入框。

• 输入框①区域：输入框坐标区域，当动作设置逐个删除将坐标设置输入框文本后面区域，当动作设置选择删除将坐标设置输入框左边第一个字符坐标区域。
• 输入框①清除：当输入框有清除内容按钮时，需要进行清除，可以设置坐标区域。
• 输入框①默认：设置输入框未输入时截图。用来判断是否进行删除内容。
• 验证码输入区域：填写验证码的输入框坐标区域。
• 验证码图片区域：显示验证码图片坐标区域。
• 登录按钮：登录、或提交按钮坐标区域。

菜单：

鼠标右键弹出窗口菜单。

• 显示图片窗：打开对模拟器屏幕截图操作。具体功能见（图片窗口）介绍。
• 显示主模块：打开软件默认主模块，当主模块包含子模块，需要操作子模块时进行切换。
• 输入模块列表：
  • 模块名称列表：选择将设置当前图片触发此输入功能，需要勾选（动作设置）中的输入文本。
  • 新建模块：创建输入模块相关信息。
  • 删除模块：删除输入模块相关信息。
  • 更新设置：当选中的图片行修改了（输入设置）时，点此可进行保存。
• 改方法属性：img、count、offset、method、point、content、rgbd ，具体介绍看上面 模块窗口 > 列表 已有介绍。
• 子模块列表：显示子模块列表名称，当选中列表行时选中列表名称则设置调用模块。
• 新建主模块：新建主（子）模块，根据当前所在模块进行相关操作。
• 删除主模块：删除主（子）模块。
• 改图文件名：默认存放图片文件夹名称（HWIMG），可自行修改。
• 改模块配置：格式为**[R,G,B,D,outTime,loopSleep,event,[“主模块名称”,“子模块名称”]]**
  • R：红色值（1-100）
  • G：绿色值（1-100）
  • B：蓝色值（1-100）
  • D：色差值（1-100）
  • outTime：模块查找多久未找到 触发调用超时模块或其他动作；单位毫秒。
  • loopSleep：模块循环一次等待时长；单位毫秒。
• 选中移动行：选中行后选择此项可以用来移动行位置。
• 移动到行前：选中行后选择此项执行移动操作。
• 移动到行后：选中行后选择此项执行移动操作。
• 复制行数据：可以将模块列表行复制到缓冲区。
• 粘贴行数据：将已复制到缓存区数据粘贴到指定模块下列表中。
• 删除行数据：删除列表选中行。
• 退出：关闭窗口。

图片窗口：

主要对模拟器或手机屏幕截图相关添加到模块中操作。

右键菜单：

• 模拟器列表：显示当前电脑下已安装模拟器类别，如雷电，雷神，夜游。
• 更新图片：当通过选择模拟器 > 打开了模拟器 > 需要更新模拟器或手机截图。
• 复制左上坐标：复制选择屏幕区域左上角坐标。
• 复制左下坐标：复制选择屏幕区域右下角坐标。
• 复制坐标区域：复制选择屏幕区域坐标。
• 定位截图位置：打开保存小图位置。
• 指定区域截图：指定坐标区域截图。
• 查找区域截图：根据小图名称查找屏幕所在位置。
• 设置查找色差：设置找图偏移色。
• 退出

反馈群：2016620742