poco節點關係大公開！

此文章來源於項目官方公衆號：“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