AirtestProject是由網易游戲推出的一款跨平台的UI自動化測試框架，主要是面向游戲的UI自動化測試，比如Unity3D、cocos2dx-*游戲框架，也支持Android原生app、iOS app、微信小程序的UI測試。本文主要介紹如何使用AirtestProject進行Android APP自動化測試。
目錄
AirtestProject組件
AirtestProject包括一下組件：
- Airtest：基於圖像識別的自動化測試框架，適用於游戲和App，圖像識別主要使用opencv庫。項目地址：https://github.com/AirtestProject/Airtest
- Poco：基於UI元素識別的測試框架，支持Unity3D/cocos2dx-*/Android原生app/iOS原生app/微信小程序。項目github地址：https://github.com/AirtestProject/Poco
- AirtestIDE：圖形界面，內置了Airtest和Poco的相關插件。官網地址：http://airtest.netease.com/
- AirLab：真機自動化雲測試平台。
下面介紹如何使用Airtest和Poco進行自動化測試。
下載安裝
先安裝一下AirtestIDE，主要用於截圖、UI 元素查看以及腳本調試，下載地址：http://airtest.netease.com/
Python安裝：
pip install -U airtest # airtest測試框架
pip install pocoui # poco測試框架
Airtest使用
安裝卸載apk
install("path/to/your/apk") # 安裝APK
uninstall("package_name_of_your_apk") # 卸載APK
連接設備
init_device(platform="Android",uuid="SNHVB20C18002195") # 連接android設備SNHVB20C18002195
init_device(platform="Windows",uuid="29563034") # uuid表示Android設備的序列號，Windows的句柄，iOS的uuid
connect_device('Android:///') # 本地android設備
connect_device('Android:///SNHVB20C18002195') # SNHVB20C18002195為手機序列號，可通過adb devices命令查看
connect_device("Android://127.0.0.1:7555")
connect_device("Windows:///") # 連接到windows桌面
connect_device("Windows:///29563034") # 連接到句柄29563034的windows應用
connect_device("iOS:///127.0.0.1:8100") # 連接iOS 設備
打開、停止APP
打開APP
start_app(package, activity=None)
停止APP：
stop_app(package)
元素操作方法
常用的元素操作方法主要包括下面5種：
touch((100, 100), times=1) # 點擊絕對坐標，times為點擊次數，默認為1次
touch((100, 100), duration=2) # Android 和 Windows 平台應用可設置點擊時間duration
touch((100, 100), right_click=True) # Windows右鍵點擊
touch(Template(r"tpl1624889731448.png", record_pos=(-0.129, 0.832), resolution=(720, 1280))) # 點擊圖片中心，Template類包括了圖片位置，手機分辨率，圖片保存位置屬性以及模板匹配，查找圖片在手機的位置等方法
圖片可以通過AirtestIDE來獲取，點擊Airtest輔助窗的touch方法，然后在設備窗中選擇要操作的位置區域：
swipe滑動操作
swipe(v1, v2, vector=None) # 從v1滑動到v2，v1為起點，可以是Template類或者像素坐標
swipe((341,297), vector=[0.0131, 0.2495])
swipe(Template(r"tpl1624977188003.png", record_pos=(-0.015, -0.204), resolution=(720, 1280)), vector=[0.0011, 0.2826])
text文本輸入
使用此方法時要確保輸入框為活動狀態，可以先點擊一下輸入框，然后再輸入
text("test", enter=True) # 輸入完成后，輸入Enter鍵
keyevent鍵盤輸入
keyevent(keyname) # 在Android中類似於執行 adb shell input keyevent KEYNAME
keyevent("HOME") # 或者 keyevent("3") HOME鍵
Android的按鍵可參考：https://developer.android.com/reference/android/view/KeyEvent
snapshot截圖
snapshot(filename=None, msg="", quality=None, max_size=None) # 保存屏幕截圖，filename：圖像名，quality：圖像質量（1-99），max_size：大小
wait等待出現
等待目標圖片出現
wait(Template(r"tpl1624977188003.png"), timeout=None, interval=0.5, intervalfunc=None) # timeout：最大等待時間，interval：檢查間隔時間
exists檢查目標是否出現
檢查當前界面是否出現指定目標
pos = exists(Template(r"tpl1624977188003.png")) # 如果找到目標，可以返回目標位置坐標
if pos:
touch(pos)
斷言
斷言目標是否存在
斷言目標存在：assert_exists
assert_exists(Template(r"tpl1624977188003.png"))
斷言目標不存在：assert_not_exists
assert_not_exists(Template(r"tpl1624977188003.png"))
值是否相等
assert_equal(first, second) # 斷言兩個值相等
assert_not_equal(first, second) # 斷言兩個值不相等
Poco使用
UI 元素可通過在AirtestIDE的Poco 輔助窗查看：
Android手機開啟開發者模式，連接電腦，通過adb devices查看手機是否連接成功。
初始化：
from poco.drivers.android.uiautomation import AndroidUiautomationPoco
poco = AndroidUiautomationPoco(force_restart=False,use_airtest_input=True, screenshot_each_action=False)
poco.device.wake() # 執行喚醒：進入主頁，啟動Yosemite
UI元素定位
基本選擇器
poco('node_name') # 默認第一個參數為節點名
# 也可以通過name 或者其它屬性定位
poco(text='行情', type='android.widget.TextView')
相對選擇器
和XPath的相對定位一樣，poco可以根據父子關系、兄弟關系、祖孫關系來定位。
# select by direct child/offspring
poco("android:id/tabs").child("android.widget.RelativeLayout")[1].offspring(text="行情").click() # 具有多個元素的情況下，可以使用索引，索引從0開始。
兄弟節點定位：
poco("name").sibling("sibling_name")
父節點：
poco("name").parent("parent_name")
屬性獲取
獲取UI對象屬性
ele = poco(text='行情')
print(ele.attr('type')) # 屬性
print(ele.attr('text')) # text屬性
print(ele.get_bounds()) # 邊界框
print(ele.get_position()) # 坐標
print(ele.get_size()) # UI 元素大小
print(ele.get_name()) # 元素名稱
print(ele.get_text()) # 元素文本值，和ele.attr('text')一樣
print(ele.exists()) # 元素是否存在
執行結果：
android.widget.TextView
行情
[0.978515625, 0.39583333333333337, 0.994921875, 0.3541666666666667]
[0.375, 0.98671875]
[0.041666666666666664, 0.01640625]
com.xueqiu.android:id/tab_name
行情
True
poco中的坐標采用百分比坐標，將x和y方向都縮放為0-1。
UI 元素操作
下面介紹幾種常見poco元素操作方法
click點擊
點擊UI元素
poco('name').click() # 默認點擊UI元素錨點（左上角）
poco('name').click('center') # 點擊中心點
poco('name').click([0.5, 0.5]) # 點擊中心點
poco('name').focus([0.5, 0.5]).click() # 點擊中心點
點擊坐標
poco.click([0.5, 0.5]) # 點擊屏幕中心點
poco.long_click([0.5, 0.5], duration=3) # 長按
set_text文本輸入
text = 'test'
poco('name').set_text(text) # 相文本框name輸入文本
swipe滑動
swipe(direction, focus=None, duration=0.5)
-
direction ： 滑動方向，可選up，down，left，right，也可傳入向量坐標。
-
duration：滑動持續時間，時間越短，滑動速度就越快，滑動的距離就越長
ele = poco('name')
ele.swipe('up') # 向上滑動
ele.swipe([0,-0.1]) # 向上滑動
ele.swipe('down') # [0,0.1] 下滑
ele.swipe('left') # [-0.1,0] 左滑
ele.swipe('right')# [0.1,0] 右滑
ele.swipe([0.2, -0.2]) # 右上45度角滑動swipe sqrt(0.08) 單元距離
ele.swipe([0.2, -0.2], duration=0.5)
根據坐標滑動
poco.swipe(p1, p2=None, direction=None, duration=2.0)
從坐標 (100, 100) 滑動到 (100, 200) ，手機屏幕分辨率為1920×1080
poco.swipe([100/1920, 100/1080], [100/1920, 200/1080], duration=0.5)
# 或者
poco.swipe([100/1920, 100/1080], direction=[0, 100/1080], duration=0.5)
drag_to拖到
從一個UI元素拖到另一個UI元素
ele1 = poco('name1').focus([0.5,0.5])
ele2 = poco('name2').focus([0.5,0.5])
ele.drag_to(ele2)
wait等待
等待目標對象出現，返回目標對象
poco('name').wait(5).click() # 最多等待5秒，元素出現后點擊
poco('name').wait(5).exists() # 最多等待5秒，返回元素是否出現
poco('name').wait_for_appearance(timeout=10) # 等待元素出現
poco("name").wait_for_disappearance(timeout=10) # 等待元素消失
ele1 = poco('name1')
ele2 = poco('name2')
poco.wait_for_all([ele1,ele2], timeout=10) # 等待2個UI元素標簽全部出現
poco.wait_for_any([ele1,ele2], timeout=10) # 等待任意一個UI元素出現
截圖
from base64 import b64decode
b64img, fmt = poco.snapshot(width=720)
open('screen.{}'.format(fmt), 'wb').write(b64decode(b64img))
總結
本文主要介紹了Airtest和poco的使用方法，Airtest的圖片識別功能很好用，poco用於UI元素操作。可以將這它們結合起來使用，特別是在游戲的測試中，需要通過圖標來定位。Airtest+poco還有一個優點就是app初始化啟動速度要快於appium。