通过使用appium-desktop录制脚本,编写app自动化脚本的过程中,会使用到一些AW,下面就这些AW的使用方法做详细的介绍。通过实践可以看到这几个AW可以完成测试工作。
AWOpenGivePage
1、功能描述
路由打开给定的页面
2、字段描述
字段名称 | 是否必须 | 字段类型 | 描述pageRouter |
pageRouter | 是 | String | 需要打开页面的pg或者js地址。框架中目前配置了一些页面的PG,录脚本时会自动填充,如果没有配置过,脚本录制后需要手动修改下脚本。或者联系我在框架中添加(需要提供页面的activity和PG) |
3、举例
|
AWAppiumDriver
1、功能描述
driver的初始化、关闭
2、字段描述
字段名称 | 是否必须 | 字段类型 | 描述 |
action | 是 | String | 动作 open:初始化driver close:关闭driver |
url | 是 | String | 请求appium-server地址;默认:http://127.0.0.1:4723/wd/hub |
allRecord | 否 | Boolean | 是否都是录制脚本,默认false;true时不再加载数据库中保存的控件元素(非录制脚本,控件元素是通过接口落地到数据库中,执行脚本时需要从数据库中读取出来) |
appActivity | 否 | String | 要启动app的首页activity,默认管家 |
appPackage | 否 | String | 要启动app的包名,默认管家 |
3、举例
|
AWAppiumRecordAction
1、功能描述
提供多种查找元素的方式,以及页面操作执行。该AW内容一般都是录制出来的,特殊点见字段描述
2、字段描述
字段名称 | 是否必须 | 字段类型 | 描述 |
elementInfoList
| 是 | List<List<String>> | 具体操作步骤:["美团外卖店主","click", "accessibility id","美团外卖店主"] 1、支持的操作click、sendKeys、tap、swipe、tapSendKey。 2、支持在上面的click/sendKeys操作前面加check,默认false。比如:checkclick:true、checkclick、checksendKeys:false。作用是在操作之前检查元素是否存在,true标示一次执行期间每次都检查,否则只检查一次。 3、1中支持的所有操作,除了tapSendKey,其它都是通过录制脚本录制。tapSendKey使用于有些页面输入框元素定位不到,只能通过定位坐标的方式进行输入。录制时可以先录制为tap操作,录制成功后(["坐标点击","tap", "","0.4361111111111111","0.2875"]),手动修改脚本,tap修改为tapSendKey,数组后面添加需要输入的内容(["坐标点击","tapSendKey", "","0.4361111111111111","0.2875","15267081011"]) 4、每种操作的操作步骤都可以在数组的最后面添加等待时间,默认10秒钟。比如:["美团外卖店主","click", "accessibility id","美团外卖店主","15"] 5、元素定位方式,脚本录制中主要使用id、accessibility id、xpath、h5classname,其中xpath有时候录制出来的是全路径,为了提高执行效率可以手动修改为相对路径;当录制页面是webView页面时,定位输入框使用h5classname方式,目的是兼容不同型号、不同系统的手机对该页面解析可能不一致的问题。除了上面提到的三种方式,常用还有classnames方式 6、classnames使用方式,场景:需要定位的元素存在多个,除了xpath以外,其它一样。录制完成后(["点击相册","click", "xpath","//android.widget.TextView[@text='相册']"])修改xpath修改为classnames,后面路径修改为classname:instance格式(android.widget.TextView:11) |
checkElementInfo
| 否 | List<List<String>> | 具体操作步骤:["是否有更新提示","click","xpath","//android.widget.TextView[@text='检查到测试包有更新,是否安装?']","5"], 1、检查该字段第一个元素是否存在,存在就执行该字段所有的操作步骤,否则不执行,继续执行elementInfoList中的操作步骤 2、功能与上个字段的check功能类似,两个可以相互切换。不同点是有多个步骤需要检查时使用check可以一个AW完成,使用checkElementInfo需要多个AW分开写。 |
3、举例
纯粹演示AW使用方法,内容步骤无意义
|
AWRecordAssert
1、功能描述
结果校验,支持校验元素是否存在、元素各个属性的值以及控件颜色等
2、字段描述
字段名称 | 是否必须 | 字段类型 | 描述 |
checkElementInfo | 是 | List<List<String>> | 需要检验的各元素["手动输入花呗账单","accessibility id", "3","手动输入花呗账单"] 1、元素定位方式除了AWAppiumRecordAction提到,还支持toast、toastLike方式。 2、每个校验项数组后面支持增加等待时间,默认10秒。 3、数组中第三个元素标示校验项,3标示检验元素存在。还支持元素其它属性值校验,替换掉3即可,比如:text、checkable、clickable等。需要注意除了3以外,填写其它校验项时需要在数组后面添加一个期望的值 4、支持颜色校验["手动输入花呗账单","accessibility id", "color","手动输入花呗账单","#FFFFF"],由于期望的颜色是十六进制颜色码,所以使用时,期望值可以先随便填写一个,运行脚本后查看日志打印的实际的十六进制颜色码是多少。再修改脚本。 |
checkExit | 否 | Boolean | 检验元素是否存在,默认true,检验元素存在,否则检验元素不存在 |
3、举例
|
AWKeyBoardAction
1、功能描述
纯粹键盘操作,不依赖元素。
2、字段描述
字段名称 | 是否必须 | 字段类型 | 描述 |
actionName | 否 | String | 操作名称 默认back,返回到上一级。 hideKeyboard 隐藏键盘 switchToNative 切换到native |
3、举例
|
AWSleep
1、功能描述
线程等待时间
2、字段描述
3、举例
|
AWHttpClient
1 功能描述
发送HTTP请求到服务端,并按照一定规则校验服务端返回的响应消息。
2 字段描述
字段名称 | 是否必须 | 字段类型 | 描述 |
---|---|---|---|
request | 是 | HttpClientRequest | Http request相关信息,具体请参见下表2.1 |
reponseExpected | 是 | HttpClientResponse | Http reponseExpected 相关信息,具体请参见下表2.2 |
config | 否 | MapComparedConfig | MapComparedConfig相关信息,具体请参见1.1.1 |
retryTime | 否 | int | 请求重试次数(不包含原请求),默认为0,如值为3,则表示最多请求4次 |
retrySecond | 否 | int | 重试的间隔时间,单位为秒,默认立即重试 |
retryStateCodeList | 否 | List<Integer> | 匹配的响应状态码集合,如[500, 501]表示如果响应状态码为500或501时则进行重试,不设置时根据reponseExpected的stateCode与实际响应状态码比对,不一致则进行重试 |
重试策略说明:
1.若响应返回为null则直接进行重试
2.如果未设置retryStateCodeList或retryStateCodeList为空集合,则判断reponseExpected.getStateCode()是否与实际的状态码是否一致,不一致则进行请求重试
3.如果retryStateCodeList不为空集合,则判断retryStateCodeList集合是否包含实际状态码,若包含则进行重试
2.1 HttpClientRequest
字段名称 | 是否必须 | 字段类型 | 描述 |
---|---|---|---|
type | 是 | String | 请求类型,1:GET 2:POST 3:PUT 4:DELETE 5:PATCH |
url | 是 | String | request链接地址,如:"url":"http://xxxxx/xxxx/api/v1/xxxx" 或者"url":"${global.data.gjj.addr}${global.gjj.url.newaccounts}", |
query | 否 | Map<String, String> | query map,URL问号后面的键值对 |
path | 否 | Map<String, String> | path map,URL中path部分的键值对 |
headers | 否 | Map<String, String> | 请求头 |
requestBody | 否 | Object | post/put请求的body,可以直接复制 swagger的请求 |
2.2 HttpClientResponse
字段名称 | 是否必须 | 字段类型 | 描述 |
---|---|---|---|
stateCode | 是 | String | 响应的状态码,如 "stateCode":"200" |
responseBody | 否 | Object | 响应的body,可以直接复制swagger返回的消息 |
headers | 否 | Map<String, String> | 响应头 |
3 举例
|
AWTemplateActuator
1、AW变为模版
正常编写完AW,在测试用例中作为一个步骤,格式如下:
举例:
|
1.1、增加下面两个参数
"awIsTemplate":true,
"templateName":"youname"
1.2、参数化
把变量参数化,比如上面的例子中,需要把mobile和password的值参数化
上面测试步骤变成的模版如下:
|
原有AW只要是继承了ActionWord类都支持该功能。
2、模版引用
使用框架中的 AWTemplateActuator引用模版。该AW唯一参数citationTemplates是一个对象的list。对象属性包括
templateName–引用的模版名称
templateParamValue–模版中参数值
assertTemplateName–校验结果的模版名称
举例:
比如引用上面的模版的使用方法如下:
|
当然如果你参数值是固定的,可以不用参数,模版引用中只需要不传递templateParamValue参数即可。
2.1、扩展
对于输入我们一般会做很多非法性校验,使用模版执行器只需要配置参数值即可,比如上面的例子:
|
3、模版路径
3.1、模版和非模版混合使用
一个用例文件中可以包含AW模版和非AW模版两种类型,但是对于模版记得使用AWTemplateActuator执行模版
3.2、模版路径方法
为了模版的重复使用,可以把模版放到一个文件夹里面,用例文件只负责使用AWTemplateActuator调用模版
3.2.1、新建模版文件夹
新建文件夹,把所有模版都放到该文件夹里面
3.2.2、增加配置
application.propertites中增加template.path:./xx/xx/xxx/xxx。
其它不变。
更多文章请关注公众号