如何使用UIAutomation進行iOS 自動化測試（Part I）

 

寫在前面

研究iOS的自動化測試也有些日子了，剛開始的時候，一直苦於找不到什么好的資料，只能從Apple的官網查閱相關的API文檔，只可惜，Apple對開發者來說實在是不怎么友好，文檔寫得相當的粗略，對於初學者來說有一定的難度。

本來是打算自己動手寫一篇關於iOS的UI自動化測試的入門級別的介紹性文檔的，但想起來后面在具體解決一些問題的時候，收藏一篇很好的Blog，很全面地介紹了如何使用UIAutomation的JavaScript Libraries做iOS程序的自動化測試。如果作者早點看到這篇文章，應該要少走一些彎路，這里沒有創意性的它他翻譯成中文，希望對你們有一些幫助。

原文地址：http://blog.manbolo.com/2012/04/08/ios-automated-tests-with-uiautomation

翻譯正文：

 

快速入門

自動化測試代碼可以“在你的睡着的時候”很好地幫你測試你的應用程序。它可以讓你能夠快速地跟蹤你程序中的回歸和性能方面的問題，這樣你就不用擔心你新增的功能會影響到你之前已經完成開發的程序了。

隨着iOS4.0的發布，蘋果公司同時發布了一個名為UIAutomation的測試框架，它可以用來在真實設備和iPhone模擬器上執行自動化測試。但官方關於UIAutomation的文檔相當的有限，在網絡上也沒有太多的資源可以查找的。本文將向你展示你如何將UIAutomation整合到你的工作流程當中去。

作為基礎知識的准備，你可以先看一下蘋果公司關於UIAutomation的文檔，另外還有一篇快速入門的介紹蘋果Instruments的文檔也值得看看，當然，如果你有一個免費的Apple開發者賬號的話，你可以看一下WWDC 2010 - Session 306 – 使用Instruments進行用戶界面自動化測試的幻燈片或者視頻。

除此之外，包括在Xcode中的OCUnit測試框架也可以用來為你的應用程序編寫單元測試。

1. 第一個UIAutomation測試腳本

• 使用iOS 模擬器
• 使用iOS設備

2. 處理UIAElement和元素可訪問性（Accessibility）

• UIAElement層次結構
• 模擬用戶操作

3. 經驗分享（讓你的生活變得更簡單）

• 類庫Tune-up介紹
• 導入外部腳本
• 使用強大的命令行
• 使用錄制交互功能
• 當遇到問題時，加上“UIATarget.delay(1);”

4. 高級交互

• 處理非預期和預期的提示框（alerts）
• 多任務
• 屏幕方向

5. 總結

• 有用的鏈接
• 一個視頻

1. 你的第一個UIAutomation測試腳本

UIAutomation的功能測試代碼是用Javascript編寫的。UIAutomation和Accessibility有着直接的關系，你將用到通過標簽和值的訪問性來獲得UI元素，同時完成相應的交互操作。

下面讓我們來編寫我們的第一段測試代碼。

使用iOS模擬器

1. 下載示例應用程序TestAutomation.xcodeproj，並打開它。這個項目是一個很簡單的包含2個tab的tabbar應用程序。

2. 確保選中如下圖所示的“TestAutomation > iPhone 5.0 Simulator”模式（或許你已經切換成5.1了，因此它可能是iPhone5.1模擬器）。

3. 啟動Instruments(Product > Profile)，或者通過⌘I。

4. 選擇左邊的iOS Simulator，然后再選擇Automation模板，然后點擊“Profile”。

5. Instruments就已經啟動好后，然后直接開始錄制了。這里先停止錄制，（紅包按鈕或者⌘R）。

6. 在左邊的Scripts窗口，點擊“Add > Create”創建新的腳本。

7. 在腳本編輯器里，輸入下面的代碼

var target = UIATarget.localTarget();
var app = target.frontMostApp();
var window = app.mainWindow();
target.logElementTree();

8. 重新運行這段腳本⌘R（不需要保存）。腳本跑起來后，你可以在日志打完后停止它。

贊一個！我們就這樣完成了我們的第一個UIAutomation測試用例。

使用iOS設備

你除了將你的測試用例運行模擬器上，也可以將它運行在一個真實的設備上。不過，自動化測試用例只能運行在支持多任務的：iPhone 3GS，iPad，iOS > 4.0等設備上。遺憾的是不管iPhone 3G的系統版本是什么，都不支持。

