Appium常用的API函數


 在學習應用一個框架之前,應該了解一下這個框架的整體結構或是相應的API函數。這篇文章還不錯:http://blog.sina.com.cn/s/blog_68f262210102vzf9.html,就拷貝過來。

常用的API函數

 獲取信息類API

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

get_app_string()

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

get_app_string(String language)

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

current_activity()

 App安裝與卸載類API

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

is_app_installed(String bundleId)

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

install_app(String appPath)

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

remove_app(String bundleId)

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

close_app()

(5)啟動應用

launch_app()

(6)先closeApp然后在launchAPP

reset_app()

文件操作類API

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

push_file(String remotePath, byte[] base64Data)

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

pull_file(String remotePath)

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

pull_folder(String remotePath)

設置相關類API

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

set_network_connect(NetworkConnectionSetting connection)

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

get_network_connection()

用戶操作類API

(1)ios隱藏鍵盤

hide_keyboard()

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

hide_keyboard(String strategy, String keyName)

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

send_key_event(int key)

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

perform_touchAction(TouchAction touchAction)

(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, int duration)

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

swipe(int startx, int starty, int endx, 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)滾動方向由element1到element2

scroll(element1,element2)  

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

scroll_to_exact(String text)

(17)設置上下文

context(String name)

(18)可用上下文

get_context_handles()

(19)當前上下文

get_context()

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

rotate(ScreenOrientation orientation)

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

get_orientation()

獲取控件類API

seleniumdriver

find_element_by_id
find_elements_by_id
find_element_by_name
find_elements_by_name
find_element_by_link_text
find_elements_by_link_text
find_element_by_partial_link_text
find_elements_by_partial_link_text
find_element_by_tag_name
find_elements_by_tag_name
find_element_by_xpath
find_elements_by_xpath
find_element_by_class_name
find_elements_by_class_name
find_element_by_css_selector
find_elements_by_css_selector

appiumdriver

find_element_by_ios_uiautomation
find_elements_by_ios_uiautomation
find_element_by_android_uiautomator
find_elements_by_android_uiautomator
find_element_by_accessibility_id
find_elements_by_accessibility_id

AppiumDriver的輔助類

主要針對手勢操作,比如滑動、長按、拖動等。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, int y)

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

release() 

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

move_to(WebElement el)

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

move_to( int x, int y)

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

tap(WebElement el)

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

tap(int x, int y)

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

tap(WebElement el, int x, int y)

(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, int y) 

(15)取消執行該動作

cancel()

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM