【airtest】自动化入门教程Poco元素定位

1. 前言

本文将详细讲解Poco控件定位的各种方式，利用这些方法可以帮助我们编写出目标控件的定位脚本。我们在IDE录制的poco脚本，常见的都是类似 poco(“star_single”).click()这样的脚本，其中 poco(“star_single”) 这块就属于Poco控件定位脚本啦。

2. 三种定位选择器

Poco控件最基本的3种定位选择器分别是：

基本选择器
相对选择器
空间顺序选择器

1）基本选择器

在poco实例后加一对括号，我们就可以进行元素选择了。选择器会遍历所有元素，将满足给定条件的元素都选出来并返回。

括号里的参数就是所给定的条件，用属性名值对表示，其中第一个参数表示 节点名 ，就像 poco("star_single") 。后面还可以跟着一些可选参数，均表示 节点的属性及预期的属性值 ：

from poco.drivers.unity3d import UnityPoco
poco = UnityPoco()

poco("star_single",type="Image")

通过属性组合

如果元素属性不能唯一定位，可通过组合属性方式

poco(name = 'NodeName',type = '类型名比如Button')

2）相对选择器

如果直接用节点属性（或者说仅仅使用基本选择器）没法选出你所想要的元素时，你还可以通过元素之间的渲染层级关系进行选择，例如父子关系(child)、兄弟关系(sibling)、祖先后代关系(offspring)等等：
如：

poco("plays").child("playBasic").offspring("star_single")

poco('父节点').child('子节点')  # 默认取第一个，也可以通过下标，我使用过-1，-2,1 ，2 等下标

孙节点offspring，当根据child().child()定位时，如果第二个child是前面一个的孙节点，不能定位到，要用offspring，child节点必须是上个节点的儿子节点，不能跨辈分

poco('父节点').child('子节点').offspring('孙节点')

兄弟节点sibling
兄弟可能是多个，可通过下标方式

poco('name').sibling()

父节点parent
获取当前节点的父节点

poco('name').parent()
poco(text="春天的菠菜").parent().parent()

直到某个元素出现

poco('属性').wait_for_appearance(timeout=3)  # wait until appearance within 3s

直到某个元素消失

元素.wait_for_disappearance()

获取元素属性

#获取当前元素 pos属性的值
#a = poco(name="com.yunmall.lc:id/textView5").parent().attr('pos')
​
#获取当前元素的名字 get_name()
#a = poco(name="com.yunmall.lc:id/textView5").parent().get_name()
​
#获取当前元素的文本信息 其实获取的是text属性的值
# poco(name="com.yunmall.lc:id/textView5").parent().get_text()

设置元素属性

#选取元素 输入内容为123 其实也是设置text属性的值
poco("pos_input").set_text("123")
​
#设置text属性的值为456
poco("pos_input").setattr('text',"456")

.判断控件是否存在，并进行操作

print(obj.exists())
#判断密码框元素是否可见，可见则输入内容在输入内容
password_input = poco(name='com.yunmall.lc:id/logon_password_textview')

if password_input.exists():
    poco(name='com.yunmall.lc:id/logon_password_textview').set_text("123456")

点击和长按

#点击 按钮
poco('NodeName').click()
#长按 按钮
poco('NodeName').long_click()
#长按按钮 指定时间 单位为s
poco('NodeName').long_click(duration=5)

3）空间顺序选择器

按照序号(顺序)进行选择总是按照空间排布顺序，先从左往右，再像之前那样一行一行从上到下。如下图所示，我们利用选择器选中了很多个 type=“Text” 的元素，然后再利用索引顺序逐个选中单个元素：

name0 = poco("Content").child(type="Text")[0].get_name()
name1 = poco("Content").child(type="Text")[1].get_name()
name2 = poco("Content").child(type="Text")[2].get_name()

print(name0+" "+name1+" "+name2)

