轉載：https://airtest.doc.io.netease.com/tutorial/0_automated_testing/
1 | 5分鐘上手自動化測試——Airtest+Poco快速上手
1.1 前言
本文檔將演示如何使用Airtest Project專用的編輯器AirtestIDE，編寫Airtest+Poco自動化腳本的全流程。強烈建議新手從本文檔開始閱讀，並使用AirtestIDE上手腳本編寫。
html
1.2 簡介
AirtestIDE是一個跨平臺的UI自動化測試編輯器，適用於遊戲和App。python
- 自動化腳本錄製、一鍵回放、報告查看，垂手可得實現自動化測試流程。
- 支持基於圖像識別的Airtest框架，適用於全部Android/iOS/Windows應用。
- 支持基於UI控件搜索的Poco框架，適用於Unity3d、Cocos2d與Android/iOS App等多種平臺。
- 可以在Windows和MacOS運行。
訪問官網經過視頻查看更多特性。android
經過本教程，你將學會如何上手自動化測試（或者寫點腳原本自動玩遊戲）。相信我，這個過程會很是愉快~
ios
1.3 安裝
目前AirtestIDE提供了Windows和Mac兩個版本的客戶端，請從官網下載，解壓即用。
git
1.4 鏈接設備
AirtestIDE目前支持測試Android/Windows/iOS上的應用，其它更多平臺的支持正在開發中。
github
不管是Android/iOS手機，仍是Windows窗口，在Airtest中都將它視爲一個設備，接下來咱們將演示如何鏈接一個設備。
windows
1.4.1 鏈接Android手機
經過ADB鏈接你的電腦和Android手機，便可開始調試Android應用。ADB是Google官方提供的Android調試工具。AirtestIDE依賴ADB與安卓設備進行通訊。
瀏覽器
打開AirtestIDE，按照如下步驟進行鏈接：框架
一、打開手機設置-開發者選項-USB調試開關，參考安卓官方文檔；
二、在AirtestIDE設備面板中點擊refresh ADB按鈕，查看鏈接上的設備；
三、若是沒有顯示出設備，試試restart ADB，若是還不行，參考FAQ文檔進行問題排查；
四、可以成功看到設備後，點擊對應設備的Connect按鈕，進行初始化。編輯器
手機鏈接成功後，便可在AirtestIDE中看到手機屏幕的鏡像顯示，並進行實時操做。
若是手機鏈接失敗，請先參考FAQ文檔進行問題排查。若依然不成功，請將手機型號和AirtestIDE後臺報錯提交到Github Issue，開發人員會盡快修復。因爲Android手機的碎片化問題嚴重，咱們很是感謝您的反饋能夠幫助這個項目作得更好。
1.4.2 鏈接Windows窗口
對於Windows桌面程序的測試，AirtestIDE能夠將被測窗口嵌入，方便腳本錄製和調試。
- 在AirtestIDE設備面板中點擊「Windows-框選遊戲窗口」按鈕。
- 將鼠標移動到被測程序的窗口上，會顯示綠色邊框，將對應的窗口框出。
- 點擊左鍵便可將對應的窗口嵌入到AirtestIDE中。
若是上述方法不能正確找到被測程序的窗口，你還能夠使用備用嵌入方法。
1.4.3 鏈接iOS手機
要鏈接一臺iOS手機，你須要先準備好一臺安裝了Xcode的Mac電腦，鏈接方法參考文檔。
1.5 錄製自動化腳本
在連上設備後，咱們能夠開始錄製自動化測試腳本了，在接下來的內容中，咱們將會使用一臺Android設備上的一款Unity遊戲應用，給你們演示如何錄製腳本。
1.5.1 模擬輸入
讓咱們先從最經常使用的模擬點擊開始吧，模擬點擊的意思就是，模仿你的操做去點擊設備上的某個指定位置。
（1）基於圖像識別
目前咱們支持經過圖像識別的方式，找到你想要點擊的位置並進行操做，這是基於Airtest這個框架實現的。
咱們能夠先看看如何自動錄製腳本：點擊AirtestIDE左側的Airtest輔助窗上的「錄製」按鈕，而後隨着你在設備窗口上操做手機，代碼會自動生成在代碼窗口中。
立刻來驗證，點擊「運行」按鈕運行你的第一個自動化腳本吧！
若是你以爲自動錄製生成的圖標不夠精確，還能夠點擊Airtest輔助窗上的touch按鈕，而後在設備窗口上框選精確的圖標，也能夠自動生成一條touch語句。
相似的模擬輸入操做還有滑動：點擊swipe按鈕，在設備窗口上框選精確的圖標做爲滑動起點，而後點擊滑動終點位置，即會自動生成一個swipe語句。
其它模擬輸入的API包括：
- Text：文字輸入
- KeyEvent：按鍵輸入，包括（HOME/BACK/MENU等）
- Sleep：等待
- Snapshot：截屏
（2）基於UI控件
若是你發現圖像識別不夠精確，還可使用基於UI控件搜索的方式進行自動化測試，與剛纔的Airtest不一樣，這是Poco這個框架實現的功能。
目前Poco直接支持Unity3d、Cocos2d、白鷺引擎等多種遊戲引擎，以及Android/iOS原生App。
若是是Android/iOS原生應用，是即插即用的，無需接入SDK。但因爲遊戲引擎使用OpenGL等圖形接口直接渲染，而沒有使用Android源生的UI系統，咱們須要與遊戲的Runtime進行通訊獲取整個UI結構。
咱們提供了很是方便的SDK接入方法，點這裏查閱目前支持的平臺列表，以及如何爲你的項目接入Poco。
若是你的項目使用的引擎或平臺不在文檔中，咱們一樣支持自行擴展SDK。
實際上在網易遊戲內部，咱們就是用這種方式支持了Messiah/NeoX/夢幻等多個自研引擎。
接入完成後咱們便可開始。手機啓動遊戲，在AirtestIDE中的Poco輔助窗切換模式至對應引擎類型，便可看到整個UI結構。
點擊「錄製」按鈕，而後隨着你的鼠標操做，會自動生成Poco語句到腳本編輯框中。
一樣，你也能夠經過UI樹形結構更精確的檢視UI控件，雙擊節點自動生成Poco語句，或者自行選擇更好的寫法。
自動錄製出的語句不必定可以適應全部場景，採用更合理的選擇器編寫代碼，一般會加強整個自動化腳本的健壯性和可讀性，這是門學問。
錄製完腳本後記得運行試試效果。
對於Android/iOS的原生應用來講，不須要接入SDK便可使用，例如在連上Android手機後，將Poco輔助窗的模式切換至Android，能能夠看到整個UI樹形結構。
1.6 框架信息
上述兩種UI識別方式，分別是基於兩個框架：
這兩個框架都是由咱們團隊開發的Python第三方庫，在實際項目使用經驗中，咱們發現二者互相配合會獲得最好的效果。在腳本編寫的過程當中，咱們每每也須要查閱它們的項目API文檔。
1.7 使用Python語法
整個AirtestIDE中錄製和運行的代碼都是基於Python語言。Python語法簡潔而強大，第三庫和工具也很是多。
對於新手，Python上手很是容易，學會基本語法便可寫出自動化腳本中所需的邏輯語句。
touch("開卡包.png") if exists("獎勵面板.png"): for i in range(5): Poco("獎勵-%s" % i).click()
對於老手，你能夠在AirtestIDE中使用各類第三方庫來使你的自動化腳本更增強大，經過添加PYTHONPATH設置，可使用本地的Python.exe來運行你的腳本。
除了輔助窗口裏面提供的語句，更多的API文檔，能夠查看Airtest和Poco的倉庫。
1.7.1 斷言
到這裏，咱們已經有各類模擬輸入方法，配合邏輯控制語句讓手機動起來。自動化測試中還有很重要的一個步驟：結果驗證，那麼咱們來看看怎樣聲明斷言。
（1）驗證UI界面
錄製方法與模擬輸入相似。
- assert_exists：斷言圖片存在
- assert_not_exists：斷言圖片不存在
（2）驗證數值
經過Poco獲取屬性值，手寫代碼進行斷言。
- assert_equal：斷言相等
- assert_not_equal：斷言不等
例如：
# ... 模擬輸入並得到20分以後 value = Poco("分數按鈕").attr("num") assert_equal(value, 20, "獲到20分")
1.8 查看測試報告
腳本運行完畢後，點擊「查看報告」按鈕（快捷鍵Ctrl+L），會使用默認瀏覽器打開結果報告頁面。報告中將展現出每個步驟的內容和實際執行過程的截圖、運行結果，方便查看步驟是否執行成功。
1.9 命令行接口
如今，你已經學會自動化測試了。接下來呢，你可使用命令行接口將自動化測試與持續集成結合起來。持續集成是什麼？
在AirtestIDE運行腳本時，Log窗口中會打印運行命令。
你能夠在不開啓IDE的狀況下，在命令行中使用那條命令來啓動測試腳本，例如：
"D:\迅雷下載\AirtestIDE\AirtestIDE" runner "D:\AirtestIDE_2018-01-24_83\untitled.air" --device Android://127.0.0.1:5037/F8UDU16409004135 --log "C:\Users\gzliuxin\AppData\Local\Temp\AirtestIDE\scripts\cdfc40e8c297b6ad88e09de64d8bafa3"
使用AirtestIDE你能夠輕鬆地錄製出測試腳本，保存爲.air腳本。請注意一個.air腳本中不要包含太多內容，用良好的腳本命名和目錄結構來組織你的腳本，覆蓋全部測試點。
你還能夠在不一樣電腦上針對不一樣設備運行測試，這時候你就須要用命令行運行 .air 腳本 。對於多平臺發佈的產品，靈活使用跨平臺API和命令行，還可讓同一套測試腳本運行在Android和Windows上進行測試。