Appium+Python3入門

標籤：系統   web   host   ref   src   環境配置   結束   case   password   

前言：

Appium 是一個自動化測試開源工具，支援 iOS 平台和 Android 平台上的原生應用，web 應用和混合應用。

一、環境配置

1、安裝Node.js

https://nodejs.org/

2、安裝Appium

http://appium.io/ 

3、安裝Android SDK

http://tools.android-studio.org/index.php/sdk

4、安裝Python-client

pip3 install Appium-Python-Client

5、安裝Appium-client

npm install wd

最後，開啟命令列，輸入“appium-doctor”命令，如果出現以下提示，說明你Appium所需要的各項環境都已準備完成。

二、服務關鍵字

Desired Capabilities在啟動session的時候是必須提供的。

Desired Capabilities本質上是以key value字典的方式存放，用戶端將這些索引值對發給服務端，告訴服務端我們想要怎麼測試。

desired_caps = {}

desired_caps[‘platformName‘] =‘Android‘

desired_caps[‘platformVersion‘] =‘6.0.1‘

desired_caps[‘deviceName‘] =‘e0bbc8b7‘

desired_caps[‘appPackage‘] =‘com.ximalaya.ting.android‘

desired_caps[‘appActivity‘] =‘com.ximalaya.ting.android.host.activity.WelComeActivity‘

desired_caps["unicodeKeyboard"] ="True"

desired_caps["resetKeyboard"] ="True"

self.driver = webdriver.Remote(‘http://127.0.0.1:4723/wd/hub‘, desired_caps)

它告訴appium Server這樣一些事情：

?deviceName：啟動哪種裝置，是真機還是模擬器？iPhone Simulator，iPad Simulator，iPhone Retina 4-inch，Android Emulator，Galaxy S4…

?automationName：使用哪種自動化引擎。appium（預設）還是Selendroid。

?platformName：使用哪種移動平台。iOS, Android, orFirefoxOS。

?platformVersion：指定平台的系統版本。例如指的Android平台，版本為5.1。

?appActivity：待測試的app的Activity名字。比如MainActivity、.Settings。注意，原生app的話要在activity前加個”.“。

?appPackage：待測試的app的Java package。比如com.example.android.myApp, com.android.settings。

三、定位控制項

1、ID定位

使用方法：driver.find_element_by_id(‘com.android.calculator2:id/formula’)

 

2、name定位

使用方法：driver.find_element_by_name("9"))

 

3、class name定位

