Airtest學習（一）

簡單了解

工具下載安裝

連接設備

• Android
• Windows視窗
• 模擬器連接
• 無線連接
• IOS

簡單熟悉

• airtest工具使用
• 基于影像識別(airtest)
• 基于UI控制元件搜索（poco）
• Selenium Window

語法與使用

• touch
• swipe
• text
• keyevent
• 斷言

其他了解

• 使用本地python環境運行腳本
• 命令引數
• 怎么樣不通過IDE使用命令列去生成和匯出報告
• airtest使用PYTHON代碼生成報告

一：簡單了解

Airtest：是一個跨平臺的、基于影像識別的UI自動化測驗框架，適用于游戲和App，支持平臺有Windows、Android和iOS，

Poco：是一款基于UI控制元件識別的自動化測驗框架，目前支持Unity3D/cocos2dx-*/Android原生app/iOS原生app/微信小程式，也可以在其他引擎中自行接入poco-sdk來使用，

AirtestIDE：跨平臺的UI自動化測驗編輯器，內置了Airtest和Poco的相關插件功能，能夠使用它快速簡單地撰寫Airtest和Poco代碼，

二：工具下載安裝

Airtest的官網：http://airtest.netease.com/

目前有Windows和Mac兩個版本的客戶端

下載最新版本

下載其他版本

安裝python環境，最好是3.6的，3.8還不支持，

幫助檔案：http://airtest.netease.com/docs/docs_AirtestIDE-zh_CN/index.html

三：連接設備

（1）Android

refresh ADB重繪狀態，點擊Connect初始化；如果沒有顯示出設備，用restart ADB重啟看看

如果不行看https://airtest.doc.io.netease.com/IDEdocs/device_connection/2_android_faq/

（2）Windows視窗

方法一：嵌入式

點擊Windows-框選游戲視窗,選中被測程式即可，也可以拖出去

注意：在選擇狀態下，點擊鍵盤的 esc 按鍵、滑鼠右鍵均可退出狀態

方法二：非嵌入式

如果不行看https://airtest.doc.io.netease.com/IDEdocs/device_connection/5_windows_connection/#id2

（3）模擬器連接

如夜神模擬器，點擊連接能看到多了一條資料

點擊connect后面的下拉箭頭，選擇Use javacap，再點擊connect

在部分版本的模擬器上，可能勾選了 use javacap 后依然連接失敗，此時可以嘗試再勾選 use adb orientation 選項后再重新連接即可

在搞夜神模擬器時候，上面的操作報錯了

檢查了sdk的adb版本

檢查了夜神模擬器adb版本

解決方法：

1：將sdk安裝目錄下的platform-tools中的adb.exe替換夜神中的adb.exe，然后在將sdk中的adb復制一份改名為nox_adb.exe，放入夜神的Nox的bin目錄下

2：將airtest目錄里的yosemite.apk直接安裝到夜神中

當然懶的搞直接換模擬器也行，木木不錯

（4）無線連接

在cmd輸入adb tcpip 5555

在這輸入手機的那個wifi的ip（手機的wifi和電腦的一樣），然后上面就出現設備了，點擊連接即可

（5）IOS

要有安裝了Xcode的Mac電腦，可惜我沒有，跳過，，，

https://airtest.doc.io.netease.com/IDEdocs/device_connection/4_ios_connection/

四：簡單熟悉

（1）工具使用

1）實時坐標、相對坐標

兩個都勾選就是開了相對坐標（格式是(0, 0) 到 (1, 1)），以避免跨解析度的操作點超出螢屏的問題

2）手機螢屏顯示效果

數字越大，清晰度越高，默認為800

3）兼容模式

4）代碼補全

用本地的會更好

5）安卓小助手

連接設備后

• 安卓apk

• 操作包

• 切換輸入法（Yosemite和本地輸入法）

• 調節手機音量（一鍵靜音，或者加大、減小音量）

• 打開網址/輸入內容

6）生成報告

腳本運行完畢后，點擊查看報告按鈕（快捷鍵Ctrl+L）

（2）基于影像識別(airtest)

自動錄制腳本，點擊AirtestIDE左側的Airtest輔助窗上的錄制按鈕，不過這種錄制生成的圖片不精準，可以自己選擇那些按鈕，拖動生成自己想要的

touch（）通過截圖來 點擊某個位置（截圖后圖片會存盤在當前跟目錄下）

wait （）等待某個指定的圖片元素出現

swipe（） 從一個位置滑動到另外一個位置

exists（）執行之前，提前判斷對應圖片是否存在

text （）呼叫輸入法輸入指定內容

keyevent （）輸入某個系統按鈕鍵的操作，如(HOME/BACK/MENU等)

snapshot （）當前畫面截圖

sleep（）延遲時間（s），也可以用python內的“time.sleep(10)”

assert_exists（）來斷言一張圖片存在當前畫面中

assert_not_exists（）來斷言不存在于當前畫面中

assert_equal（）斷言傳入的兩個值相等

assert_not_equal（）斷言傳入的兩個值不相等

（2）基于UI控制元件搜索（poco）

目前Poco直接支持Unity3d、Cocos2d、白鷺引擎等多種游戲引擎，以及Android/iOS原生App，

如果是Android/iOS原生應用，是即插即用的，無需接入SDK，但由于游戲引擎使用OpenGL等圖形介面直接渲染，而沒有使用Android原生的UI系統，我們需要與游戲的Runtime進行通信獲取整個UI結構，

sdk接入需要程式幫忙搞，這里我使用原生應用來學習

需要安裝這2個應用

出現下方兩行代碼，然后就可以在UI渲染樹看到UI的結構了

#安卓實體
from poco.drivers.android.uiautomation import AndroidUiautomationPoco
#poco實體化
poco = AndroidUiautomationPoco(use_airtest_input=True, screenshot_each_action=False)

但是我這是沒有的

（1）從左到右分別是鎖定，定位，錄制

（2）當前頁面的UI層級

我這是原生應用，如果是其他的要接入SDK：https://poco-chinese.readthedocs.io/zh_CN/latest/source/doc/integration.html

安裝poco：（可以通過pip list看安裝了什么版本）

然后報錯了，輸入第二個命令更新pip版本后，再試一次，不過后面還是失敗，就換了個地址

pip3 install pocoui -i http://pypi.douban.com/simple/ --trusted-host pypi.douban.com

但是我發現UI渲染樹還是沒有，原因是我用的是oppo手機，沒有彈出安裝PocoService

解決方法：在開發者選項->直接拉到最后->禁止權限監控，會立刻彈出PocoService，安裝后就會出現渲染樹了，

（3）Selenium Window

比如谷歌瀏覽器（屬性可以看路徑，找不到檔案夾是因為路徑隱藏了，開了就行）

這個忽略，有緣再見

五：語法與使用

（1）touch

(2)swipe

（3）text

（4）keyevent

（5）斷言

# assert_exists和assert_not_exists介面的超時時間和闕值
# 這2介面查找圖片的超時時間和闕值都是全域變數，timeout為20s，threasold為0.7
# 所以腳本只有在20s內找到置信度>0.7的結果，斷言才會成功

如果是圖片，雙擊可以查看識別精度

六：其他了解

注：學習的時候看到路徑都是/，但我用\也可以

（1）使用本地python環境運行腳本

本地沒有安裝python環境，或是沒有安裝 airtest 與 poco，也可以通過airtest的命令列運行

也可以使用本地的python，但是這樣也是無法脫離airtest的使用

通過添加PYTHONPATH設定，可以使用本地的python.exe來運行腳本

想使用其他python第三方庫，使用在本地python環境中安裝airtest和pocoui，然后用命令列運行腳本更好

#使用 pip 安裝Airtest框架 
pip install airtest
#使用 pip 安裝poco框架 
pip install pocoui

Pip指令運行失敗
國內用戶請在pip install 指令后面加上 -i https://pypi.tuna.tsinghua.edu.cn/simple后重試
參考：https://mirrors.tuna.tsinghua.edu.cn/help/pypi/
環境部署完成后，我們就能夠脫離AirtestIDE，在不同的宿主機器和被測平臺上運行腳本了

報錯，adb版本不一致（通過adb version查），airtest的版本是40，于是我將41的覆寫掉它（airtest\core\android\static\adb\windows\）

但是又很尷尬，這樣又導致，在IDE運行腳本的時候，不顯示模擬器，而且會報錯，于是就還是保留40版本，將40的改名字nox_adb.exe，覆寫夜神里面的，雖然會報錯，但是能用

