網上看到的一些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()