使用pocoui进行airtest测试

一、pocoui安装

poco是网易自研的无需嵌入sdk。使用poco可以向appuim、selenium一样定位app上的元素对象位置。
poco安装有两种方式，第一种是直接网上搜索poco依赖包下载，然后使用python进行解压安装，这里不做介绍。另外一种是直接使用pip安装。
在命令行中使用指令：pip install pocoui进行安装。
等待安装完后使用pip list命令查看是否安装成功，如下，pip list指令下显示有pocoui了，版本是目前的最新版本。

二、pocoui的使用

poco的使用前还需要在手机上安装pocoserver，一般情况下在airtest连接手机的时候会自动安装pocoserver这个app，但是有些奇葩手机就没能安装，那么这个时候就要手动进行安装，可以使用手机助手安装，当然这里我使用的是adb shell指令安装的，使用adb指令：adb shell install apk路径。

1. 启用poco。在Poco辅助窗口下，点击展开下拉菜单，然后选择Android （如果是iOS就选iOS），此时会自动启动pocosdk了，在窗口下会显示app当前界面的所有元素对象的活动名字（activity），同时在代码区域中会自动导入红色框的两行代码。这两行代码如无特殊情况请不要删除。这两行代码的功能是导入AndroidUIautomationPoco并且实例化poco。实例化后的poco可供后面代码直接使用。
   

2. poco元素对象定位。在编写代码之前要先定好好元素对象的位置在辅助窗口的那个地方，下图箭头按钮是开启实时显示元素对象的结构位置，我们只需要在鼠标标移到都某个UI上面，左边的元素结构就会自动显示到该UI的结构位置处，能够快速定位到具体的UI结构位置。
   
   最右表的按钮是自动定位且记录功能按钮，也能够实时显示元素UI的位置，如果我们点击某UI时，就会自动在代码去生成对应的代码。不过不推荐此种方式，原因后面说明。
   
   同时也可以在手机中鼠标置于某UI上，然后右击可以选择定位该UI的元素对象位置。
   

3. 双击poco辅助窗下的具体元素，在代码中就会自动生成poco代码。我们只需要添加具体的操作即可。比如我们要定位到相册这个元素上，然后进行点击操作，所以可以这样操作。
   在log查看窗口中会显示我们选中的元素具体信息，我们主要关注的是name、enable、touchable这几个属性即可，name用来作poco定位，需要留意的一点是，要注意查看上下几个同级的元素的name是否相同，如果是相同的话，name就不可以用来定位，因为多个名字poco不知要找那个（可以理解为同班级有俩张三，点名时不知道是叫那个）。enable值一般要为true才可以，说明这个元素对象是可用的。touchable也要为true，说明这个ui是可以点击的，否则这个UI是不可以点击的。一般情况是点击、输入等操作的话要为true，如果用来作判定比较的则不要求是true。
   说明：以上这几点是poco的使用基础，熟悉并灵活使用poco定位对于用例的编写有很大的帮助。
   

三用例实例编写

这里使用poco定位，以企业微信作为例子编写一下实例作为用例例子。

1. 启动app
   启动app使用的方法是start_app()方法。该方法在airtest.core.api.py下的方法。方法的参数是包名，activity名。air的代码如下：
   
   airtest的源码如下所示：
   
   这里就仅简单列举一下启动app的操作，置于其他的操作，这里不做多说明。

四poco源码定义的操作

要使用poco的操作，首先要实例化poco对象。声明poco对象的方法是：
poco = AndroidUiautomationPoco(use_airtest_input=True, screenshot_each_action=False)
通过上面这句话，就实例化了poco对象。可以使用poco封装好了的操作了。poco的操作方法放在poco\pocofw.py里面。
当实例化了poco后，在poco后面添加“.”后，会弹出可以调用的操作，操作有数十种，主要有等待、获取\设置文本信息、点击（单击\双击\长按等）、截图、滑动等常规操作。

这里介绍poco对象的几个常用的操作方法：
poco().wait_for_any(self, objects, timeout=120):
等待超时之前显示给定的UI，最后返回第一个出现的UI。每个UI都会有一个特定的时间轮询。第一个参数objects是一个可以迭代的UI对象，第二个参数是超时阈值，数值是float类型，默认时间是120秒。
poco().wait_for_all(self, objects, timeout=120):
等待所有的UI显示，如果没有显示出来在超时。同时所有的UI都会有个定期进行轮询。第一个参数objects是一个可以迭代的UI对象，第二个参数是超时阈值，数值是float类型，默认时间是120秒。
poco().wait_stable（）
睡眠固定的秒数，以等待UI变得稳定（稳定）。无需手动调用此方法。需要时会自动调用它。
poco().click（）
在给定坐标下点击设备屏幕
poco().long_click(self, pos, duration=2.0)
但在给定的时间间隔内按屏幕，然后释放。第一个参数是坐标位置，第二个参数是长按的时间。
poco().scroll(self, direction=‘vertical’, percent=0.6, duration=2.0)
屏幕滚动，第一个参数滚动方向：水平\垂直，第二个参数是根据方向滚动距离占整个屏幕高度或宽度的百分比，第三个参数是执行操作的时间间隔。
poco().snapshot(self, width=720)
从目标设备获取屏幕截图。支持的输出格式（png，jpg等）取决于代理程序的实现。

