測試_appium測試工具

1、Appium介紹

Appium是一個開源的自動化測試工具，其支持iOS和安卓平臺上的原生的，基於移動瀏覽器的，混合的應用。

一、Appium 理念

Appium是基於如下的四個理念設計來知足移動平臺測試自動化的要求的：

1）您不該該由於須要自動化測試您的應用而不得不以任何形式去從新編譯或者修改你的app

2）您不該該把本身固定在一門特定的語言和一個特定的框架上去實現和運行你的測試

3）當說到測試自動化APIs的時候，一個移動測試框架不該該作「從新發明輪子」的事情，

4）一個移動測試自動化框架應該是開源的，不管是在精神上，實際上，仍是名義上！

二、使用Appium進行自動化測試有兩個好處

Appium在不一樣平臺中使用了標準的自動化APIs，因此在跨平臺時，不須要從新編譯或者修改本身的應用。

Appium支持Selenium WebDriver支持的全部語言，如java、Object-C、JavaScript、Php、Python、Ruby、C#、Clojure，或者Perl語言，更可使用Selenium WebDriver的Api。Appium支持任何一種測試框架.Appium實現了真正的跨平臺自動化測試。（本文主要介紹Python的用法）

三、Appium架構

Appium 是一個用Node.js編寫的HTTP server，它建立、並管理多個 WebDriver sessions 來和不一樣平臺交互，如 iOS ，Android等等. 

Appium 開始一個測試後，就會在被測設備（手機）上啓動一個 server ，監聽來自 Appium server的指令. 每種平臺像 iOS 和Android都有不一樣的運行、和交互方式。因此Appium會用某個樁程序「侵入」該平臺，並接受指令，來完成測試用例的運行。

 

 

2、Appium環境搭建（Android）

一、首先須要準備

1) jdk（步驟再也不囉嗦）

2) android SDK，下載地址：http://developer.android.com/sdk/index.html，下載sdk tools，可能須要FQ，提供一個國內下載地址：http://www.androiddevtools.cn/

3) appium，下載地址：http://appium.io/

4) nodejs，下載地址：https://nodejs.org/en/

5) appium lib，下載地址：http://appium.io/downloads.html

     選擇Python版本的Lib: Appium-Python-Client-0.22.tar.gz

     因爲Appium依賴於Selemium,因此還要下載 Selemium Lib: selenium-2.53.2.tar.gz   https://pypi.python.org/pypi/selenium

6) python, 下載地址：https://www.python.org/， 下載2.X 的版本。

上述軟件都準備好後，則進入搭建步驟。

二、安裝、配置

將上述軟件依次安裝。

1) android sdk安裝完畢後，須要配置環境變量

新建ANDROID_HOME    D:\ProgramFiles (x86)\Android\android-sdk

在PATH中添加：%ANDROID_HOME%\platform-tools;%ANDROID_HOME%\tools;

2)  nodejs安裝完畢後，須要配置環境變量

在PATH中添加：D:\Program Files\nodejs;

3) appium安裝完畢後，須要配置環境變量

D:\Program Files (x86)\Appium\node_modules\.bin;

4) 配置好後，啓動cmd，

輸入node -v，查看node安裝版本

輸入appium-doctor檢查appium的安裝環境是否成功，以下圖：

 

5) 安裝Python,配置環境變量，如C:\Python27，檢查是否設置成功，以下圖：

 

3、開始例子（Python）

1) 啓動Appium

打開命令行，輸入appium， 顯示成功啓動：

 

2）鏈接Android手機（或者模擬器）

3）編寫客戶端代碼

假設咱們的代碼放在目錄E:\PythonTest\AppiumClientPython 中。首先把 Appium-Python-Client-0.22.tar.gz 裏面的 appium 目錄解壓到AppiumClientPython 中， 把 selenium-2.53.2.tar.gz裏面的 selenium 目錄解壓到AppiumClientPython中。

建立文件hello_appium.py , 編輯內容：

#coding=utf-8 from appium import webdriver   desired_caps = {} desired_caps['platformName'] = 'Android' desired_caps['platformVersion'] = '4.4.2' desired_caps['deviceName'] = 'Android Emulator' desired_caps['appPackage'] = 'com.android.calculator2' desired_caps['appActivity'] = '.Calculator'   driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps) driver.find_element_by_name("1").click() driver.find_element_by_name("5").click() driver.find_element_by_name("9").click() driver.find_element_by_name("9").click() driver.find_element_by_name("5").click() driver.find_element_by_name("+").click() driver.find_element_by_name("6").click() driver.find_element_by_name("=").click() driver.quit()

 

4）運行