在命令列運行又報錯，這里是沒有識別圖片，納尼，我檔案夾有該圖片呀

后面在命令列帶了引數?cap_method=JAVACAP^&^&ori_method=ADBORI^&^&touch_method=MINITOUCH（注意：特殊字符沒轉義，命令列被截斷）

參考：https://airtest.doc.io.netease.com/IDEdocs/run_script/1_useCommand_runScript/#id4

運行的時候還是會識別不到圖片，可能是設備太卡了，于是將wait的時間設定到60秒，然后就可以了

（2）命令引數（更多參考：https://airtest.readthedocs.io/zh_CN/latest/README_MORE.html#running-air-from-cli）

1）--device，指定連接的被測設備

# 什么都不填寫，會默認取當前連接中的第一臺手機
Android:///
# 連接本機默認埠連的一臺設備號為79d03fa的手機
Android://127.0.0.1:5037/79d03fa
android://127.0.0.1:5037/127.0.0.1:62001      #連接夜神模擬器
# 連接一個Windows視窗，視窗句柄為123456
Windows:///123456
# 連接一個Windows視窗，視窗名稱匹配某個正則運算式
Windows:///?title_re=Unity.*
# 連接iOS手機
iOS:///127.0.0.1:8100

參考：https://www.cnblogs.com/CincentHuang/p/11766026.html

2）--log，指定 log 內容和截圖存放的目錄

1:沒傳入引數--log
不保存 log 內容和截圖
命令列會提示do not save log


2：傳入的引數為--log log/
生成的 log 內容放到當前命令列執行目錄下的 log 目錄里面


3：指定目錄
log 內容與截圖將會放在指定目錄里
--log E:/aritest/log

eg：
夜神：
airtest run C:\Users\Administrator\Desktop\chyairtest.air --device android://127.0.0.1:5037/127.0.0.1:62001?cap_method=JAVACAP^&^&ori_method=ADBORI^&^&touch_method=MINITOUCH --log F:\Airtest\log


android設備：
airtest run C:\Users\Administrator\Desktop\chyairtest.air --device android://127.0.0.1:5037/FIFIMFFEPVAIWCU8?cap_method=MINICAP_STREAM^&^&ori_method=MINICAPORI^&^&touch_method=MINITOUCH --log F:\Airtest\log --recording

注意：在這里，--log log/，我剛開始以為是我腳本檔案的目錄下，其實應該是C:\Users\Administrator下的log目錄（C:\Users\Administrator>腳本命令）

3）--recording，運行腳本時進行錄屏操作

以 MP4 格式保存在 log 內容所在的目錄里面

用夜神的時候錄制不了，要用android設備，于是跑的時候又報錯了，點擊事件沒生效

這個問題是我使用了py2，后面換了py3就可以了（2和3的環境變數可以一起配，在前面的先使用）

4）生成報告（更多引數：https://airtest.readthedocs.io/zh_CN/latest/README_MORE.html#generate-html-report）

通過airtest report + 腳本檔案路徑指令，下面是可用引數：

• --log_root，指定log內容和截圖檔案所在的目錄

• --outfile，指定生成報告的目錄

• --lang，指定報告語言，可以是中文/英文

• --export，匯出一個包含所有資源的報告檔案

• --static_root，指定靜態資源檔案的路徑

注意：如果使用report 沒有傳入引數，會去腳本檔案所在目錄下尋找log/log.txt生成html報告，如果不存在該目錄會報錯

成功生成報告（在運行生成報告命令前，要運行一次腳本）

--log_root：指定log和圖片目錄
--outfile：指定輸出報告的目錄
--lang：指定語言，默認是英文（zh中文en英文）

C:\Users\Administrator>airtest report C:\Users\Administrator\Desktop\chyairtest.air --log_root F:\Airtest\log --outfile F:\Airtest\log\log.html --lang zh
[07:38:28][INFO]<airtest.report.report> F:\Airtest\log\log.html

讀取報告中靜態資源檔案和圖片檔案

-- export：不使用該引數，是絕對路徑來訪問里面的圖片檔案；同時HTML報告中訪問的靜態css與js資源檔案，也是硬碟上的絕對路徑（默認在airtest的安裝目錄下的report檔案夾里）