索引选择有个特例，一旦进行选择后，如果元素的位置发生了变化，那么下标序号仍然是按照选择的那一瞬间所确定的值。即，如果选择时①号元素现在去到了③号的位置，那么还是要用 poco(…)[0] 来访问，而不是 poco(…)[2] 。

如果选择了之后，某个元素消失了(从界面中移除或者隐藏了)，那么如果再访问那个元素则可能会发生异常，其余的元素仍可继续访问。

3. 利用正则表达式匹配控件

其实除了上述3种常规一点的定位方式之外，还有一种同学们比较少见，但是非常好用的定位方式，那就是 用正则表达式来匹配控件 ，如下述示例这样：

arb_close_btn = poco(textMatches='^close.*$')
poco(textMatches='^春天的菠菜.')   #表达式根据自己需要写
poco(textMatches=".*停止.*").click()

如果有些信息的控件名都是一样的，所以只要我们写1个正则表达式，匹配到这一批相同的控件名，就相当于定位到了当前页面所有的歌曲信息控件，就可以利用poco遍历，逐一获取控件的text属性了：

for i in poco(nameMatches="com.*?songInfo"):
    print(i.get_text())

除了最常见的 textMatches 、 nameMatches 和 typeMatches ，其实大部分的属性都可以用这种方式来传递正则表达式，只要能够用 poco(xx=预期属性值) 来选择的控件，就可以用 poco(xxMatches=预期属性值的正则表达式) 来进行匹配定位。

4. 其他较适用的检测元素方法

除了上述关于元素定位 的问题，还有比如:有哪些属性可以拿来定位元素？利用节点属性无法定位元素时应该怎么处理？为什么明明存在的节点还会报找不到？…
所以我们特意整理了这篇文章，向大家详细讲述几种poco元素定位的方式，希望能方便大家在实际项目中灵活运用。

借助IDE的poco辅助窗生成元素定位脚本

AirtestIDE的 poco辅助窗 给我们提供了很多种方式来生成元素定位的脚本。最简单的方法是，点击poco辅助窗里面的 录制按钮 ，然后再点击下目标元素：

这样脚本编辑窗就会自动生成一条点击控件的脚本，除去脚本中点击操作的代码，剩下的 poco("star_single") ，就是定位到黄色星星图片元素的代码了。
当然，我们还可以使用录制按钮旁边的俩个 检视器 按钮来帮助我们定位元素。这两个检视器按钮的区别在于，是否锁定当前页面：

我们可以看到，随着检视器定位到某个元素，辅助窗里面的UI树也会随着定位到相应的元素上，这时我们可以 双击 UI树对应的位置，即可在脚本编辑窗自动生成定位元素的脚本。

补充：

poco的坐标系
左上角(0,0)，右下角(1,1)，横坐标为x，纵坐标为y,点击节点的某个位置

#点击节点的中心点位置
poco(name='com.yunmall.lc:id/logon_password_textview').focus('center').click()
#点击节点的靠近左上角位置
poco(name='com.yunmall.lc:id/logon_password_textview').focus([0.1, 0.1]).long_click()
#点击节点的右下角位置
poco(name='com.yunmall.lc:id/logon_password_textview').focus([1, 1]).long_click()

拖拽和滑动
a.拖拽：从一个节点位置拖拽到另一个节点位置

poco('AeNodeName').drag_to(poco('BeNodeName'))

从列表的一端滑动到另一端

listView = poco('Scroll View')
listView.focus([0.5, 0.7]).drag_to(listView.focus([0.5, 0.2]))

b.滑动：滑动列表

poco('Scroll View').swipe([0, -0.1])
poco('Scroll View').swipe('up')

从A点滑动到B点

x, y = poco('Scroll View').get_position()
end = [x, y - 0.1]
poco.swipe([x, y], end)

从A点向指定方向和定长移动

x, y = poco('Scroll View').get_position()
dir = [0, -0.1]
poco.swipe([x, y], direction=dir)