打開命令行，cd到E:\PythonTest\AppiumClientPython 中，運行 python hello_appium.py, 正常狀況能夠看到手機按照代碼控制，打開計算器，逐個點擊按鈕完成計算。

4、Appium文檔

一、安裝應用後打開

import os from appium import webdriver APK_PATH = 'apk/ECloud-debug.apk' COMMAND_EXECUTOR_URL = 'http://localhost:4723/wd/hub'        desired_caps = {}     desired_caps['platformName'] = 'Android'     desired_caps['platformVersion'] = '5.0'     desired_caps['deviceName'] = 'Android Emulator'     desired_caps['app'] = os.path.abspath(APK_PATH)       driver = webdriver.Remote(COMMAND_EXECUTOR_URL, desired_caps)

 

二、查找控件

1）經過名稱查找

btn = driver.find_element_by_name("+")

2)  經過ID查找

start_btn =driver.find_element_by_id('com.cn21.ecloud:id/instruction_close_btn')

或 start_btn = driver.find_element_by_id('instruction_close_btn')

3）經過類名查找

child_text =parent.find_element_by_class_name('android.widget.TextView')

4）經過android_uiautomator查找

start_btn =driver.find_element_by_android_uiautomator('new UiSelector().clickable(true)')

以上find_element_by_XX 都是返回符合條件的第一個控件，若是要返回多個控件，能夠調用 find_elements_by_XX, 返回的是一個list。

注意：若是找不到符合條件的控件，會拋出異常。

5）查找結點，不但願返回異常，寫個函數就好了

def find_element_by_id_no_except(driver, id):     element = None     try :         element = driver.find_element_by_id(id)     except Exception,e:         print Exception, ':', e     return element

 

三、模擬按鈕點擊

login_btn.click()

注意：有的點擊若是須要等待動畫、或者網絡請求，建議等待一會：

import time time.sleep(2)  # 睡眠2秒

 

四、輸入框輸入文本

user_input.send_keys('123456')

注意：Android若是要正確輸入，須要把使用系統自帶的輸入法，第三方輸入法沒法正確輸入。

五、模擬點擊返回鍵

driver.press_keycode(4)

其中按鈕的定義，由Android裏的KeyEvent.java裏定義的，因此其它的Android按鈕也是支持的。

六、關閉driver

driver.quit()

注意：必定要記得關閉driver, 不然下次鏈接的時候可能會出異常，由於Appium覺得你上次未關閉，會建立Session失敗。

爲了不代碼出現異常而沒有關閉，能夠在捕獲異常時再關閉。

七、滑動界面

下面的例子，演示點擊屏幕中間，並向上拉動（至關於查看列表下面的內容了）。

from appium.webdriver.common.touch_action import TouchAction def test_scroll_down(driver):     screen = driver.get_window_size()     action = TouchAction(driver)     action.press(x=screen['width']/2,y=screen['height']/2)     action.move_to(x=0,y=-screen['height']/10)     action.release()     action.perform()

等等，怎麼獲取界面的屬性來驗證正確性？

八、獲取界面屬性，控件屬性

1）獲取當前Activity名稱

activity = driver.current_activity

2) 獲取屏幕寬高

screen = driver.get_window_size()

3）獲取控件文本

mobile_name.get_attribute('text') 或者 mobile_name.text

4）獲取控件類名

mobile_name.get_attribute('className')

5）判斷控件是否顯示

mobile_name.is_displayed() 或者 mobile_name.get_attribute('displayed')

6）得到控件位置

mobile_name.location

7）得到控件大小

mobile_name.size

8）查找控件子結點

parent.find_elements_by_class_name('android.widget.TextView')

一樣：查找控件的其它方法，也適用於查找子結點。

 

對於交互後的驗證，沒法驗證到具體的數據內容，能夠驗證當前的Activity,或者文本，或者列表是否爲空等等。

更多參考：http://blog.csdn.net/crisschan/article/details/50416860

 

5、結合單元測試框架編寫用例

Python自帶有unittest用於單元測試，其結構相似於JUnit。

一個測試類須要繼承於unittest.TestCase, 方法setUp 用於測試初始化，每一個用例開始前都會調用，tearDown用於用例結束時調用，每一個以test開始的函數被當成一個用例。

test_random.py

import random import unittest   class TestSequenceFunctions(unittest.TestCase):       def setUp(self):         self.seq = range(10)       def test_shuffle(self):         # make sure the shuffled sequence does not lose any elements         random.shuffle(self.seq)         self.seq.sort()         self.assertEqual(self.seq, range(10))           # should raise an exception for an immutable sequence         self.assertRaises(TypeError, random.shuffle, (1,2,3))       def test_choice(self):         element = random.choice(self.seq)         self.assertTrue(element in self.seq)       def test_sample(self):         with self.assertRaises(ValueError):             random.sample(self.seq, 20)         for element in random.sample(self.seq, 5):             self.assertTrue(element not in self.seq)   if __name__ == '__main__':     unittest.main(verbosity=2)

 