注意：使用了export引數，outfile引數會失效

airtest report C:\Users\Administrator\Desktop\chyairtest.air --log_root F:\Airtest\log --lang zh --export F:\Airtest\log\cs\

--static_root

# 每次匯出報告，都有static目錄，一般來說，除非報告的樣式做了某些更新，否則這些靜態資源檔案都是固定不變的，

# 將這些資源檔案部署到靜態資源檔案服務器上，用例如 https://host:port/static/css/ 的路徑來訪問它，然后在生成報告時，將這個部署出來的服務器地址作為 --static_root的引數傳過去：
--static_root https://host:port，可以避免匯出報告時重復拷貝這些資源檔案造成的磁盤空間占用

注意：

1：使用了POCO陳述句的報告，在你的報告命令列最末尾添加指令--plugin poco.utils.airtest.report

2：使用SELENIUM插件的報告指令，加入--plugin airtest_selenium.report

（3）怎么樣不通過IDE使用命令列去生成和匯出報告

參考：https://airtest.readthedocs.io/zh_CN/latest/all_module/airtest.report.report.html#airtest.report.report.simple_report

可以借助simple_report() 介面或者 LogToHtml() 類來實作

1） simple_report生成報告(在本地看)

• filepath，腳本檔案的路徑，可以直接傳入變數 __file__（應該是表示使用默認的引數意思吧）
• logpath ，log內容所在路徑，如為 True ，則默認去當前腳本所在路徑找log內容
• logfile ，log.txt的檔案路徑
• output ，報告的到處路徑，必須以 .html 結尾

簡化版的生成報告的介面，如果不指定引數，該介面會使用默認的引數生成1份HTML格式的報告，output='log.html' 表示在當前腳本路徑下生成名為 log.html 的airtest報告

from airtest.report.report import simple_report
simple_report(__file__)

指定output 引數，則按指定路徑生成報告

simple_report(__file__,output="F:\Airtest\log\log.html")

如果生成報告的路徑和腳本的路徑不同，比如我腳本在C盤，報告想放F盤，就會報下面這個錯，雖然沒影響

備注：剛剛開始學習的時候，有點懵logpath和logfile這兩個引數（這2個引數好像沒啥用），我在我腳本下新建了log目錄，運行腳本后沒看到log.txt生成，那報告是通過哪里的log.txt生成的，我在airtest設定看到log的路徑（臨時檔案）

后面問了大佬，我才知道，我代碼中的auto_setup(__file__)，使用了默認的引數，不生成log檔案

可以使用auto_setup(__file__,logdir=True)，就能在腳本目錄下的log目錄生成log檔案這些，如下：

• basedir：設定當前腳本的路徑，也可以直接傳入__file__變數
• logdir：腳本運行時log保存路徑，如果設定是True，則保存在<basedir>/log目錄中

剛開始我以為我運行運行后生成了log，我就可以通過logpath和logfile去生成報告（不需要再次運行腳本代碼），但是發現報告要不是空的就是圖片顯示不了，于是我就不糾結了

直接運行腳本，在腳本后使用simple_report(__file__,logpath=True,output="C:\\Users\Administrator\Desktop\chyairtest.air\log.html")即可

2）ogToHtml匯出報告（通過腳本的形式）

from airtest.report.report import LogToHtml
腳本內容（省略）

# 腳本路徑/log檔案路徑/log.txt路徑/存放報告路徑/語言/插件
chyR = LogToHtml(script_root="C:\\Users\Administrator\Desktop\chyairtest.air", log_root="C:\\Users\Administrator\Desktop\chyairtest.air\log",logfile="C:\\Users\Administrator\Desktop\chyairtest.air\log\log.txt",export_dir="F:\\Airtest\log",lang='zh',plugins=None)
chyR.report()

3）在運行腳本的時候，不免會出現報錯，導致執行不下去，然后無法生成報告，可以這樣

# try:
#     用例...
#     會導致失敗的陳述句
#     用例...
# finally:
#     報告陳述句

注：在airtest要注意縮進，要不報錯：expected an indented block

（4）airtest使用PYTHON代碼生成報告

由于Airtest是python第三方庫，所以當然也可以簡單地呼叫介面來生成報告，首先，我們需要先新建腳本-選擇純.py檔案，然后在創建時需要勾選生成log