新手學appium-java api

/**
    也許你會問我，為什么會在robotium新手學習blog的過程中插入appium的java api，這完全是我即興做的，或許之后還會整理python的appium api，或者更多。最近恰巧跟測試同行在selenium談起移動自動化，話題自然而然地扯到了appium，robotium等等。

    希望這個文檔可以為正在學習的朋友帶來幫助，python的api或許馬上出爐
*/


getAppStrings()

//默認系統語言對應的Strings.xml文件內的數據。

driver.getAppStrings(String language)

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

sendKeyEvent(int key)

//按下某個鍵，具體哪個鍵由key值決定，key值定義在AndroidKeyCode類中

sendKeyEvent(int key, Integer metastate)

//按下某個鍵的同時按下附加鍵（Ctrl/Alt/Shift等），具體是哪些鍵，由key值（AndroidKeyCode類中定義）和metastate（AndroidKeyMetastate類中定義）決定。

currentActivity()

//獲取當前activity,比如（.ApiDemos）

isAppInstalled(String bundleId)

//根據bundleId來判斷該應用是否已經安裝

installApp(String appPath)

//安裝app，appPath為應用的本地路徑

removeApp(String bundleId)

//卸載app.bundleId在android中代表的是報名，而在ios中有專門的bundleId號。

closeApp()

//關閉應用，其實就是按home鍵把應用置於后台

launchApp()

//啟動應用

resetApp()

//先closeApp然后在launchAPP

pushFile(String remotePath, byte[] base64Data)

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

pullFile(String remotePath)

//將設備上的文件pull到本地硬盤上

pullFolder(String remotePath)

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

setNetworkConnection(NetworkConnectionSetting connection)

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

getNetworkConnection()

//得到當前網絡的狀態

openNotifications()

//打開通知欄

runAppInBackground(int seconds)

//與resetApp類似，區別是resetApp關閉后立即啟動，而這個方法是關閉后等待seconds秒后再啟動。

hideKeyboard()

//ios隱藏鍵盤

hideKeyboard(String strategy, String keyName)

//隱藏鍵盤，只能用於ios上。

performTouchAction(TouchAction touchAction)

//執行一個touch動作，該touch動作是由TouchAction封裝的。

performMultiTouchAction(MultiTouchAction multiAction)

//執行多步touch動作，由MultiTouchAction封裝的多步操作。

tap(int fingers, WebElement element, int duration)

//點擊element控件中心點按下，duration*5毫秒秒后松開，如此重復fingers次。

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

//點擊(x,y)點按下，duration*5毫秒后松開，如此重復fingers次。

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

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

pinch(WebElement el)

//2個手指操作控件，從對角線向中心點滑動。

pinch(int x, int y)

//以（x,y）為基准，計算得出（x,y-100）,(x,y+100)兩個點，然后2個手指按住這兩個點同時滑到（x,y）

zoom(WebElement el)

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

zoom(int x, int y)

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

getNamedTextField(String name)

//一般用在ios中。根據accessibility id獲得控件對象。

endTestCoverage(String intent, String path)

//結束測試覆蓋率的檢測。（沒用過，不太了解）path為.ec文件的路徑。

lockScreen(int seconds)

//鎖屏多少秒后解鎖（使用的時候提示還沒實現該方法）

shake()

//模擬搖晃手機（目前還沒實現）

scrollTo(String text)

//滾動到某個text屬性為指定的字符串的控件

scrollToExact(String text)

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

context(String name)

//設置上下文

getContextHandles()

//可用上下文

getContext()

//當前上下文

rotate(ScreenOrientation orientation)

//設置屏幕橫屏或者豎屏

getOrientation()

//獲取當前屏幕的方向

findElementByIosUIAutomation(String using)

//利用ios中的uiautomation中的屬性來獲取控件

findElementsByIosUIAutomation(String using)

//和上面一樣，不過獲得的是多個控件

findElementByAndroidUIAutomator(String using)

//利用android的uiautoamtor中的屬性來獲取單個控件。

findElementsByAndroidUIAutomator(String using)

//和上面一樣，但是該方法獲得是多個控件

findElementByAccessibilityId(String using)

//利用accessibility id來獲取單個控件

findElementsByAccessibilityId(String using)

//利用accessibility id來獲得多個控件

TouchAction

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

press(WebElement el)

//在控件上執行press操作。

press(int x, int y)

//在坐標為（x,y）的點執行press操作

press(WebElement el, int x, int y)

//在控件el的左上角的x坐標偏移x單位，y左邊偏移y單位的坐標上執行press操作。

release()

//釋放操作，代表該系列動作的一個結束標志。

moveTo(WebElement el)

//以el為目標，從另一個點移動到該目標上

moveTo(int x, int y)

//以（x,y）點為目標，從另一個點移動到該目標上

moveTo(WebElement el, int x, int y)

//以控件el的左上角為基准，x軸向右移動x單位，y軸向下移動y單位。以該點為目標，從另一個點移動到該點上。

tap(WebElement el)

//在控件的中心點上敲擊一下

tap(int x, int y)

//在（x,y）點輕擊一下

tap(WebElement el, int x, int y)

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

waitAction()

//代表一個空操作，等待一段時間

waitAction(int ms)

//等待ms秒

longPress(WebElement el)

//控件長按

longPress(int x, int y)

//點長按

longPress(WebElement el, int x, int y)

//偏移點長按

cancel()

//取消執行該動作

perform()

//執行該動作