運行此測試： python test_random.py 能夠查看測試的結果

 

上面結果顯示，有2個用例測試經過，1個用例不經過。

能夠在一個目錄下寫多個以test開頭的測試文件，而後經過如下命令運行全部測試類：

python -m unittest discover . -v

 

6、完整例子

一、測試登錄登出功能

test_ecloud_login_logout.py

#coding=utf-8 # 測試天翼雲登錄登出功能 # 用例1：快速登錄，驗證登錄後的Activity爲MainPageActivity # 用例2：普通登錄，輸入用戶名密碼，驗證登錄後的Activity爲MainPageActivity # 用例3：快速登錄後註銷，驗證註銷後的Activity爲LoginActivity import unittest import appium_ecloud import appium_util from appium import webdriver import os class LoginLogoutTest(unittest.TestCase):     ##     def setUp(self):         #print('Installing ...')         desired_caps = {}         desired_caps['platformName'] = 'Android'         desired_caps['platformVersion'] = '5.0'         desired_caps['deviceName'] = 'Android Emulator'         desired_caps['app'] = os.path.abspath(appium_ecloud.APK_PATH)         self.driver = webdriver.Remote(appium_util.COMMAND_EXECUTOR_URL, desired_caps)              def tearDown(self):         self.driver.quit()              def test_FastLogin(self):         appium_ecloud.agree_document(self.driver)         appium_ecloud.quick_login(self.driver)         self.assertTrue(self.driver.current_activity.endswith('MainPageActivity'))              def test_SlowLigin(self):         appium_ecloud.agree_document(self.driver)         appium_ecloud.slow_login(self.driver)         self.assertTrue(self.driver.current_activity.endswith('MainPageActivity'))              def test_Logout(self):         appium_ecloud.agree_document(self.driver)         appium_ecloud.quick_login(self.driver)         if (self.driver.current_activity.endswith('MainPageActivity')):             appium_ecloud.test_logout(self.driver)             self.assertTrue(self.driver.current_activity.endswith('LoginActivity')) if __name__ == '__main__':     unittest.main(verbosity=2)

 

二、自動亂點測試崩潰的狀況

auto_test_ecloud.py

#coding=utf-8 import random import time import traceback import appium_ecloud def auto_interact(driver):     activity = driver.current_activity     # 必定的機率滑動，返回鍵，點擊     rate = random.random()     if rate < 0.1:         print activity + ' Scroll Down'         appium_ecloud.test_scroll_down(driver)     elif rate < 0.2:         print activity + ' Scroll Up'         appium_ecloud.test_scroll_up(driver)     elif rate < 0.3:         print activity + ' Key Back'         driver.press_keycode(4)     else:         btn_list = driver.find_elements_by_android_uiautomator('new UiSelector().clickable(true)')         if (len(btn_list) > 0):             index = random.randint(0, len(btn_list) - 1)             print activity + ' Click Button index = %d' % (index,)             btn_list[index].click() def main():     driver = None     try:         driver = appium_ecloud.install_app()         time.sleep(appium_ecloud.LONG_WAIT_TIME)         appium_ecloud.agree_document(driver)         appium_ecloud.quick_login(driver)         step = 0         while step < 100:             if (driver.current_activity.endswith('LoginActivity')):                 appium_ecloud.test_login(driver)             elif (driver.current_activity.endswith('.Launcher')):                 driver.background_app(1)                 driver.launch_app()             else:                 auto_interact(driver)                 time.sleep(appium_ecloud.CLICK_WAIT_TIME)             step += 1         # 正常退出         driver.quit()     except Exception, e:         print Exception, ":", e         traceback.print_exc()         # 異常退出         if (driver != None):             driver.quit() if __name__ == '__main__':     for i in range(20000):         try:             main()         except Exception, e:             print Exception, ":", e             traceback.print_exc()

 

注：爲了更方便的編寫python代碼，推薦使用PyCharm IDE，編輯代碼跟Java同樣方便。

 

7、參考資料：

1）官網 http://appium.io/index.html

2）appium/python-client使用文檔https://github.com/appium/python-client

3）搭建appium的android環境http://www.cnblogs.com/qiaoyeye/p/5131382.html

4）Appium移動自動化測試（四）http://www.cnblogs.com/fnng/p/4579152.html

5）AppiumPython API http://blog.csdn.net/crisschan/article/details/50416860

6）appium經常使用方法總結 http://www.cnblogs.com/fanxiaojuan/p/4882676.html