poco脚本编写

Posted 2021-02-07 xuanjian-91

连接设备后使用poco
　　使用connect_device连接好指定设备后，会返回一个Device对象，将这个对象传入 androidUiautomationPoco第一个参数里进行poco的初始化，
　　接下来使用此poco 实例将会获取所指定的设备的UI和对其进行操作。

　　

　　from airtest.core.api import connect_device
　　from poco.drivers.android.uiautomation import AndroidUiautomationPoco

　　dev = connect_device(‘Android://<adbhost[localhost]>:<adbport[5037]>/<serialno>‘)
　　poco = AndroidUiautomationPoco(dev)

Andorid注意事项
　　版本越高越好
　　　　需要Android SDK API version ≥ 19，即Android 4.4及以上，越高版本兼容性越好。
　　使用poco
　　　　在Android原生应用上使用poco不需要配置任何依赖，只需手机处于usb调试模式即可（部分手机需要连同usb安装、usb模拟点击等权限一起打开，均位于开发者选项里）。
　　　　在初始化poco 实例时，会自动向手机里安装PocoService.apk，如果此时弹出安装提示，请点击同意，否则poco无法使用，一共会安装两个app进去。

　　　　什么时候初始化poco
　　　　　　1、ide中选择android的模式
　　　　　　2、代码中创建poco对象

 

脚本编写

　调用文件外部方法

　　如果想要在一个.air脚本中，调用另外一个.air脚本里封装的公用函数，可以这样做:

　　from airtest.core.api import using
　　using("common.air")

　　from common import common_function
　　common_function()

 

元素定位
　　text模糊匹配
　　　　poco(name=‘com.zhihu.android:id/magi_title‘, textMatches=‘^古剑奇谭三.*$‘).click()

api
　　点击(click)
　　　　点击默认点在 锚点上（一般就是正中央的点）
　　　　poco(‘bg_mission‘).click()
　　　　poco(‘bg_mission‘).click(‘center‘)
　　　　poco(‘bg_mission‘).click([0.5, 0.5]) # equivalent to center
　　　　poco(‘bg_mission‘).focus([0.5, 0.5]).click() # equivalent to above expression

　　滑动(swipe)
　　　　swipe操作同样是以 anchorPoint 为起点，如果你想改变起点请使用下面的 focus 方法，然后朝给定向量所代表的方向滑动，距离也就是向量的长度
　　　　joystick = poco(‘movetouch_panel‘).child(‘point_img‘)
　　　　joystick.swipe(‘up‘)
　　　　joystick.swipe([0.2, -0.2]) # swipe sqrt(0.08) unit distance at 45 degree angle up-and-right
　　　　joystick.swipe([0.2, -0.2], duration=0.5)

　　拖拽(drag)
　　　　与 swipe 不同的是， darg 是从一个UI拖到另一个UI，而 swipe 是将一个UI朝某个方向拖动
　　　　poco(text=‘突破芯片‘).drag_to(poco(text=‘岩石司康饼‘))

　　等待出现(wait)
　　　　一段时间内查找元素。超时则报错
　　　　poco(‘bg_mission‘).wait(5).click() # wait 5 seconds at most，click once the object appears
　　　　poco(‘bg_mission‘).wait(5).exists() # wait 5 seconds at most，return Exists or Not Exists

局部定位(focus (local positioning))，归一化坐标系
　　锚点在盒子上的哪个位置，

　　锚点就是操作的起点
　　　　所有UI相关的操作都默认以UI的 anchorPoint 为起点，

　　自定义锚点

　　　　如果想自定义起点那么可以使用 focus方法。

　　　　focus 所使用的是局部坐标系，UI包围盒的左上角为原点，x轴向右，y轴向下，并且包围盒长宽均为单位1。很显然中心点就是 [0.5, 0.5] 。
　　　　poco(‘bg_mission‘).focus(‘center‘).click() # click the center
　　　　将 focus 和 drag_to 结合使用还能产生卷动(scroll)的效果，下面例子展示了如何将一个列表向上卷动半页。
　　　　scrollView = poco(type=‘ScollView‘)
　　　　scrollView.focus([0.5, 0.8]).drag_to(scrollView.focus([0.5, 0.2]))

全局操作(Global Operation)
　　在没有选定或指定UI的情况下也可以进行操作(模拟输入)，也叫全局操作。
　　点击(click)
　　　　poco.click([0.5, 0.5]) # click the center of screen
　　　　poco.long_click([0.5, 0.5], duration=3)
　　滑动(swipe)
　　　　# swipe from A to B
　　　　point_a = [0.1, 0.1]
　　　　center = [0.5, 0.5]
　　　　poco.swipe(point_a, center)

　　　　# swipe from A by given direction
　　　　direction = [0.1, 0]
　　　　poco.swipe(point_a, direction=direction)
　　截屏(snapshot)

　　install("path/to/your/apk")
　　start_app("package_name_of_your_apk")
　　uninstall("package_name_of_your_apk")

 

读取元素
　　mission_btn = poco(‘bg_mission‘)
　　print(mission_btn.attr(‘type‘)) # ‘Button‘
　　print(mission_btn.get_text()) # ‘据点支援‘
　　print(mission_btn.attr(‘text‘)) # ‘据点支援‘ equivalent to .get_text()
　　print(mission_btn.exists()) # True/False, exists in the screen or not

 

写脚本技巧
　　title_obj_list = poco(name=‘com.zhihu.android:id/magi_title‘)
　　title_list = [title.get_text() for title in title_obj_list]

　　discuss_obj_list = poco(name=‘com.zhihu.android:id/magi_count‘)
　　discuss_list = [discuss.get_text() for discuss in discuss_obj_list]

　　for title, discuss in zip(title_list, discuss_list):
　　print(title, discuss)