下面是如何操作：

1. 通過USB接口連接上你的iPhone。

2. 選擇 “TestAutomation > iOS Device”模式。

3. 確保Developper profile設置成Release模式（而不是Ad-Hoc Distribution profile）。默認情況下，profiling是設置成Release模式的（因為沒有必要將profile設置成Debug模式）。

4. 啟動測試 (⌘I)

5. 后面的步驟請參考前面模擬器部分。

 

2. 處理UIAElement和元素可訪問性（Accessibility）

UIAElement層次結構

Accessibility和UIAutomation有密切的聯系：如果一個控件的Accessibility是可以被訪問的，你就可以設置和讀取它的值，作相關的操作，而當一個控件的Accessibility不可見時，你就沒有辦法通過automation訪問它。

你可以通過Interface Builder，或者通過在程序里設置isAccessibilityElement屬性的方式來設置一個控件的Accessibility或者可被自動化。當你設置container view（即：一個視圖包含其它的UIKit元素）的accessibility時，你必須注意。你設置了整個View的accessibility將會“隱藏”它的子視圖的accessibility，例如：在示例項目中，你不能將outlet視圖設置成可訪問的，否則它所有的子控件將都不可以訪問了。在任何時候，logElementTree都是你忠實的朋友：它將當前界面的所有可被訪問的元素都打印在日志里。

每一個可以被訪問的UIKit控件都可以用一個Javascript對象來描述，它就是一個UIAElement。UIAElement有幾個屬性：name, value, elements, parent。你的主窗口包含很多的控件，它們是以UIKit層次的方式定義的，這些UIKit層次結構對應的是UIAElement的層次樹。例如：前面的測試代碼中，通過調用logElementTree，我們可以得到如下面所示的樹結構：

+- UIATarget: name:iPhone Simulator rect:{{0,0},{320,480}}

| +- UIAApplication: name:TestAutomation rect:{{0,20},{320,460}}

| | +- UIAWindow: rect:{{0,0},{320,480}}

| | | +- UIAStaticText: name:First View value:First View rect:{{54,52},{212,43}}

| | | +- UIATextField: name:User Text value:Tap Some Text Here ! rect:{{20,179},{280,31}}

| | | +- UIAStaticText: name:The text is: value:The text is: rect:{{20,231},{112,21}}

| | | +- UIAStaticText: value: rect:{{145,231},{155,21}}

| | | +- UIATabBar: rect:{{0,431},{320,49}}

| | | | +- UIAImage: rect:{{0,431},{320,49}}

| | | | +- UIAButton: name:First value:1 rect:{{2,432},{156,48}}

| | | | +- UIAButton: name:Second rect:{{162,432},{156,48}}

你可以通過下面的代碼來訪問文本框：

var textField = 
UIATarget.localTarget().frontMostApp().mainWindow().textFields()[0];

你可以選擇通過從0開始的索引或者這個元素的名稱來訪問這個元素，例如：你也可以通過下面的代碼來訪問文本控件。

var textField = 
UIATarget.localTarget().frontMostApp().mainWindow().textFields()["User Text"];

后一種方式更加清晰明了，應該多使用。你可以通過Interface Builder設置UIAElement的name屬性，

或者通過編寫代碼的方式：

myTextField.accessibilityEnabled = YES;
myTextField.accessibilityLabel = @"User Text";

你現在可以看到，通過accessibility屬性可以被UIAutomation用來找到不同的控件。這非常的清晰，因為，第一，你只要學習一個測試框架；第二，通過編寫自動化測試代碼，你同時還可以保證你的程序是可以被訪問的。因此，每一個UIAElement對象的子控件可以通過下面的方法進行訪問：

buttons(), images(), scrollViews(),textFields(), webViews(), segmentedControls(), sliders(), staticTexts(), switches(), tabBar(),tableViews(), textViews(), toolbar(), toolbars() 等等……

你可以通過如下代碼在tabbar上訪問第一個tab：

var tabBar = UIATarget.localTarget().frontMostApp().tabBar();
var tabButton = tabBar.buttons()["First"];

UIAElement結構層次非常的重要，你以后會常常用到它。而且你還要記住，你可以在隨時通過調用UIAAplication的logElementTree來獲得它的結構。

UIATarget.localTarget().frontMostApp().logElementTree();

在模擬器上，你還可以激活Accessibility 的檢測器。啟動模擬器，找到“Settings > General > Accessibility > Accessibility Inspector”，然后將它設為“打開”狀態。

