版權聲明：該文章為AirtestProject原創文章；允許轉載，但轉載必須注明“轉載”並保留原鏈接
前言
本文檔將演示使用`AirtestProject`專用的編輯器AirtestIDE，編寫`Airtest`+`Poco`自動化腳本的全流程。強烈建議新手從本文檔開始閱讀，並使用`AirtestIDE`上手腳本編寫。
簡介
`AirtestIDE` 是一個跨平台的UI自動化測試編輯器，適用於游戲和App。
- 自動化腳本錄制、一鍵回放、報告查看，輕而易舉實現自動化測試流程
- 支持基於圖像識別的Airtest框架，適用於所有Android/iOS/Windows應用
- 支持基於UI控件搜索的Poco框架，適用於Unity3d，Cocos2d與Android/iOS App等多種平台
- 能夠運行在Windows和MacOS上
訪問官網通過視頻查看更多特性。
通過本教程，你將學會如何上手自動化測試（或者寫點腳本來自動玩游戲）。相信我，這個過程會非常愉快~
安裝
目前AirtestIDE提供了Windows和Mac兩個版本的客戶端，請從官網下載，解壓即用。
連接設備
AirtestIDE目前支持測試`Android`/`Windows`/`iOS`上的應用，其他更多平台的支持正在開發中。
無論是`Android`/`iOS`手機，還是`Windows`窗口，在`Airtest`中都將它視為一個設備，接下來我們將演示如何連接一個設備。
連接Android手機
通過ADB連接你的電腦和Android手機，即可開始調試Android應用。ADB是Google官方提供的Android調試工具。AirtestIDE依賴ADB與安卓設備進行通信。
打開AirtestIDE，按照以下步驟進行連接：
- 打開手機`設置-開發者選項-USB調試`開關，參考安卓官方文檔
- 在AirtestIDE設備面板中點擊`refresh ADB`按鈕，查看連接上的設備
- 如果沒有顯示出設備，試試`restart ADB`，如果還不行，參考FAQ文檔進行問題排查
- 能夠成功看到設備后，點擊對應設備的`Connect`按鈕，進行初始化
手機連接成功后，即可在AirtestIDE中看到手機屏幕的鏡像顯示，並進行實時操作。
如果手機連接失敗，請先參考FAQ文檔進行問題排查。若依然不成功，請將手機型號和AirtestIDE后台報錯提交到Github Issue，開發人員會盡快修復。由於Android手機的碎片化問題嚴重，我們非常感謝您的反饋可以幫助這個項目做的更好。
連接Windows窗口
對於Windows桌面程序的測試，AirtestIDE可以將被測窗口嵌入，方便腳本錄制和調試。
- 在AirtestIDE設備面板中點擊`Windows-框選游戲窗口`按鈕
- 將鼠標移動到被測程序的窗口上，會顯示綠色邊框，將對應的窗口框出
- 點擊左鍵即可將對應的窗口嵌入到AirtestIDE中
如果上述方法不能正確找到被測程序的窗口，你還可以使用備用嵌入方法。
連接iOS手機
要連接一台iOS手機，你需要先准備好一台安裝了Xcode的Mac電腦，連接方法參考文檔。
錄制自動化腳本
在連上設備后，我們可以開始錄制自動化測試腳本了，在接下來的內容中，我們將會使用一台Android設備上的一款Unity游戲應用，給大家演示如何錄制腳本。
模擬輸入
讓我們先從最常用的模擬點擊開始吧，模擬點擊的意思就是，模仿你的操作去點擊設備上的某個指定位置。
基於圖像識別
目前我們支持通過圖像識別的方式，找到你想要點擊的位置並進行操作，這是基於Airtest這個框架實現的。
我們可以先看看如何自動錄制腳本：點擊AirtestIDE左側的Airtest輔助窗上的`錄制`按鈕，然后隨着你在設備窗口上操作手機，代碼會自動生成在代碼窗口中。
馬上來驗證一下，點擊`運行`按鈕運行你的第一個自動化腳本吧！
如果你覺得自動錄制生成的圖標不夠精確，還可以點擊Airtest輔助窗上的`touch`按鈕，然后在設備窗口上框選精確的圖標，也可以自動生成一條`touch`語句。
類似的模擬輸入操作還有滑動：點擊`swipe`按鈕，在設備窗口上框選精確的圖標作為滑動起點，然后點擊滑動終點位置，即會自動生成一個`swipe`語句。
其他模擬輸入的API包括：
- text: 文字輸入
- keyevent: 按鍵輸入，包括(HOME/BACK/MENU等)
- sleep: 等待
- snapshot: 截屏
基於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樹形結構。
框架信息
上述兩種UI識別方式，分別是基於兩個框架：
- 基於圖像識別的[Airtest](https://github.com/AirtestProject/Airtest)框架
- 基於UI控件搜索的[Poco](https://github.com/AirtestProject/Poco)框架
這兩個框架都是由我們團隊開發的Python第三方庫，在實際項目使用經驗中，我們發現兩者互相配合會得到最好的效果。在腳本編寫的過程中，我們往往也需要查閱它們的項目API文檔。
使用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的倉庫。
斷言
到這里，我們已經有各種模擬輸入方法，配合邏輯控制語句讓手機動起來。自動化測試中還有很重要的一個步驟：結果驗證，那么我們來看看怎樣聲明斷言。
驗證UI界面
錄制方法與模擬輸入類似
- `assert_exists`：斷言圖片存在
- `assert_not_exists`：斷言圖片不存在
驗證數值
通過Poco獲取屬性值，手寫代碼進行斷言
- `assert_equal`：斷言相等
- `assert_not_equal`：斷言不等
例如
# ... 模擬輸入並獲得20分之后 value = Poco("分數按鈕").attr("num") assert_equal(value, 20, "獲到20分")
查看測試報告
腳本運行完畢后，點擊`查看報告`按鈕（快捷鍵Ctrl+L），會使用默認瀏覽器打開結果報告頁面。報告中將展示出每一個步驟的內容和實際執行過程的截圖、運行結果，方便查看步驟是否執行成功。
命令行接口
現在，你已經學會自動化測試了。接下來呢，你可以使用命令行接口將自動化測試與持續集成結合起來。持續集成是什么？
在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上進行測試。
在網易游戲內部，我們的大型游戲通常會有數百個測試腳本，覆蓋常用的玩法測試。每周，這數百個腳本會分別運行在200台手機上進行兼容性測試。