appium api

AppiumDriver

getAppStrings()      默认系统语言对应的Strings.xml文件内的数据。iOS

driver.getAppStrings(Stringlanguage)      查找某一个语言环境对应的字符串文件Strings.xml内数据

sendKeyEvent(intkey)       按下某个键，具体哪个键由key值决定，key值定义在AndroidKeyCode类中

 sendKeyEvent(intkey, Integer metastate)  按下某个键的同时按下附加键（Ctrl/Alt/Shift等），具体是哪些键，由key值（AndroidKeyCode类中定义）和metastate（AndroidKeyMetastate类中定义）决定。

currentActivity()        获取当前activity,比如（.ApiDemos）

isAppInstalled(StringbundleId)   根据bundleId来判断该应用是否已经安装

 installApp(StringappPath)    安装app，appPath为应用的本地路径

removeApp(StringbundleId)   卸载app.bundleId在android中代表的是报名，而在ios中有专门的bundleId号。

closeApp() 关闭应用，其实就是按home键把应用置于后台

launchApp()  启动应用

resetApp()   先closeApp然后在launchAPP

 pushFile(StringremotePath, byte[] base64Data)   将字符数组用64位格式写到远程目录的某个文件中。也可以理解为把本地文件push到设备上。

 pullFile(StringremotePath)     将设备上的文件pull到本地硬盘上

 pullFolder(StringremotePath)    将设备上的文件夹pull到本地硬盘上，一般远程文件为/data/local/tmp下的文件。

setNetworkConnection(NetworkConnectionSettingconnection)   设置手机的网络连接状态，可以开关蓝牙、wifi、数据流量。通过NetworkConnectionSetting中的属性来设置各个网络连接的状态。

getNetworkConnection()   得到当前网络的状态

openNotifications()   打开通知栏

runAppInBackground(intseconds)    与resetApp类似，区别是resetApp关闭后立即启动，而这个方法是关闭后等待seconds秒后再启动。

hideKeyboard()   ios隐藏键盘

hideKeyboard(Stringstrategy, String keyName)   隐藏键盘，只能用于ios上。

performTouchAction(TouchActiontouchAction)   执行一个touch动作，该touch动作是由TouchAction封装的。

 performMultiTouchAction(MultiTouchActionmultiAction)  执行多步touch动作，由MultiTouchAction封装的多步操作。

 tap(intfingers, WebElement element, int duration)    点击element控件中心点按下，duration*5毫秒秒后松开，如此重复fingers次。