這個彩色的小框框就是Accessibility 檢測器了。當它收起來的時候，Accessibility就被關閉了，當它展開的時候，Accessibility就是打開的。你只要點擊上面的箭頭按鈕就可以激活或者屏蔽Accessibility。現在，打開我們的示例程序，激活檢測器。

 

然后，點擊文本框，檢查UIAElement的name和value屬性（其實就是accessibilityLabel和accessibilityValue對應的NSObject類型的值）。這個檢測器可以幫助你調試和編寫你的測試代碼。

模擬用戶操作

讓我們更進一步，模擬一些用戶的交互操作。你可以簡單地調用按鈕的tap()來作一個點擊操作：

var tabBar = UIATarget.localTarget().frontMostApp().tabBar();
var tabButton = tabBar.buttons()["First"];   

// Tap the tab bar !
tabButton.tap();

你還可以調用UIAButtons的doubleTap(), twoFingerTap()。如果你不想操作具體的某個元素，你也可以直接根據屏幕上指定的坐標點進行操作，你可以這么用：

• 點擊:

UIATarget.localTarget().tap({x:100, y:200});
UIATarget.localTarget().doubleTap({x:100, y:200});
UIATarget.localTarget().twoFingerTap({x:100, y:200});

• 縮放:

UIATarget.localTarget().pinchOpenFromToForDuration({x:20, y:200},{x:300, y:200},2);
UIATarget.localTarget().pinchCloseFromToForDuration({x:20, y:200}, {x:300, y:200},2);   

• 拖拽與划動:

UIATarget.localTarget().dragFromToForDuration({x:160, y:200},{x:160,y:400},1);
UIATarget.localTarget().flickFromTo({x:160, y:200},{x:160, y:400});

注意，當你指定操作的時間間隔的時候，它是有特定的范圍的，即：拖拽操作的時間間隔必須大於或者等於0.5秒，小於60秒。

現在，讓我們來練習一下：

1. 停止Instruments (⌘R)
2. 在Scripts窗口里, 移除當前的腳本
3. 點擊“Add > Import”然后選擇TestAutomation/TestUI/Test-1.js（將下面的代碼保存到這個路徑）
4. 點擊錄制按鈕 (⌘R) 然后看看將會發生什么…

下面是Test-1.js代碼：

var testName = "Test 1";
var target = UIATarget.localTarget();
var app = target.frontMostApp();
var window = app.mainWindow();
UIALogger.logStart( testName );
app.logElementTree();
//-- select the elements
UIALogger.logMessage( "Select the first tab" );
var tabBar = app.tabBar();
var selectedTabName = tabBar.selectedButton().name();
if (selectedTabName != "First") {
	tabBar.buttons()["First"].tap();
}
//-- tap on the text fiels
UIALogger.logMessage( "Tap on the text field now" );
var recipeName = "Unusually Long Name for a Recipe";
window.textFields()[0].setValue(recipeName);
target.delay( 2 );
//-- tap on the text fiels
UIALogger.logMessage( "Dismiss the keyboard" );
app.logElementTree();
app.keyboard().buttons()["return"].tap();
var textValue = window.staticTexts()["RecipeName"].value();
if (textValue === recipeName){
	UIALogger.logPass( testName ); 
}
else{
	UIALogger.logFail( testName ); 
}

這段腳本先啟動待測程序，然后，如果第一個tab沒有被選的話就切換到第一個tab，並將上面的文本框的值設成“Unusually Long Name for a Recipe”，接着收起虛擬鍵盤。這里有一些新的方法值得注意的：UIATarget的delay(Number timeInterval) 方法允許你在兩個操作之間做一些等待，UIALogger的logMessage( String message) 方法用來將你想打印的信息輸出到日志上去，UIALogger的logPass(String message)方法指明你的測試腳本已經成功的完成測試了。

你還知道了如何訪問鍵盤上的按鈕，然后作點擊操作：

app.keyboard().buttons()["return"].tap();

 

由於時間有限且原文太長，先只能翻譯到這里，我會盡快的將剩下的部分翻譯補上。另外，時間倉促，如有翻譯得不准確的地方，也敬請擔待。謝謝。

本文由知平軟件的Dawson Liu翻譯，轉載請注明出處。

知平軟件致力於移動平台自動化測試技術的研究，我們希望通過向社區貢獻知識和開源項目，來促進行業和自身的發展。