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()

#执行该动作

时间: 2024-10-21 16:41:21

appium api的相关文章

中文Appium API 文档

该文档是Testerhome官方翻译的源地址:https://github.com/appium/appium/tree/master/docs/cn官方网站上的:http://appium.io/slate/cn/master/?ruby#about-appium 中文Appium API 文档 第一章:关于appium1.1 appium客户端客户端类库列表及Appium服务端支持 这些类库封装了标准Selenium客户端类库,为用户提供所有常见的JSON 格式selenium命令以及额外的

appium API接口

appium API接口 标签(空格分隔): appium常用api 1.contexts contexts(self) 返回当前会话的上下文,使用可以识别H5页面的控件: driver.contexts 2.current_context 返回当前会话的当前上下文: 用法:driver.current_context 3.context 返回当前会话的当前上下文: 用法:driver.context find_element_by_ios_uiautomation(self,uia_strin

第三章 Appium API介绍

在学习应用一个框架之前,应该了解一下这个框架的整体结构或是相应的API函数,在网上搜了一下,也没有找到相应的文档,我平时写测试用例的时候都是一边写一边查看找相应的API函数.这篇文章还不错:http://www.51testing.com/html/15/n-1408815.html,就拷贝过来,扩展一下,希望对大家的学习有所帮助. 3.1常用的API函数 3.1.1 获取信息类API (1)获取默认系统语言对应的Strings.xml文件内的数据. get_app_string() (2)查找

java appium api

Appium中部分api的使用方法,有需要的朋友可以参考下. 使用的语言是java,appium的版本是1.3.4,java-client的版本是java-client-2.1.0,建议多参考java-client-2.1.0-javadoc. 1.使用AndroidDriver,其已经继承了AppiumDriver private AndroidDriver driver; @Before public void setUp() throws Exception { DesiredCapabi

APPIUM API整理(python)---元素查找

最近在学习自动化框架appium,网上找一些API相关资料整理了一下 1.find_element_by_id find_element_by_id(self, id_): Finds element within this element's children by ID(通过元素的ID定位元素) :Args: - id_ - ID of child element to locate. 用法 driver. find_element_by_id("id") find_element

APPIUM API整理(python)---操作类

APPIUM 常用API介绍(1) 前言:android手机大家都很熟悉,操作有按键.触摸.点击.滑动等,各种操作方法可以通过api的方法来实现.参考博文:http://blog.csdn.net/bear_w/article/details/50330565 1.click click(self):Clicks the element(点击元素 )用法 element.click() driver.find_element_by_id('com.huawei.camera:id/shutter

APPIUM API整理(python)---其他辅助类

App运行类 1.current_activity current_activity(self): Retrieves the current activity on the device. 获取当前的activity 用法 print(driver.current_activity()) 2. start_activity start_activity(self, app_package, app_activity, **opts): Opens an arbitrary activity d

Appium——api常用函数

appium常用函数介绍: 获取页面信息: 1. def get_current_activity(cls, driver): ''' 获取当前页面的activity :param driver: :return: ''' return driver.current_activity 2. def get_current_pagesource(cls, driver): ''' 获取当前页面源码 :param driver: :return: 返回数据类型为str ''' return driv

Appium API(常用)

锁定 锁定屏幕 # python driver.lock(5) 将 app 置于后台 把当前应用放到后台去 # python driver.background_app(5) 收起键盘 收起键盘 # python driver.hide_keyboard() 启动 Activity 在当前应用中打开一个 activity 或者启动一个新应用并打开一个 activity . 只能在 Android 上使用 # python driver.start_activity('com.example.an