使用方法：driver.find_element_by_class_name(“android.widget.Button"))

 

4、XPath定位

使用方法：用class的屬性來替代做標籤的名字。

driver.find_element_by.xpath(“//android.view.ViewGroup/android.widget.Button”)

 

當果如果出現class相同的情況下可以用控制項的屬性值進行區分。

driver.find_element_by_xpath("//android.widget.Button[contains(@text,‘7‘)]").click();

driver.find_element_by_xpath(”//android.widget.Button[contains(@content-desc,’times‘)]").click();

driver.find_element_by_xpath("//android.widget.Button[contains(@text,‘7‘)]").click();

driver.ffind_element_by_xpath("//android.widget.Button[contains(@content-desc,‘equals‘)]").click();

XPath在Appium上的用法依然很強大，有時需要寫更臭更長的定位文法，因為APP上元素的class命令本來就長，再加上多層級，結果可想而知。

5、Accessibility ID定位

使用方法：其實，我們的核心是要找到元素的contentDescription屬性。它就是元素的content-desc。

driver.find_element_by_accessibility_id("plus").click();

 

6、android uiautomator定位

使用方法：

一個元素的任意屬性都可以通過android uiautomator方法來進行定位，但要保證這種定位方式的唯一性。

driver.find_element_by_android_uiautomator("new UiSelector().text(\”8\")").click();

driver.find_element_by_android_uiautomator("new UiSelector().description(\”plus\")").click();

 

 

四、應用操作

1、安裝應用

installApp()

安裝應用到裝置中去。需要apk包的路徑。

2、卸載應用

removeApp()

從裝置中刪除一個應用。

3、關閉應用

closeApp()

關閉開啟的應用，預設關閉當前開啟的應用，所以不需要入參。這個方法並非真正的關閉應用，相當於按home鍵將應用置於後台，可以通過launchApp()再次啟動。

4、啟動應用

launchApp()

啟動應用。你一定很迷惑，不是在初始化的配置資訊已經指定了應用，指令碼啟動並執行時候就需要啟動應用，為什麼還要有這個方法去啟動應用呢？重新啟動應用也是一個測試點，該方法需要配合closeApp()使用的。

5、檢查應用是否安裝

isAppInstalled()

檢查應用是否已經安裝。需要傳參應用程式套件的名字。返回結果為Ture或False。

6、將應用置於後台

runAppInBackground()

將當前活躍的應用程式發送到後台。這個方法需要入參，需要指定應用置於背景時間長度。

7、應用重設

resetApp()

重設當前被測程式到出始化狀態。該方法不需要入參。

五、鍵盤操作

1、SendKeys()方法

driver.find_element_by_name(“Name”).send_keys("jack");

2、PressKeyCode()方法

除此之外，Appium擴充提供了pressKeyCode()方法。該方法Android特有。

發送一個鍵碼的操作。（鍵碼對照表請自行百度，此處不展示了。）

driver.press_keycode(3)//點擊Android的HOME鍵

driver.press_keycode(27)//點擊拍照鍵

3、IME問題：

必須使用appium內建鍵盤，並添加：

desired_caps["unicodeKeyboard"] = "True"

desired_caps["resetKeyboard"] = "True"

六、TouchAction操作

Appium的輔助類，主要針對手勢操作，比如滑動、長按、拖動等。

1、按壓控制項press()

開始按壓一個元素或座標點（x,y）。通過手指按壓手機螢幕的某個位置。

press(WebElement el, int x, int y)

2、長按控制項longPress()

開始按壓一個元素或座標點（x,y）。相比press()方法，longPress()多了一個入參，既然長按，得有按的時間吧。duration以毫秒為單位。1000表示按一秒鐘。其用法與press()方法相同。

longPress(WebElement el, int x, int y, Duration duration)

3、點擊控制項tap()

對一個元素或控制項執行點擊操作。用法參考press()。

tap(WebElement el, int x, int y)

4、移動moveTo()

將指標（游標）從過去指向指定的元素或點。

movTo(WebElement el, int x, int y)

5、暫停wait()

暫停指令碼的執行，單位為毫秒。

action.wait(1000);

七、其他動作

其它操作針對行動裝置上特有的一些操作。

1、熄屏

方法：lockDevice()

點擊電源鍵熄滅螢幕。

在iOS裝置可以設定熄屏一段時間。Android上面不帶參數，所以熄屏之後就不會再點亮螢幕了。

driver.lockDevice(1000);// iOS

driver.lockDriice();//Android

2、收合鍵盤

方法：hideKeyboard()

收合鍵盤，這個方法很有用，當我們對一個輸入框輸入完成後，需要將鍵盤收合，再切換到一下輸入框進行輸入。

driver.hideKeyboard();//收合鍵盤

3、滑動

方法：swipe()

類比使用者滑動。將控制項或元素從一個位置（x,y）拖動到另一個位置（x,y）。

swipe(int startx, int starty, int endx, int endy, int duration)

* start_x：開始滑動的x座標。* start_y：開始滑動的y座標。

* end_x：結束滑動的x座標。* end_y：結束滑動的y座標。

* duration：期間。

例：driver.swipe(75, 500, 75, 0, 800);

4、截屏

方法：get_screenshot_as_file()

用法：driver.get_screenshot_as_file(‘../screenshot/foo.png‘)，參數為儲存的圖片路徑和名稱

5、擷取控制項各種屬性

方法：get_attribute（）

用法: driver.find_element_by_id().get_attribute(name)，

name即是左側的標誌(class，package，checkable，checked....)，

可擷取的字串類型：

name(返回content-desc或text)

text(返回text)

className(返回class，只有API=>18才能支援)

resourceId(返回resource-id，只有API=>18才能支援)

八、unittest之斷言

在unittest單元測試架構中，TestCase類提供了一些方法來檢查並報告故障：

>>assertEqual(first, second, msg=None)

判斷first和second的值是否相等，如果不相等則測試失敗，msg用於定義失敗後所拋出的異常資訊。

>>assertNotEqual(first, second, msg=None)

測試first和second不相等，如果相等，則測試失敗。

>>assertTure(expr,msg=None)

>>assertFalse(expr,msg=None)

測試expr為Ture（或為False）

>>assertIs(first, second, msg=None)

>>assertIsNot(first, second, msg=None)

測試的first和second是（或不是）相同的對象。

>>assertIsNone(expr, msg=None)

>>assertIsNotNone(expr, msg=None)

測試expr是（或不是）為None

>>assertIn(first, second, msg=None)

>>assertNotIn(first, second, msg=None)

測試first是（或不是）在second中。second包含是否包含first。

九、執行個體代碼（例子app：喜馬拉雅FM）

import os

import unittest

from appium import webdriver

from time import sleep

# Returns abs path relative to this file and not cwd

PATH =lambdap: os.path.abspath(

os.path.join(os.path.dirname(__file__), p)

)

class Contacts Android Tests(unittest.TestCase):

def setUp(self): 

desired_caps = {}

desired_caps[‘platformName‘] =‘Android‘

desired_caps[‘platformVersion‘] =‘6.0.1‘

desired_caps[‘deviceName‘] =‘e0bbc8b7‘

desired_caps[‘appPackage‘] =‘com.ximalaya.ting.android‘

desired_caps[‘appActivity‘] =‘com.ximalaya.ting.android.host.activity.WelComeActivity‘

desired_caps["unicodeKeyboard"] ="True"

desired_caps["resetKeyboard"] ="True"

self.driver = webdriver.Remote(‘http://127.0.0.1:4723/wd/hub‘, desired_caps)

sleep(6)

def tearDown(self):

self.driver.close_app()

self.driver.quit()

deftest_Login(self):

self.driver.find_element_by_id(‘com.ximalaya.ting.android:id/tab_myspace‘).click()

sleep(2)

self.driver.find_element_by_accessibility_id(‘設定‘).click()

sleep(2)

width =self.driver.get_window_size()[‘width‘]

height =self.driver.get_window_size()[‘height‘]

self.driver.swipe(width /2, height *7/8, width /2, height *4/8,1000)

# 不同的手機解析度不同，所以一個座標如果用另一個解析度不同的手機可能位置就有所變化了，為了讓apppium 更好的相容不同解析度的裝置，

# 在執行滑動前先擷取螢幕的解析度。

self.driver.find_element_by_id(‘com.ximalaya.ting.android:id/main_tv_login‘).click()

self.driver.find_element_by_id(‘com.ximalaya.ting.android:id/main_username‘).send_keys(‘18500425217‘)

self.driver.find_element_by_id(‘com.ximalaya.ting.android:id/main_password‘).send_keys(‘wj1234‘)

self.driver.find_element_by_id(‘com.ximalaya.ting.android:id/main_login‘).click()

sleep(4)

text =self.driver.find_element_by_id(‘com.ximalaya.ting.android:id/tab_myspace‘).text

self.assertEqual(text,‘我的‘)

deftest_Search(self):

sleep(3)

message =self.driver.find_element_by_id(‘com.ximalaya.ting.android:id/main_item_finding_title‘).text

self.assertEqual(message,‘天天好書‘)

self.driver.find_element_by_accessibility_id("搜尋").click()

self.driver.find_element_by_id(‘com.ximalaya.ting.android:id/main_search_et‘).send_keys(‘段子‘)

self.driver.find_element_by_id(‘com.ximalaya.ting.android:id/main_search_button‘).click()

self.driver.get_screenshot_as_file(‘/Users/wangjuan/圖庫／1.jpg‘)

self.driver.press_keycode(4)

self.assertEqual(message,‘天天好書‘)

if__name__ ==‘__main__‘:

suite = unittest.TestLoader().loadTestsFromTestCase(ContactsAndroidTests)

unittest.TextTestRunner(verbosity=2).run(suite)

以上，希望對你有所協助～～

Appium+Python3入門