poco脚本编写之api

2019/02/02 17:22
阅读数 667

连接设备后使用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()

 

元素定位

  使用Poco选择UI对象

    属性选择器
      选出所有满足给定条件的UI
      括号里的参数就是所给定的条件,用属性名值对表示
      其中第一个参数固定表示 节点名
      其余可选参数均表示节点的属性及预期的属性值。
      poco('bg_mission')
      poco('bg_mission', type='Button')
      poco(textMatches='^据点.*$', type='Button', enable=True)

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

    相对选择器
      直接用节点属性没法选出你所想要的UI时,还可以通过UI之间的渲染层级关系进行选择,例如父子关系、兄弟关系、祖先后代关系。
      poco('main_node').child('list_item').offspring('item')


 
    

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

 

  拖拽(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)

     方法1:
    # swipe from A to B
    point_a = [0.1, 0.1]
    center = [0.5, 0.5]
    poco.swipe(point_a, center)//推荐

             方法2:

    # swipe from A by given direction
    direction = [0.1, 0]//向量
    poco.swipe(point_a, direction=direction)

    方法3:

    scrollView = items[0]
    scrollView.focus([0.5, 0.9]).drag_to(scrollView.focus([0.5, 0.2]))

             方法4:
    //操作元素滑动,操作元素就有锚点,锚点就是操作起点,如果你想改变起点请使用下面的 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)


  截屏(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)

展开阅读全文
加载中

作者的其它热门文章

打赏
0
0 收藏
分享
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部