appium 常用API

Appium自动化测试API详解

''.appium api第二弹 锋利的python,这是初稿,2015/1/5

如有错误的地方,请同学们进行留言,我会及时予以修改,尽量整合一份ok的api
作者:Mads Spiral QQ:79523822 如有疑问留言或者加qq,验证wyx
若要转载,请标注原著地址
'''
#默认系统语言对应的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()
#执行该动作

转载于:https://www.cnblogs.com/fenqing3108/p/5746955.html

Appium 是一个开源的自动化测试工具,广泛用于移动应用的自动化测试。它提供了丰富的 API 方法来支持不同场景下的测试需求。以下是一些 Appium常用API 方法及其用途。 ### 启动与关闭应用 1. **启动特定应用** 使用 `start_activity` 方法可以在测试过程中启动特定的 Android 应用。该方法需要传入应用的包名和启动名。 ```python driver.start_activity("com.example.app", ".MainActivity") ``` 这个方法特别适用于需要跨应用操作的场景,例如在测试过程中切换到另一个应用执行某些操作[^3]。 2. **关闭当前应用** 使用 `close_app` 方法可以关闭当前正在运行的应用。该方法仅影响当前的应用实例。 ```python driver.close_app() ``` 3. **关闭驱动对象** 使用 `quit` 方法可以关闭由 `driver` 对象启动的所有应用,并释放相关资源。 ```python driver.quit() ``` 与 `close_app` 不同,`quit` 会关闭所有由 `driver` 启动的应用,而不仅仅是当前应用[^1]。 ### 元素定位 1. **通过 ID 定位元素** `find_element_by_id` 方法用于查找具有特定 ID 的控件。这种方法适用于那些可以通过 ID 唯一标识的控件。通常,可以通过 Android SDK 的 `uiautomatorviewer` 工具来获取控件的 ID。 ```python element = driver.find_element_by_id("com.example.app:id/button1") ``` 2. **通过 XPath 定位元素** `find_element_by_xpath` 方法允许通过 XPath 表达式来定位元素。XPath 提供了更灵活的定位方式,尤其适用于没有唯一 ID 的控件。 ```python element = driver.find_element_by_xpath("//android.widget.Button[@text='Click Me']") ``` 3. **通过类名定位元素** `find_element_by_class_name` 方法用于查找具有特定类名的控件。这种方法适用于多个相同类型的控件中选择一个。 ```python element = driver.find_element_by_class_name("android.widget.Button") ``` 4. **通过名称定位元素** `find_element_by_name` 方法用于查找具有特定名称的控件。名称通常是控件的文本内容或资源 ID。 ```python element = driver.find_element_by_name("Submit") ``` ### 等待方法 1. **隐式等待** 隐式等待是指在查找元素时设置一个最长等待时间,如果在规定时间内找到元素,则立即继续执行;否则会抛出异常。 ```python driver.implicitly_wait(10) # 等待最多10秒 ``` 2. **显式等待** 显式等待是指等待某个条件成立后再继续执行。这种方式更为灵活,可以根据具体的业务逻辑进行等待。 ```python from selenium.webdriver.common.by import By from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC wait = WebDriverWait(driver, 10) element = wait.until(EC.element_to_be_clickable((By.ID, "com.example.app:id/button1"))) ``` 3. **强制等待** 使用 `time.sleep` 可以实现强制等待,即无论元素是否出现,都会按照指定的时间进行等待。虽然简单易用,但不推荐在实际测试中频繁使用,因为它会影响测试效率。 ```python import time time.sleep(5) # 等待5秒 ``` ### 其他常用方法 1. **滑动屏幕** 使用 `swipe` 方法可以模拟用户的滑动操作。该方法需要传入起始坐标、结束坐标以及滑动持续时间。 ```python driver.swipe(start_x=100, start_y=800, end_x=100, end_y=200, duration=1000) ``` 2. **点击屏幕** 使用 `tap` 方法可以模拟用户的点击操作。该方法需要传入一个包含坐标和点击次数的列表。 ```python driver.tap([(100, 800)], 100) ``` 3. **获取当前应用信息** 使用 `current_package` 和 `current_activity` 方法可以获取当前正在运行的应用的包名和启动名。 ```python current_package = driver.current_package current_activity = driver.current_activity ``` 4. **切换上下文** 使用 `context` 和 `contexts` 方法可以在不同的上下文之间进行切换,例如从原生应用切换到 WebView。 ```python current_context = driver.context all_contexts = driver.contexts driver.switch_to.context(all_contexts[1]) ``` 5. **处理通知栏** 使用 `open_notifications` 方法可以打开设备的通知栏,以便测试通知相关的功能。 ```python driver.open_notifications() ``` 6. **获取屏幕截图** 使用 `get_screenshot_as_file` 方法可以将当前屏幕截图保存为文件,便于后续分析。 ```python driver.get_screenshot_as_file("screenshot.png") ``` 这些 API 方法涵盖了 Appium 中常见的操作,包括启动和关闭应用、元素定位、等待方法以及其他实用功能。根据不同的测试需求,可以选择合适的方法来实现自动化测试
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值