新手学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()

//执行该动作