poco节点关系大公开！

2024-04-18 10:55 由 AirtestProject 发表于 #其他

此文章来源于项目官方公众号：“AirtestProject”
版权声明：允许转载，但转载必须保留原链接；请勿用作商业或者非法用途

一、前言

在自动化测试的实践中，我们发现许多同学在使用Poco框架进行控件定位时，对于节点之间的关系理解不够深入。那么本周让我们来详细讲解Poco框架中的child&children、offspring、sibling和parent等节点关系定位方法。

二、Poco定位节点的关系分析

2.1 child&children

从字面上看，可以很明显知道child与children表示的就是获取该节点下的子节点。如果是需要获取多个子节点，需要通过for去循环提取，不通过循环获取的话，默认都是提取第一个节点，但顺序编号从0开始。

其中child可以携带参数，可以获取指定的子节点，如：

poco("android.widget.FrameLayout").child("android.widget.LinearLayout")

但children是不能携带参数的，是可以直接获取所有的子节点，但可以根据返回的子节点顺序进行指定，默认返回的是提取的第一个节点（顺序编号从0开始）如：

poco("android.widget.FrameLayout").children()[2]

2.2 offspring

offspring是获取该节点的子孙节点，若需要输出多个子孙节点，使用for循环去进行输出，默认输出为首个子孙节点。在使用过程中，如果不清楚自己所需节点的编号为多少，我们可以选择用for输出后，按照顺序编号进行选择使用。

poco("com.netease.cloudmusic:id/bannerContainer").offspring()

可以根据输出的顺序，结合下图，其中下述语句表达为“每日推荐”控件:

poco("com.netease.cloudmusic:id/portal_rv").offspring()[10]

也可以在offspring括号内指定自己所需要的子孙节点，如：

poco("com.netease.cloudmusic:id/portal_rv").offspring("com.netease.cloudmusic:id/portalTitle")

上述语句同样表示为“每日推荐”控件。这样有个好处就是，当有多个相同name的控件但存在不同name的上层节点时，可以很好的区分每个控件。

2.3 sibling

siblings表示获取当前节点的兄弟节点，即与当前节点处于同一层级的其他节点。若需要输出多个兄弟节点，使用for循环进行输出，默认输出为首个兄弟节点。

poco("com.netease.cloudmusic:id/biFl").sibling()

如下图，可以看到该节点下返回的兄弟节点与UI树相匹配：

同样，sibling也是可以根据循环获取输出的顺序进行指定的，如：

poco("com.netease.cloudmusic:id/biFl").sibling()[3]

2.4 parent

在poco中，parent表示获取当前节点的父节点。如果需要获取整个节点集合的父节点，需要找到节点集合的第一个节点。如果需要获取多层父节点，可以通过.parent()方法进行逐级获取。

例如，对于一个节点A，它的父节点是B，B的父节点是C，那么可以通过A.parent().parent()来获取到节点C。

poco("com.android.systemui:id/status_bar_contents").parent()

综上所述，如果需要获取该界面的所有节点，可以通过.parent() 或 .children() 等方法互相结合来获取其他层级中的所有节点，然后再通过遍历筛选出除了当前节点外的其他节点。
在开源群内，有一些同学也问过如何统计UI树某层或某控件的个数，我们可以通过上述的节点关系，结合python已有的len()函数，或使用for循环累加的方式去获取的。如：

#【利用子孙节点关系定位元素】统计输出热歌榜当前界面中歌曲数量
num=len(poco("com.netease.cloudmusic:id/musicInfoList").offspring(nameMatches="com.*?songName"))    
print("当前界面有{}首歌".format(num))

#【利用子节点关系定位元素】统计输出当前界面的热门节目单数量
num=0
for x in poco("CollectionView").child("UIA.Podcasts.ShelfItem.show"):
    print(x.child().child().get_name())
    num+=1

三、Android上的案例

了解完Poco节点关系的具体用法后，我们可以尝试在日常跑测中使用上节点关系，让我们来看一下在Android上的一个使用案例吧。

参考代码如下：

可以看到，我们通过节点关系可以获取到它的父节点、兄弟节点、子孙节点等，并可以对其进行点击、统计、输出信息等操作。