tap(intfingers, int x, int y, int duration)   点击(x,y)点按下，duration*5毫秒后松开，如此重复fingers次。

 swipe(intstartx, int starty, int endx, int endy, int duration)   从(startx,starty)滑到（endx,endy），分duration步滑，每一步用时是5毫秒。

 pinch(WebElementel)    2个手指操作控件，从对角线向中心点滑动。

 pinch(intx, int y)   以（x,y）为基准，计算得出（x,y-100）,(x,y+100)两个点，然后2个手指按住这两个点同时滑到（x,y）

 zoom(WebElementel) 与pinch(el)的动作刚好相反。两个手指由控件的中心点慢慢向控件的左顶点后右底点滑动。

 zoom(intx, int y) 和pinch(x,y)相反。两个手指从（x,y）点开始向（x,y-100）和（x,y+100）滑动。

 getNamedTextField(Stringname) 一般用在ios中。根据accessibility id获得控件对象。

 endTestCoverage(Stringintent, String path) 结束测试覆盖率的检测。（没用过，不太了解）path为.ec文件的路径。

 lockScreen(intseconds)   锁屏多少秒后解锁

 shake() 模拟摇晃手机（目前还没实现）

 scrollTo(Stringtext) 滚动到某个text属性为指定的字符串的控件

 scrollToExact(Stringtext)  滚动到某个text属性包含传入的字符串的控件

 context(String name）设置上下文

 getContextHandles()  可用上下文

 getContext()  当前上下文

 rotate(ScreenOrientationorientation)  设置屏幕横屏或者竖屏

 getOrientation() 获取当前屏幕的方向

 findElementByIosUIAutomation(Stringusing)    利用ios中的uiautomation中的属性来获取控件

 findElementsByIosUIAutomation(Stringusing) 和上面一样，不过获得的是多个控件

 findElementByAndroidUIAutomator(Stringusing) 利用android的uiautoamtor中的属性来获取单个控件。

 findElementsByAndroidUIAutomator(Stringusing) 和上面一样，但是该方法获得是多个控件

 findElementByAccessibilityId(Stringusing) 利用accessibility id来获取单个控件

 findElementsByAccessibilityId(Stringusing)利用accessibility id来获得多个控件

 TouchAction    AppiumDriver的辅助类，主要针对手势操作，比如滑动、长按、拖动等。TouchAction的原理是讲一系列的动作放在一个链条中，然后将该链条传递给服务器。服务器接受到该链条后，解析各个动作，逐个执行。

press(WebElementel)  在控件上执行press操作。

 press(intx, int y) 在坐标为（x,y）的点执行press操作

 press(WebElementel, int x, int y) 在控件el的左上角的x坐标偏移x单位，y左边偏移y单位的坐标上执行press操作。

 release() 释放操作，代表该系列动作的一个结束标志。

 moveTo(WebElementel) 以el为目标，从另一个点移动到该目标上

 moveTo(intx, int y)以（x,y）点为目标，从另一个点移动到该目标上

 moveTo(WebElementel, int x, int y)以控件el的左上角为基准，x轴向右移动x单位，y轴向下移动y单位。以该点为目标，从另一个点移动到该点上。

 tap(WebElementel) 在控件的中心点上敲击一下

 tap(intx, int y)在（x,y）点轻击一下

 tap(WebElementel, int x, int y) 以控件el的左上角为基准，x轴向右移动x单位，y轴向下移动y单位。在该点上轻击。

 waitAction() 代表一个空操作，等待一段时间

 waitAction(int ms) 等待ms秒

 longPress(WebElementel) 控件长按

 longPress(intx, int y)  点长按

 longPress(WebElementel, int x, int y)  偏移点长按

cancel() 取消执行该动作

perform()  执行该动作

 

 

 

 

 

#默认系统语言对应的Strings.xml文件内的数据。

get_app_string()

#查找某一个语言环境对应的字符串文件Strings.xml内数据

get_app_string(String language)

#按下某个键，具体哪个键由key值决定，key值定义在AndroidKeyCode类中

send_key_event(int key)

#获取当前activity,比如（.ApiDemos）

current_activity()

#根据bundleId来判断该应用是否已经安装

is_app_installed(String bundleId)

#安装app，appPath为应用的本地路径

install_app(String appPath)

#卸载app.bundleId在android中代表的是报名，而在ios中有专门的bundleId号。

remove_app(String bundleId)

#关闭应用，其实就是按home键把应用置于后台

close_app()

#启动应用

launch_app()

#先closeApp然后在launchAPP

reset_app()

#将字符数组用64位格式写到远程目录的某个文件中。也可以理解为把本地文件push到设备上。

push_file(String remotePath, byte[] base64Data)

#将设备上的文件pull到本地硬盘上

pull_file(String remotePath)

#将设备上的文件夹pull到本地硬盘上，一般远程文件为/data/local/tmp下的文件。

pull_folder(String remotePath)

#设置手机的网络连接状态，可以开关蓝牙、wifi、数据流量。通过NetworkConnectionSetting中的属性来设置各个网络连接的状态。

set_network_connect(NetworkConnectionSetting connection)

#得到当前网络的状态

get_network_connection()

#ios隐藏键盘

hide_keyboard()

#隐藏键盘，只能用于ios上。

hide_keyboard(String strategy, String keyName)

#执行一个touch动作，该touch动作是由TouchAction封装的。

perform_touchAction(TouchAction touchAction)

#点击element控件中心点按下，duration*5毫秒秒后松开，如此重复fingers次。

tap(int fingers, WebElement element, int duration)

#点击(x,y)点按下，duration*5毫秒后松开，如此重复fingers次。

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

#从(startx,starty)滑到（endx,endy），分duration步滑，每一步用时是5毫秒。

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

#2个手指操作控件，从对角线向中心点滑动。

pinch(WebElement el)

#以（x,y）为基准，计算得出（x,y-100）,(x,y+100)两个点，然后2个手指按住这两个点同时滑到（x,y）

pinch(int x, int y)

#与pinch(el)的动作刚好相反。两个手指由控件的中心点慢慢向控件的左顶点后右底点滑动。

zoom(WebElement el)

#和pinch(x,y)相反。两个手指从（x,y）点开始向（x,y-100）和（x,y+100）滑动。

zoom(int x, int y)

#锁屏多少秒后解锁

lock_screen(int seconds)

#模拟摇晃手机

shake()

#滚动到某个text属性为指定的字符串的控件

scroll_to(String text)

#滚动到某个text属性包含传入的字符串的控件

scroll_to_exact(String text)

#设置上下文

context(String name)

#可用上下文

get_context_handles()

#当前上下文

get_context()

#设置屏幕横屏或者竖屏

rotate(ScreenOrientation orientation)

#获取当前屏幕的方向

get_orientation()

#利用ios中的uiautomation中的属性来获取控件

find_element_by_ios_uiautomation(String using)

#和上面一样，不过获得的是多个控件

find_elements_by_ios_uiautomation(String using)

#利用android的uiautoamtor中的属性来获取单个控件。

find_element_by_android_uiautomator(String using)

#和上面一样，但是该方法获得是多个控件

find_elements_by_android_uiautomator(String using)

#利用accessibility id来获取单个控件

find_element_by_accessibilityid(String using)

#利用accessibility id来获得多个控件

find_elements_by_accessibilityid(String using)

'''AppiumDriver的辅助类，主要针对手势操作，比如滑动、长按、拖动等。

TouchAction的原理是讲一系列的动作放在一个链条中，然后将该链条传递给服务器。

服务器接受到该链条后，解析各个动作，逐个执行。'''

TouchAction()

#在控件上执行press操作

press(WebElement el)

#在坐标为（x,y）的点执行press操作

press(int x, int y)

#在控件el的左上角的x坐标偏移x单位，y左边偏移y单位的坐标上执行press操作。

press(WebElement el, int x, int y)

#释放操作，代表该系列动作的一个结束标志。

release()

#以el为目标，从另一个点移动到该目标上

move_to(WebElement el)

#以（x,y）点为目标，从另一个点移动到该目标上

move_to(WebElement el, int x, int y)

#在控件的中心点上敲击一下

tap(WebElement el)

#在（x,y）点轻击一下

tap(int x, int y)

#以控件el的左上角为基准，x轴向右移动x单位，y轴向下移动y单位。在该点上轻击。

tap(WebElement el, int x, int y)

#代表一个空操作，等待一段时间

wait_action()

#等待ms秒

wait_action(int ms)

#控件长按

long_press(WebElement el)

#点长按

long_press(int x, int y)

#偏移点长按

long_press(WebElement el, int x, int y)

#取消执行该动作

cancel()

#执行该动作