airtest的其他常用api操作方法：
airtest的核心操作在core下的api.py下。api.py几乎封装了所有的操作，这里介绍下常用的操作方法。

这些操作都是api里面封装好了的，我们可以直接调用，要想调用一个函数，我们需要知道函数的名字与参数。如果参数传入的数量不对的话，那么会报TypeError的错误。
install(filepath, **kwargs):
安装app应用，第一个参数是app的路径名，**kwargs是可变参数，如无特殊情况，可以不需要。下面是install的使用例子：
install(filepath=‘xxx/xxx.apk’) # 安装应用
uninstall(package):
卸载app，参数是app的包名。例子：uninstall(‘包名’)
wake():
唤醒连接的手机。
home():
设置连接的手机返回home界面。
例子：

touch(v, times=1, **kwargs):
触摸设备屏幕，参数v是图片名字或者需要触摸屏幕的坐标，times参数是触摸次数，默认次数是1，**kwarges是平台特殊参数。return：返回被点击的位置。
例子：

double_click(v):
双击，参数v是图片名字或者需要触摸屏幕的坐标，最后返回点击的图片或者位置。

swipe(v1, v2=None, vector=None, **kwargs):
滑动，在设备上执行滑动操作。参数v1表示开始坐标或者图片，参数v2表示结束坐标或者结束的图片，参数vector表示矢量坐标，或者滑动坐标的百分比，比如（0.5,0.5)
例子：

pinch(in_or_out=‘in’, center=None, percent=0.5):
在屏幕上执行缩放操作，参数in_or_out表示要进行的是缩放还是放大，默认是in，表示缩放，out表示放大，只能枚举这两个值。center参数表示缩放的中心，默认是None，表示屏幕中心，如果是其他地方的话，则使用（x,y）来表示缩放的中心坐标。percent缩放操作的缩放比，默认是0.5,表示缩放一倍。
text(text, enter=True, **kwargs):
输入文本信息，注意，这个输入的UI必须是激活状态的，否则无法输入，例如网易靓号界面在有登录弹出的时候，后面的搜索输入框是非激活状态，所以是无法输入消息的。参数text表示输入的内容，参数enter表示回车键是否除非事件，默认是True。

sleep(secs=1.0):
睡眠，默认执行睡眠事件1s。
wait(v, timeout=None, interval=0.5, intervalfunc=None):
在设定时间内等等匹配目标图片，如果能匹配到目标图片，则返回目标坐标，如果等待超时，引发TargetNotFoundError错误。参数v表示目标图片，参数timeout表示超时时间，intarval表示每次匹配的时间间隔。intervalfunc 表示在每次未成功尝试找到相应匹配项后调用，默认是None。
exists(v):
检查屏幕上的目标是存在。参数v表示目标图片、文本。如果没有找到，则返回false，否则返回找到的坐标。
find_all(v):
检查屏幕上所有的目标。参数v表示目标图片，文本。结果返回一个所有的匹配结果坐标的列表。
assert_exists(v, msg=""):
断言目标存在。参数v表示断言的目标，msg表示说明信息，这个信息会记录到报告中。如果断言失败则会报AssertionError错误。如果断言成功，则返回目标坐标。
assert_not_exists(v, msg=""):
断言目标不存在。参数v表示断言目标，msg表示说明信息，这个信息会记录到报告中。如果断言失败则会报AssertionError错误。
assert_equal(first, second, msg=""):
断言两个值相等。first表示第一个值，second表示第二个值。msg表示说明信息，这个信息会记录到报告中。如果断言失败则会报AssertionError错误。返回值无。
assert_not_equal(first, second, msg=""):
断言两个值不相等。first表示第一个值，second表示第二个值。msg表示说明信息，这个信息会记录到报告中。如果断言失败则会报AssertionError错误。返回值无。
以上基本就是pocoui的常用的一些操作，当然，也可以通过浏览源码或者官方文档说明了解对应操作的具体原理。