通过使用appium-desktop录制脚本，编写app自动化脚本的过程中，会使用到一些AW，下面就这些AW的使用方法做详细的介绍。通过实践可以看到这几个AW可以完成测试工作。
AWOpenGivePage
1、功能描述
路由打开给定的页面
2、字段描述
| 字段名称 |
是否必须 |
字段类型 |
描述 |
pageRouter |
是 |
String |
需要打开页面的pg或者js地址。框架中目前配置了一些页面的PG，录脚本时会自动填充，如果没有配置过，脚本录制后需要手动修改下脚本。或者联系我在框架中添加(需要提供页面的activity和PG) |
3、举例
{
"className": "AWOpenGivePage",
"remark": "打开指定页面",
"pageRouter": "https://xxxxx/xxxx/xxx/xxxx.weex.js"
}
{
"className": "AWOpenGivePage",
"remark": "打开指定页面",
"pageRouter": "en51cc://xxx/xxxx/xxxx"
} |
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、举例
{
"className": "AWAppiumDriver",
"url": "http://127.0.0.1:4723/wd/hub",
"action": "open",
"allRecord": "true",
"appActivity":"com.xxxx",
"appPackage":"com.xxxx"
} |
AWAppiumRecordAction
1、功能描述
提供多种查找元素的方式，以及页面操作执行。该AW内容一般都是录制出来的，特殊点见字段描述
2、字段描述
| 字段名称 |
是否必须 |
字段类型 |
描述 |
| elementInfoList
|
是 |
List |
具体操作步骤：["美团外卖店主","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 |
具体操作步骤：["是否有更新提示","click","xpath","//android.widget.TextView[@text='检查到测试包有更新，是否安装？']","5"], 1、检查该字段第一个元素是否存在，存在就执行该字段所有的操作步骤，否则不执行,继续执行elementInfoList中的操作步骤 2、功能与上个字段的check功能类似，两个可以相互切换。不同点是有多个步骤需要检查时使用check可以一个AW完成，使用checkElementInfo需要多个AW分开写。
|
3、举例
纯粹演示AW使用方法，内容步骤无意义
{
"className": "AWAppiumRecordAction",
"remark": "用户登录",
"checkElementInfo":[
["是否有更新提示","click","xpath","//android.widget.TextView[@text='检查到测试包有更新，是否安装？']","5"],
["点击下次更新","click","xpath","//android.widget.CheckBox[@text='不再提醒']","1"]
],
"elementInfoList":
["点击不再提示","checkclick:true","xpath","//android.widget.TextView[@text='下次再说']","1"],
["账号密码登录","click", "id","com.zhangdan.app:id/TextView_Go_UserName"],
["重试","checkclick", "accessibility id","重试"]
["11位手机号码","sendKeys", "id", "com.zhangdan.app:id/EditText_Passwd","${passwd}"],
["11位手机号码","sendKeys", "h5classname", "android.widget.EditText:1","${passwd}"]
["如果有密码键盘的情况，需要滑屏","swipe", "","0.47685185185185186","0.3758278145695364","0.48055555555555557","0.2052980132450331","5"],
["坐标点击","tapSendKey", "","0.3537037037037037","0.3859375","111111"]
["坐标点击","tap", "","0.4861111111111111","0.5083333333333333"]
["招行","click""classnames", "android.widget.TextView:11"]
]
} |
AWRecordAssert
1、功能描述
结果校验，支持校验元素是否存在、元素各个属性的值以及控件颜色等
2、字段描述
| 字段名称 |
是否必须 |
字段类型 |
描述 |
| checkElementInfo |
是 |
List |
需要检验的各元素["手动输入花呗账单","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、举例
{
"className":"AWRecordAssert",
"checkElementInfo":[
["", "id","3","com.ali.user.mobile.security.ui:id/viewContainers"]
["所有待还 (元)","id", "text","com.zhangdan.app:id/tv_line1","所有待还 (元)"],
["招行 网银37 1001","classnames", "text","android.widget.TextView:18","6666"]
["淘宝店主", "accessibility id","3","淘宝店主"]
["toast校验","toastLike", "3","请输入有效密码"]
["手动输入花呗账单","accessibility id", "color","手动输入花呗账单","#FFFFF"]
]
} |
AWKeyBoardAction
1、功能描述
纯粹键盘操作，不依赖元素。
2、字段描述
| 字段名称 |
是否必须 |
字段类型 |
描述 |
actionName |
否 |
String |
操作名称 默认back,返回到上一级。 hideKeyboard 隐藏键盘 switchToNative 切换到native |
3、举例
{
"className":"AWKeyBoardAction"
}
{
"className":"AWKeyBoardAction"，
"actionName":"hideKeyboard"
} |
AWSleep
1、功能描述
线程等待时间
2、字段描述
3、举例
{
"className": "AWSleep",
"seconds": "1"
} |
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 |
匹配的响应状态码集合，如[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 |
query map，URL问号后面的键值对 |
| path | 否 | Map |
path map，URL中path部分的键值对 |
| headers | 否 | Map |
请求头 |
requestBody |
否 | Object |
post/put请求的body，可以直接复制 swagger的请求 |
2.2 HttpClientResponse
| 字段名称 | 是否必须 | 字段类型 | 描述 |
|---|---|---|---|
stateCode |
是 | String | 响应的状态码，如 "stateCode":"200" |
responseBody |
否 | Object | 响应的body，可以直接复制swagger返回的消息 |
headers |
否 | Map |
响应头 |
3 举例
{
"remark": "调用address接口",
"className": "AWHttpClient",
"config": {
"primaryKeys": [
"orderNo"
],
"keyNameAndPrimarykeys": {
"items": [
"itemUrl"
]
}
},
"request": {
"type": 1,
"url": "${global.data.ecommerce.addr}/xxxx/api/v1/xxxx/{ecommerce_id}/xxxx/xxxx",
"path": {
"ecommerce_id": "${global.taobao.ecommerceid}"
},
"headers": {
"content-type": "application/json",
"userId": "${global.auth.userid}",
"Authorization": "${global.auth.token}"
}
},
"reponseExpected": {
"stateCode": "200",
"responseBody": [
{
"dealDate": "2017-04-17T13:16:36.000+08",
"orderNo": "3234925410420512",
"amount": 78.35,
"address": "中华人民共和国",
"consignee": "张三",
"phoneNumber": "1816",
"items": [
{
"itemUrl": "//trade.taobao.com/trade/detail/tradeSnap.htm?tradeID=3234925410430512",
"itemName": "十二生肖传说精装图画书海豚绘本花园适合3岁以上亲子阅读正版童书",
"price": 17.4,
"quantity": 1
}
]
}
]
} |
AWTemplateActuator
1、AW变为模版
正常编写完AW，在测试用例中作为一个步骤，格式如下：
举例：
{
"className": "AWAppiumRecordAction",
"remark": "",
"mobile":"15210001001",
"password":"qazxsw"
} |
1.1、增加下面两个参数
"awIsTemplate":true,
"templateName":"youname"
1.2、参数化
把变量参数化，比如上面的例子中，需要把mobile和password的值参数化
上面测试步骤变成的模版如下：
{
"className": "AWAppiumRecordAction",
"remark": "",
"awIsTemplate":true,
"mobile":"${mobile}",
"password":"${password}"
"templateName":"loginTemplate"
} |
原有AW只要是继承了ActionWord类都支持该功能。
2、模版引用
使用框架中的 AWTemplateActuator引用模版。该AW唯一参数citationTemplates是一个对象的list。对象属性包括
templateName–引用的模版名称
templateParamValue–模版中参数值
assertTemplateName–校验结果的模版名称
举例：
比如引用上面的模版的使用方法如下：
{
"className": "AWTemplateActuator",
"citationTemplates": [
{
"templateName": "loginTemplate",
"templateParamValue": {
"mobile": "15267",
"password": "2222"
},
"assertTemplateName": "loginSuccess"----这是把校验结果作为一个模版
}
]
} |
当然如果你参数值是固定的，可以不用参数，模版引用中只需要不传递templateParamValue参数即可。
2.1、扩展
对于输入我们一般会做很多非法性校验，使用模版执行器只需要配置参数值即可，比如上面的例子：
{
"className": "AWTemplateActuator",
"citationTemplates": [
{
"templateName": "loginTemplate",
"templateParamValue": {
"mobile": "15267",--手机号位数不够"password": "2222"
},
"assertTemplateName": "loginSuccess"----这是把校验结果作为一个模版
},
{
"templateName": "loginTemplate",
"templateParamValue": {
"mobile": "152671111111111",---手机号过长"password": "x@#@"
},
"assertTemplateName": "loginSuccess"----这是把校验结果作为一个模版
}
]
} |
3、模版路径
3.1、模版和非模版混合使用
一个用例文件中可以包含AW模版和非AW模版两种类型，但是对于模版记得使用AWTemplateActuator执行模版
3.2、模版路径方法
为了模版的重复使用，可以把模版放到一个文件夹里面，用例文件只负责使用AWTemplateActuator调用模版
3.2.1、新建模版文件夹
新建文件夹，把所有模版都放到该文件夹里面
3.2.2、增加配置
application.propertites中增加template.path：./xx/xx/xxx/xxx。
其它不变。