# -*- encoding=utf8 -*-
__author__ = "Airtest"

from airtest.core.api import *

auto_setup(__file__)

from poco.drivers.android.uiautomation import AndroidUiautomationPoco
poco = AndroidUiautomationPoco(use_airtest_input=True, screenshot_each_action=False)

#打开网易云音乐
start_app("com.netease.cloudmusic")
sleep(7.0)

#【利用子孙节点关系寻找元素】通过输出子孙节点去查找“发现”按钮
for i in poco("com.netease.cloudmusic:id/bottomNav").offspring(nameMatches="com.*?desc"):
    print(i.get_text())

#【利用子孙节点关系以及空间顺序定位元素】点击"发现"按钮
poco("com.netease.cloudmusic:id/bottomNav").offspring(nameMatches="com.*?desc")[1].click()
sleep(1.0)

#【通过兄弟节点关系定位元素】点击发现页中“精选”旁边的“排行榜”按键
poco("精选").sibling()[1].click()
sleep(1.0)

#点击热歌榜
poco(text="热歌榜").click()

#【利用子孙节点关系寻找元素】输出热歌榜中每首歌的名字
print("当前界面的热歌榜歌曲有：")
for i in poco("com.netease.cloudmusic:id/musicInfoList").offspring(nameMatches="com.*?songName"):
    print(i.get_text())
    
#【利用子孙节点关系定位元素】统计输出热歌榜当前界面中歌曲数量
num=len(poco("com.netease.cloudmusic:id/musicInfoList").offspring(nameMatches="com.*?songName"))    
print("当前界面有{}首歌".format(num))
    
#【利用子节点关系定位元素】输出目前播放器在播放的歌曲名
print("下方为正在播放的歌曲：")    
now_song = poco("com.netease.cloudmusic:id/minibar_song_container").child().children()   
print(now_song.get_text())

四、iOS上的案例

日常使用中可以发现，在iOS上获取对应的UI树控件比较困难，但是可以通过Poco节点关系的方法，更大程度地去寻找到自己想要获取的控件或ui树节点。

参考代码如下：

# -*- encoding=utf8 -*-
__author__ = "Airtest"

from airtest.core.api import *

auto_setup(__file__)
from poco.drivers.ios import iosPoco
poco = iosPoco()

#打开播客app
poco("播客").click()

#【利用子节点关系定位元素】输出该界面的信息，点击选择查看热门节目
for i in poco("CollectionView").child():
    print(i.get_name())

#【利用子节点关系结合子孙节点关系定位元素】点击进入热门节目界面 
poco("CollectionView").child("热门节目").offspring("查看全部").click()

#【利用子节点关系定位元素】输出当前界面的热门节目单
num=0
print("当前热门节目单有：")
for x in poco("CollectionView").child("UIA.Podcasts.ShelfItem.show"):
    print(x.child().child().get_name())
    num+=1

#【通过循环累计获取节点个数】输出当前界面的热门节目数量
print("当前界面有{}个节目".format(num))   

#【利用父节点关系结合子节点关系定位元素】点击播放键进入播放界面
poco("MiniPlayerArtworkVisible").parent().child()[2].child()[0].click()

#【利用兄弟节点关系定位元素】点击播放键进行播放
poco("倒回，15秒钟").sibling()[1].click()

五、小结

本周我们介绍了Poco节点关系：

1、child&children 获取子节点

2、offspring 获取子孙节点

3、sibling 获取兄弟节点

4、parent 获取父节点

通过深入理解child&children、offspring、sibling和parent这些节点关系，我们能够更加精确和高效地定位到UI树中的各个节点。

如果同学们在使用Poco进行自动化测试的过程中，遇到了问题，或者有任何想要深入了解的知识点，欢迎在群里告诉我们或者提交issue，也欢迎大家投稿。后续我们会带来更多精彩的有关Poco专题内容，请大家持续关注我们，敬请期待哦！

AirtestIDE下载：airtest.netease.com/
Airtest 教程官网：airtest.doc.io.netease.com/
搭建企业私有云服务：airlab.163.com/b2b

官方答疑 Q 群：526033840