通过使用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<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使用方法，内容步骤无意义

{
        "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<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、举例

     {
        "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<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 举例

{
      "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。

其它不变。

更多文章请关注公众号

posted on 2019-10-14 19:31 测试步行人阅读(1431) 评论(0) 收藏举报

刷新页面返回顶部

测试步行人

公告

AWOpenGivePage

1、功能描述

2、字段描述

3、举例

AWAppiumDriver

1、功能描述

2、字段描述

3、举例

AWAppiumRecordAction

1、功能描述

2、字段描述

3、举例

AWRecordAssert

1、功能描述

2、字段描述

AWKeyBoardAction

1、功能描述

2、字段描述

3、举例

AWSleep

1、功能描述

2、字段描述

3、举例

AWHttpClient

AWTemplateActuator

1、AW变为模版

1.1、增加下面两个参数

1.2、参数化

2、模版引用

2.1、扩展

3、模版路径

3.1、模版和非模版混合使用

3.2、模版路径方法

3.2.1、新建模版文件夹

3.2.2、增加配置