【轉】APPIUM API

網上看到的一些appium的API的一些介紹,就轉過來自己記錄下。方便以後查看。



3.1常用的API函數

3.1.1 獲取信息類API

(1)獲取默認系統語言對應的Strings.xml文件內的數據。

get_app_string()

(2)查找某一個語言環境對應的字符串文件Strings.xml內數據。

get_app_string(Stringlanguage)

(3)獲取當前activity,比如(.ApiDemos)

current_activity()

3.1.2App安裝與卸載類API

(1)根據bundleId來判斷該應用是否已經安裝

is_app_installed(StringbundleId)

(2)安裝app,appPath爲應用的本地路徑

install_app(StringappPath)

(3)卸載app.bundleId在android中代表的是包名,而在iOS中有專門的bundleId號。

remove_app(StringbundleId)

(4)關閉應用,其實就是按home鍵把應用置於後臺

close_app()

(5)啓動應用

launch_app()

(6)先closeApp然後在launchAPP

reset_app()

3.1.3 文件操作類API

(1)將字符數組用64位格式寫到遠程目錄的某個文件中。也可以理解爲把本地文件push到設備上。

push_file(String remotePath, byte[]base64Data)

(2)將設備上的文件pull到本地硬盤上

pull_file(StringremotePath)

(3)將設備上的文件夾pull到本地硬盤上,一般遠程文件爲/data/local/tmp下的文件。

pull_folder(StringremotePath)

3.1.4 設置相關類API

(1)設置手機的網絡連接狀態,可以開關藍牙、wifi、數據流量。通過NetworkConnectionSetting中的屬性來設置各個網絡連接的狀態。

set_network_connect(NetworkConnectionSettingconnection)

(2)得到當前網絡的狀態

get_network_connection()

3.1.5 用戶操作類API

(1)ios隱藏鍵盤

hide_keyboard()

(2)隱藏鍵盤,只能用於ios上。

hide_keyboard(String strategy, StringkeyName)

(3)按下某個鍵,具體哪個鍵由key值決定,key值定義在AndroidKeyCode類中

send_key_event(int key)

(4)執行一個touch動作,該touch動作是由TouchAction封裝的。

perform_touchAction(TouchActiontouchAction)

(5)點擊element控件中心點按下,duration*5毫秒秒後鬆開,如此重複fingers次。

tap(int fingers, WebElement element,int duration)

(6)點擊(x,y)點按下,duration*5毫秒後鬆開,如此重複fingers次。

tap(int fingers, int x, int y, intduration)

(7)從(startx,starty)滑到(endx,endy),分duration步滑,每一步用時是5毫秒。

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

(8)2個手指操作控件,從對角線向中心點滑動。

pinch(WebElement el)

(9)以(x,y)爲基準,計算得出(x,y-100),(x,y+100)兩個點,然後2個手指按住這兩個點同時滑到(x,y)

pinch(int x, int y)

(10)與pinch(el)的動作剛好相反。兩個手指由控件的中心點慢慢向控件的左頂點後右底點滑動。

zoom(WebElement el)

(11)和pinch(x,y)相反。兩個手指從(x,y)點開始向(x,y-100)和(x,y+100)滑動。

zoom(int x, int y)

(12)鎖屏多少秒後解鎖

lock_screen(int seconds)

(13)模擬搖晃手機

shake()

(14)滾動到某個text屬性爲指定的字符串的控件

scroll_to(String text)

(15)滾動到某個text屬性包含傳入的字符串的控件

scroll_to_exact(Stringtext)

(16)設置上下文

context(String name)

(17)可用上下文

get_context_handles()

(18)當前上下文

get_context()

(19)設置屏幕橫屏或者豎屏

rotate(ScreenOrientationorientation)

(20)獲取當前屏幕的方向

get_orientation()

3.1.6 獲取控件類API

(1)利用ios中的uiautomation中的屬性來獲取控件

find_element_by_ios_uiautomation(String using)

(2)和上面一樣,不過獲得的是多個控件

find_elements_by_ios_uiautomation(String using)

(3)利用Android的uiautoamtor中的屬性來獲取單個控件。

find_element_by_android_uiautomator(Stringusing)

(4)和上面一樣,但是該方法獲得是多個控件

find_elements_by_android_uiautomator(Stringusing)

(5)利用accessibility id來獲取單個控件

find_element_by_accessibilityid(String using)

(6)利用accessibility id來獲得多個控件

find_elements_by_accessibilityid(String using)

3.1.7AppiumDriver的輔助類

主要針對手勢操作,比如滑動、長按、拖動等。TouchAction的原理是講一系列的動作放在一個鏈條中,然後將該鏈條傳遞給服務器。服務器接受到該鏈條後,解析各個動作,逐個執行。

TouchAction()

(1)在控件上執行press操作

press(WebElement el)

(2)在座標爲(x,y)的點執行press操作

press(int x, int y)

(3)在控件el的左上角的x座標偏移x單位,y左邊偏移y單位的座標上執行press操作。

press(WebElement el, int x, inty)

(4)釋放操作,代表該系列動作的一個結束標誌。

release() 

(5)以el爲目標,從另一個點移動到該目標上

move_to(WebElement el)

(6)以(x,y)點爲目標,從另一個點移動到該目標上

move_to(WebElement el, int x, inty)

(7) 在控件的中心點上敲擊一下

tap(WebElement el)

(8)在(x,y)點輕擊一下

tap(int x, int y)

(9)以控件el的左上角爲基準,x軸向右移動x單位,y軸向下移動y單位。在該點上輕擊。

tap(WebElement el, int x, inty)

(10)代表一個空操作,等待一段時間

wait_action()

(11)等待ms

wait_action(int ms)

(12)控件長按

long_press(WebElement el)

(13)點長按

long_press(int x, int y)

(14)偏移點長按

long_press(WebElement el, int x, inty) 

(15)取消執行該動作

cancel()


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章